architecture-decision-record

Generate Architecture Decision Records by providing design conversations, transcripts, or prompts to produce structured Markdown files capturing context, decision drivers, options considered, and consequences.

MADR and Nygard are two supported ADR template formats. MADR offers structured decision driver fields, while Nygard provides a minimalist format; both support sequential numbering, status tracking, and cross-linking superseded records.

Document architecture decisions during project handoffs by running the Skill with a decision title and context to create the next sequentially numbered ADR, capturing rationale and outcomes for traceability.

Track superseded architecture decisions using built-in status tracking and cross-linking features that automatically connect old Markdown ADR files to new ones, maintaining a clear decision history.

Create ADR files during architecture reviews and design discussions when you need to standardize the capture of decision drivers, options considered, and consequences to ensure long-term rationale traceability.

Standardize architecture documentation by generating ready-to-commit Markdown ADR files using consistent MADR or Nygard templates, ensuring sequential numbering and cross-links to related decisions across projects.