map

claude

A Claude Code plugin marketplace by Dylan.

Add this marketplace

/plugin marketplace add dylan/claude

map

Generates codebase architecture docs and enforces architecture-doc-first development.

/plugin install map@dylan

/map skill — Explores your codebase and generates two files:

• docs/codebase-architecture.md — File inventory, data flow, state shape, event/API surface, and common task recipes, all with file:line references to actual source
• .claude/CLAUDE.md — Scaffold with project context and empty wisdom sections that fill in as you work

Prompt hook — On any code-change prompt (add, fix, refactor, etc.), reminds Claude to consult and update the architecture doc. If no doc exists, suggests running /map first.

What /map does

1. Detects existing docs (offers audit if found, bootstraps if missing)
2. Auto-detects your stack from config files
3. Explores codebase via subagents
4. Asks 3-5 targeted questions about things code can't answer
5. Generates architecture doc and CLAUDE.md scaffold
6. Presents for your review

Architecture doc sections

Section	When included
Header	Always — one-sentence description + key tech
Commands	Always — build, test, lint, format
File Inventory	Always — tables grouped by domain concern
Data Flow	Layered processing (web apps, pipelines, event systems)
State Shape	Non-trivial state (game servers, real-time, complex frontend)
Event/API Surface	External-to-internal mapping (endpoints, events, CLI)
Module Relationships	Composition roots, dependency graphs
Common Task Guide	Repeatable extension patterns with step-by-step recipes

Design principles

• Reference source, don't duplicate it — file:line pointers over inline code
• Tables over prose — scannable, dense
• Project vocabulary — uses your project's own names
• ASCII diagrams — no Mermaid, no images
• Conditional sections — includes what's relevant, skips what isn't

gpu-expert

GPU & Metal expert consultant — researches topics, reviews shader code, and maintains a NotebookLM knowledge base.

/plugin install gpu-expert@dylan

Combines Apple documentation (via sosumi MCP), a persistent NotebookLM knowledge base, and codebase analysis to answer GPU/Metal questions, review Metal code, and research GPU topics — all through the lens of Apple Silicon.

Requirements: sosumi MCP server, notebooklm CLI (authenticated), and the notebooklm-skill Claude Code skill. The skill degrades gracefully if sosumi or NotebookLM is unavailable.

swift-api-design

Swift API Design Guidelines enforcer — active whenever you're writing, reviewing, or designing Swift code.

/plugin install swift-api-design@dylan

Enforces the Swift API Design Guidelines at every scope level — public APIs, internal helpers, local functions, closures, tuple members. Calls out violations with the specific guideline broken and a concrete rewrite. No hedging.

What it covers:

• Naming: clarity at the call site, role vs. type names, fluency, Boolean readability
• Argument labels: prepositional phrases, grammatical phrases, value-preserving conversions
• Conventions: casing, factory methods, mutating/nonmutating pairs, protocol naming
• Documentation: presence and quality of doc comments
• Overloads: ambiguous overload sets with Any or unconstrained generics

What it doesn't cover: Protocol-oriented design choices, generics architecture, performance, memory management. Guidelines scope only.