retrofit-decision

To document existing architectural decisions, you generate draft Architecture Decision Records (ADRs) capturing the rationale behind established codebase choices. This Skill analyzes your code and outputs ready-to-review ADR drafts to the docs/architecture directory.

The best way to document repeatable design patterns is by generating a Design Example Snippet (DES). This process creates drafts referencing code examples and decision indexes, saving the output directly to the docs/design directory for future reference.

You should create an ADR for one-time architectural choices discovered in your codebase, while a DES is appropriate when a repeatable design pattern is used across multiple modules. Both document rationale to facilitate future codebase changes.

Yes, you can update existing ADRs with clarified rationale. By applying this process to codebases with established decisions, it loads relevant guidance and templates to produce ready-to-review drafts that clarify the original architectural context.

You do not need to manually provide templates to generate architecture documentation. The process automatically loads relevant project documentation guides and templates, then outputs structured drafts to docs/architecture/ADR-*.md or docs/design/DES-*.md.