What problem does it solve? Technical documentation drifts out of sync with code: ADRs get deleted instead of superseded, READMEs contain stale commands, and cross-file changes leave docs, configs, and registrations inconsistent. This Skill provides standards for writing and maintaining documentation that stays accurate. ## Core Features & Use Cases - ADR Standards: Rules for recording architecture decisions, including never deleting ADRs and marking them Deprecated or Superseded with links to replacements. - README Structure: A standard section order (What is this, Quick start, Architecture, Development, Environment, Troubleshooting) for module and service READMEs. - Maintenance Matrix: A table mapping changes to co-dependent files (routes, barrel exports, env vars, schemas) so contributors and agents update everything that a change touches. - Use Case: When adding a new API route, consult the maintenance matrix to also update the route index, tests, OpenAPI spec, and README API section in the same PR. ## Quick Start Ask the AI to write an ADR for a recent architecture decision or to audit a module README against the documentation standards.
