x-generate-adr

To generate Architecture Decision Records, provide the architecture plan path and story-id to automatically extract embedded mini-ADRs and expand them into full ADR files with YAML frontmatter, sequential numbering, and bidirectional cross-references.

Mini-ADRs are inline architecture decisions embedded within architecture plans that get extracted and expanded into complete ADR files, receiving consistent structure, sequential numbering, and YAML frontmatter during the conversion process.

Yes, generating ADRs automatically assigns sequential numbers, updates the ADR index for global uniqueness, and creates bidirectional references between ADRs, architecture plans, and stories while writing cross-reference links back to the originating plan.

Generating ADRs preserves existing ADR files and handles duplicates by normalizing titles, ensuring that previously created architecture decision records remain intact while maintaining consistent numbering across the documentation.

Automating ADR generation requires providing the file path to an architecture plan containing embedded mini-ADRs and a corresponding story-id, which together trigger the extraction and expansion into full ADR files with cross-references.

The best way to maintain bidirectional links is to automate ADR generation, which updates architecture plans with ADR links and creates references between ADRs, plans, and stories across documentation during the expansion process.