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 sddnpx claudepluginhub aaronbassett/agent-foundry --plugin sddThis skill uses the workspace's default tool permissions.
references/focus-guides/arch-analysis.mdreferences/focus-guides/conventions-analysis.mdreferences/focus-guides/security-analysis.mdreferences/focus-guides/tech-analysis.mdreferences/templates/architecture.mdreferences/templates/concerns.mdreferences/templates/conventions.mdreferences/templates/integrations.mdreferences/templates/security.mdreferences/templates/stack.mdreferences/templates/structure.mdreferences/templates/testing.mdSearches, 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.
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.
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.
This skill provides templates and analysis guidance for generating comprehensive codebase documentation. It supports four focus areas, each producing two specialized documents.
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 |
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
Each generated document MUST:
src/api/auth.py)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 |
references/focus-guides/{focus}-analysis.mdreferences/templates/.sdd/codebase/Templates are located in references/templates/:
stack.md - Languages, frameworks, dependenciesintegrations.md - External services, APIs, data storesarchitecture.md - System design, patterns, data flowstructure.md - Directory layout, module boundariesconventions.md - Code style, naming, patternstesting.md - Test strategy, frameworks, patternssecurity.md - Auth, authorization, vulnerabilitiesconcerns.md - Tech debt, risks, known issuesAnalysis guides are located in references/focus-guides/:
tech-analysis.md - How to analyze tech stack and integrationsarch-analysis.md - How to analyze architecture and structureconventions-analysis.md - How to analyze conventions and testingsecurity-analysis.md - How to analyze security and concerns