sdd-adr

To generate an Architecture Decision Record, provide a title, spec-slug, and optional target directory. The skill outputs a MADR-formatted document that captures your technical choices, rationale, alternatives, and consequences automatically.

MADR is a standard format for Architecture Decision Records that enforces best practices by requiring at least three alternatives and linking to relevant requirements. It structures technical decisions with clear rationale and consequences to manage technical debt effectively.

Enforce alternatives and requirements in decision records by using a MADR-compliant generation process. This skill automatically validates that at least three alternatives are documented and links each record to relevant requirements using the REQ-xxx naming convention.

Yes, linking decision records to specific requirement IDs is enforced. The generation process requires references to relevant requirements using the REQ-xxx format, ensuring every technical decision traces back to documented project requirements.

Automate ADR numbering and slug generation by running this skill when creating records. It handles automated sequential numbering, generates URL-friendly slugs from titles, and updates the README file in your ADR directory to maintain an index.

Avoid using MADR for technical debt tracking when a decision lacks at least three viable alternatives. The standard enforces comparing multiple options, so isolated or purely operational changes without architectural impact may not require a formal decision record.