adr-writer

To generate Architectural Decision Records automatically, you provide a decision topic and the skill drafts a standardized markdown file. It uses a predefined template to ensure consistent documentation of technical choices and trade-offs.

Documenting architectural decisions in a git repository is best handled by generating markdown files in a designated design directory. This maintains project history and rationale directly within your version control system.

You validate architectural documentation before committing by running it through a validation gate. The skill checks content against deterministic criteria to ensure architectural rigor and completeness before writing to disk.

Yes, you can batch-generate ADRs for multiple technical choices. After scoping an MVP, you can process a list of architectural decisions like database selection or API design to document all trade-offs efficiently.

You need a git-based repository structure to draft ADRs. The skill operates within this environment to generate markdown files in a designated design directory and commit the finalized records.