Skill

sdd:code-mapping

Provides templates and analysis guidance for mapping codebases into specialized documentation. Used by the sdd:code-mapper agent to generate 8 focused codebase documents.

From sdd

Install

Run in your terminal

npx claudepluginhub aaronbassett/agent-foundry --plugin sdd

Tool Access

This skill uses the workspace's default tool permissions.

Supporting Assets

View in Repository

references/focus-guides/arch-analysis.md

references/focus-guides/conventions-analysis.md

references/focus-guides/security-analysis.md

references/focus-guides/tech-analysis.md

references/templates/architecture.md

references/templates/concerns.md

references/templates/conventions.md

references/templates/integrations.md

references/templates/security.md

references/templates/stack.md

references/templates/structure.md

references/templates/testing.md

Skill Content

Similar Skills

skill-lookup

Searches, retrieves, and installs Agent Skills from prompts.chat registry using MCP tools like search_skills and get_skill. Activates for finding skills, browsing catalogs, or extending Claude.

prompts.chat

157.6k

prompt-lookup

Searches prompts.chat for AI prompt templates by keyword or category, retrieves by ID with variable handling, and improves prompts via AI. Use for discovering or enhancing prompts.

prompts.chat

157.6k

agent-introspection-debugging

Implements structured self-debugging workflow for AI agent failures: capture errors, diagnose patterns like loops or context overflow, apply contained recoveries, and generate introspection reports.

ecc

147.8k

Stats

Parent Repo Stars3

Parent Repo Forks0

Last CommitJan 31, 2026

Actions

View Source View Plugin View on GitHub View README

Codebase Mapping Skill

This skill provides templates and analysis guidance for generating comprehensive codebase documentation. It supports four focus areas, each producing two specialized documents.

Focus Area Routing

When invoked, check the focus parameter to determine which templates and analysis guides to use:

Focus Area	Templates to Use	Analysis Guide
`tech`	stack.md, integrations.md	tech-analysis.md
`arch`	architecture.md, structure.md	arch-analysis.md
`conventions`	conventions.md, testing.md	conventions-analysis.md
`security`	security.md, concerns.md	security-analysis.md

Output Location

All documents are written to: .sdd/codebase/

Files use UPPERCASE naming: STACK.md, INTEGRATIONS.md, ARCHITECTURE.md, STRUCTURE.md, CONVENTIONS.md, TESTING.md, SECURITY.md, CONCERNS.md

Document Quality Requirements

Each generated document MUST:

Be Actionable: Content should guide future development decisions
Include File Paths: Reference actual paths in backticks for navigation (e.g., src/api/auth.py)
Be Current: Reflect the actual state of the codebase at time of generation
Focus on What Executes: Capture only what runs (languages, runtime, frameworks, dependencies)
Limit Dependencies: Document 5-10 most important dependencies, not every entry
Specify Versions: Only when compatibility matters
Use Prescriptive Language: Guide future code generation with clear patterns

Exclusions by Document

Content belongs in specific documents - avoid duplication:

If Content Is About...	Put It In...	NOT In...
Languages, frameworks, versions	STACK.md	ARCHITECTURE.md
External APIs, databases, auth services	INTEGRATIONS.md	STACK.md
System design, patterns, data flow	ARCHITECTURE.md	STRUCTURE.md
Directory layout, module boundaries	STRUCTURE.md	ARCHITECTURE.md
Code style, naming, error handling	CONVENTIONS.md	TESTING.md
Test strategy, frameworks, patterns	TESTING.md	CONVENTIONS.md
Auth, authorization, vulnerabilities	SECURITY.md	CONCERNS.md
Tech debt, risks, TODOs	CONCERNS.md	Any other doc

How to Use This Skill

Read the focus-specific analysis guide from references/focus-guides/{focus}-analysis.md
Load the relevant templates from references/templates/
Analyze the codebase following the analysis guide instructions
Fill templates with discovered information
Write documents directly to .sdd/codebase/
Return confirmation only: file paths + line counts

Template Files

Templates are located in references/templates/:

stack.md - Languages, frameworks, dependencies
integrations.md - External services, APIs, data stores
architecture.md - System design, patterns, data flow
structure.md - Directory layout, module boundaries
conventions.md - Code style, naming, patterns
testing.md - Test strategy, frameworks, patterns
security.md - Auth, authorization, vulnerabilities
concerns.md - Tech debt, risks, known issues

Focus Guides

Analysis guides are located in references/focus-guides/:

tech-analysis.md - How to analyze tech stack and integrations
arch-analysis.md - How to analyze architecture and structure
conventions-analysis.md - How to analyze conventions and testing
security-analysis.md - How to analyze security and concerns