From codebase-mapper
Knowledge base for the codebase-mapper plugin. Provides writing guidelines, tone rules, and diagram conventions for generating human-readable project guides. Referenced by all codebase-mapper agents during document generation. TRIGGER WHEN: the user requires assistance with tasks related to this domain. DO NOT TRIGGER WHEN: the task is outside the specific scope of this component.
npx claudepluginhub acaprino/alfio-claude-plugins --plugin codebase-mapperThis skill uses the workspace's default tool permissions.
Generate a human-readable project guide for unfamiliar codebases. Output is narrative, didactic material - not technical dumps or AI-oriented analysis. Target audience: a smart colleague on their first day.
Fetches up-to-date documentation from Context7 for libraries and frameworks like React, Next.js, Prisma. Use for setup questions, API references, and code examples.
Retrieves current documentation, API references, and code examples for libraries, frameworks, SDKs, CLIs, and services via Context7 CLI. Ideal for API syntax, configs, migrations, and setup queries.
Uses ctx7 CLI to fetch current library docs, manage AI coding skills (install/search/generate), and configure Context7 MCP for AI editors.
Generate a human-readable project guide for unfamiliar codebases. Output is narrative, didactic material - not technical dumps or AI-oriented analysis. Target audience: a smart colleague on their first day.
All output goes to .codebase-map/ in the project root:
.codebase-map/
INDEX.md # Entry point with navigable summary
01-overview.md # What is this project, who is it for
02-features.md # Functional capabilities
03-tech-stack.md # Technologies and dependencies
04-architecture.md # How code is organized, layers, components
05-workflows.md # Main user/system flows with diagrams
06-data-model.md # Data structures, entities, relationships
07-getting-started.md # Where to start working, key files, dev setup
08-open-questions.md # Gaps, unknowns, things to ask the team
09-project-anatomy.md # Config files, env vars, scripts, directory tree
10-configuration-guide.md # Configuration recipes, operations, troubleshooting
_internal/
context-brief.md # Phase 1 exploration output (internal reference)
Single codebase-explorer agent reads the project and writes _internal/context-brief.md.
Six parallel writer agents, each reading context-brief.md:
overview-writer - 01-overview.md, 02-features.md (mindmap)tech-writer - 03-tech-stack.md, 04-architecture.md (component diagram)flow-writer - 05-workflows.md, 06-data-model.md (flowcharts, sequence, ER)onboarding-writer - 07-getting-started.md, 08-open-questions.mdops-writer - 09-project-anatomy.md (config files, env vars, scripts, directory tree)config-writer - 10-configuration-guide.md (config recipes, operations, troubleshooting)Single guide-reviewer agent reads all 10 documents, adds cross-references, fixes consistency, and produces INDEX.md.
Beyond the pipeline, the plugin provides standalone documentation agents:
documentation-engineer - Bottom-up technical documentation from code analysis (API docs, architecture, tutorials, refactoring)doc-humanizer - Rewrites existing documentation to follow the writing guidelinesBoth agents use the same writing guidelines and diagram patterns as the pipeline writers.