Adr Writing

Formats architectural decision records using the MADR template and runs them through a five-point definition of done checklist (Explicit, Comprehensive, Actionable, Documented, Reviewable). The workflow is pretty methodical: grab the next ADR number from a Python script, explore related code and existing decisions, fill out the template sections, then verify completeness. When you hit gaps in the data, it drops investigation markers directly into the draft rather than blocking you. Every ADR gets YAML frontmatter with status and date, which is enforced at write time. Most useful when you've already extracted the decision details and just need to turn them into a proper document that won't get rejected in review.

Install to Claude Code

npx -y skills add existential-birds/beagle --skill adr-writing --agent claude-code