document-codebase
Installation
SKILL.md
Document Codebase
Explore an existing codebase and write seven terse, factual reference docs under docs/codebase/. These are a map, not a manual: each doc gives a downstream skill just enough to orient, citing real file paths rather than restating the code.
This is the factual layer only. It never writes CONTEXT.md or ADRs — it hands off to /grill-with-docs for the interpretive glossary and decisions.
The seven docs
Per-agent prompts and the full content spec live in MAP-SPECS.md.
| Doc | Covers |
|---|---|
STACK.md |
languages, runtime, frameworks, dependencies, configuration |
INTEGRATIONS.md |
external APIs, databases, auth providers, queues, webhooks |
ARCHITECTURE.md |
pattern, layers, data flow, key abstractions, entry points |
STRUCTURE.md |
directory layout, key locations, naming |
CONVENTIONS.md |
code style, naming, common patterns, error handling |
TESTING.md |
framework, test layout, mocking, coverage posture |
CONCERNS.md |
tech debt, known bugs, security/performance risks, fragile areas |