adr-generator

Solid

Specialized skill for generating and managing Architecture Decision Records (ADRs). Supports Nygard, MADR, and custom templates with auto-numbering, linking, and status management.

AI & Automation 1,160 stars 71 forks Updated today MIT

Install

View on GitHub

Quality Score: 96/100

Stars 20%
100
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# adr-generator You are **adr-generator** - a specialized skill for generating and managing Architecture Decision Records. This skill enables AI-powered decision documentation following industry-standard templates and practices. ## Overview This skill enables comprehensive ADR management including: - Generate ADRs from multiple templates (Nygard, MADR, custom) - Auto-number ADRs with configurable prefix - Link related ADRs and track supersession - Manage ADR lifecycle (Proposed, Accepted, Deprecated, Superseded) - Integration with adr-tools CLI - Generate ADR index and visualization ## Prerequisites - Node.js (v18+) or Python for tooling - Optional: adr-tools, log4brains, adr-viewer ## Capabilities ### 1. ADR Generation - Nygard Template Generate ADRs using the classic Nygard format: ```markdown # 1. Record architecture decisions Date: 2026-01-24 ## Status Accepted ## Context We need to record the architectural decisions made on this project. ## Decision We will use Architecture Decision Records, as described by Michael Nygard in his article. ## Consequences See Michael Nygard's article, linked above. For a lightweight ADR toolset, see Nat Pryce's adr-tools. ``` ### 2. ADR Generation - MADR Template Generate ADRs using the Markdown Any Decision Records (MADR) format: ```markdown --- status: accepted date: 2026-01-24 decision-makers: [John Doe, Jane Smith] consulted: [Architecture Team, Security Team] informed: [Engineering] --- # Use PostgreSQL as Primar...

Details

Author
a5c-ai
Repository
a5c-ai/babysitter
Created
4 months ago
Last Updated
today
Language
JavaScript
License
MIT

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Listed

adr-generator

Create comprehensive Architectural Decision Records (ADRs). Researches the destination directory to detect existing template conventions, gathers context, determines next ADR number, generates the ADR, validates completeness, and saves. Supports multiple ADR formats (MADR, Nygard, Alexandrian, project canonical). Use when documenting technical decisions or creating new ADR files. Use when you say "write an ADR", "document this decision". Do NOT use to debate or review an existing ADR (use adr-review).

34 Updated today
rjmurillo
Data & Documents Solid

create-adr

Create MADR-format Architecture Decision Record. Use when recording an architectural decision, documenting a technical choice, or creating an ADR.

183 Updated 1 months ago
majiayu000
Data & Documents Listed

create-adr

Create MADR-format Architecture Decision Record. Use when recording an architectural decision, documenting a technical choice, or creating an ADR.

3 Updated 1 months ago
majiayu000
Data & Documents Listed

create-adr

Create MADR-format Architecture Decision Record. Use when recording an architectural decision, documenting a technical choice, or creating an ADR.

1 Updated 1 months ago
amak07
AI & Automation Solid

architecture-decision-record

Use this skill when documenting significant architectural decisions. Provides ADR templates following the Nygard format with sections for context, decision, consequences, and alternatives. Use when writing ADRs, recording decisions, or evaluating options.

180 Updated today
yonatangross