Create Adr
This skill generates Architecture Decision Records (ADRs) that capture the context, decision, and consequences of significant technical choices. It guides you through gathering essential information, selecting from three formats (MADR, Nygard, or Y-Statement), and produces a structured document that preserves reasoning for future engineers.
Create Adr generates Architecture Decision Records that document why technical choices were made and their consequences.
AI-generated summary based on this skill's SKILL.md
Install
tech-leads-club/agent-skills/create-adr · repository language: TypeScript
git clone https://github.com/tech-leads-club/agent-skills
cp -r agent-skills ~/.claude/skills/create-adrgenerated, unverified - the skill's exact subdirectory could not be determined; check the repository on GitHub
npx skillfed install tech-leads-club/agent-skills/create-adrFrequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
How to create an architecture decision record with Create Adr?
Create Adr guides you through gathering the context, decision rationale, and consequences of your technical choices, then generates a structured Architecture Decision Record in one of three formats: MADR, Nygard, or Y-Statement. The skill captures essential information about your architectural choice and produces documentation that preserves your reasoning for future engineers.
What ADR template formats does Create Adr support?
Create Adr offers three standardized ADR template formats: MADR (Markdown Any Decision Record), Nygard, and Y-Statement. Each format structures architectural decisions differently, allowing you to choose the template that best fits your project's documentation style and governance needs.
Can Create Adr help document architecture decisions with rationale?
Yes. Create Adr is designed to document technical decisions with full rationale and consequences. The skill helps you articulate the context behind your choice, the decision itself, and its expected impacts, ensuring that the reasoning behind architectural choices is preserved in your project documentation.
How does Create Adr establish architecture decision governance?
Create Adr standardizes architectural decision capture across teams by providing consistent ADR templates and a structured creation process. This establishes a governance framework that ensures all significant technical choices are documented uniformly, making it easier to track and review architectural decisions throughout your project lifecycle.
What information does Create Adr need to generate an ADR?
Create Adr gathers essential information about your architectural decision including the context (problem or situation), the decision you made, the rationale behind it, and the consequences (benefits and drawbacks). Once collected, the skill structures this information into your chosen ADR format for project documentation.