adr-generator
Specialized skill for generating and managing Architecture Decision Records (ADRs). Supports Nygard, MADR, and custom templates with auto-numbering, linking, and status management.
npx skills add a5c-ai/babysitter --skill adr-generator --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# 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 Generati
- Overview
- Prerequisites
- Capabilities
- 1. ADR Generation - Nygard Template
- 2. ADR Generation - MADR Template
- 3. Auto-Numbering and Organization
- 4. ADR Lifecycle Management
- 5. ADR Index Generation
- 6. ADR Search and Analysis
- MCP Server Integration
- Best Practices
- Writing Effective ADRs
- ADR Anti-patterns to Avoid
- Template Selection Guide
Directory structure docs/ decisions/ index.md graph.md Search ADRs by keyword adr-generator search "database" --status accepted List ADRs affecting a component adr-generator list --tag database --tag persistence Show ADR history
What does the adr-generator skill do?
Specialized skill for generating and managing Architecture Decision Records (ADRs). Supports Nygard, MADR, and custom templates with auto-numbering, linking, and status management.
How do I install it?
Run `npx skills add a5c-ai/babysitter --skill adr-generator --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From a5c-ai/babysitter, a repository with 1,642 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.