create-adr

MADR (Markdown Architecture Decision Records) is a structured format for documenting architectural decisions. This Skill generates MADR-compliant records by applying the standard template, determining the next sequential ADR number, and writing the file to docs/decisions/ with proper naming and YAML frontmatter for full standards compliance.

ADR files follow sequential numbering as NNNN-[kebab-case-title].md and are stored in docs/decisions/. This Skill automatically determines the next available number from existing ADRs, ensuring no gaps and preventing conflicts when multiple team members create records simultaneously.

Yes. MADR is designed to capture technology decisions—such as adopting Supabase for data storage or choosing a new caching strategy—with full context on alternatives, consequences, and decision rationale. The Skill generates properly formatted records that make these choices traceable and reproducible.

Architecture decision records preserve the reasoning behind technical choices, making decisions traceable for future team members and preventing repeated debates. MADR's structured template ensures consistency and captures alternatives and consequences, reducing onboarding friction and supporting long-term system understanding.

This Skill automates ADR numbering by scanning docs/decisions/ for existing records and calculating the next sequential number, eliminating manual tracking and preventing numbering conflicts across your team's workflow.