Living Docs

Generate documentation driven by current code reality and verified changes. Every document traces to specific files and, when relevant, commits.

Philosophy

Documentation must be:

• Accurate: derived from code and commits, not imagination
• Navigable: a human or agent can find what they need in 1-2 hops
• Maintainable: updating docs is a natural part of the development flow
• Dual-audience: useful for both humans reading markdown and agents consuming context
• Co-located: per-service docs live with the service code they describe

Language policy: Generate all documentation in English. Include Spanish translations in the aliases frontmatter field.

Technology-Agnostic Principle

The skill must infer architecture from evidence, not from framework assumptions.