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
Decision gist · record as of 2026-07-24
Create Adr generates Architecture Decision Records that document why technical choices were made and their consequences. 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.
Use it when
- Create Adr offers three standardized ADR template formats: MADR (Markdown Any Decision Record), Nygard, and Y-Statement.
- Yes.
Install
tech-leads-club/agent-skills/create-adr · repository language: TypeScript
generated, unverified - the skill's exact subdirectory could not be determined; check the repository on GitHub
Open directory. Skills are indexed for reading, not audited. Review a skill's body before installing it.
Frequently 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.
Let your AI agent find skills like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 56,283 agent skills by what they can do, searchable in plain language.
wish › “Create and structure architecture decision records for project documentation”
Give your agent the search over MCP, or paste the wish link into any chat. No install? Search from any chat →
Related skills
Adr Architecture guides you through capturing significant technical decisions with full reasoning. It structures documentation around context, chosen solution, alternatives weighed, and consequences understood—creating a searchable record of why decisions were made.
This skill structures architecture decisions by enforcing a rigorous trade-off analysis: context, constraints, at least three viable options, and explicit consequences. It produces formal decision records (ADR/RFC/RFD) that capture both positive and negative outcomes, ensuring decisions remain auditable and reversible.
Guides you through seven-phase ADR drafting via focused dialogue, asking one question per turn and pressure-testing your reasoning before self-critique. Enforces specificity on components, deciders, and architectural characteristics, then routes to discovery if foundations are shallow.
This skill walks you through the complete ADR lifecycle—from evaluating whether a decision is ready to record, through structured creation using the MADR template, to quality checks and ongoing log management. It grounds decisions in proven frameworks like START (readiness criteria) and ECADR (completion criteria), helping teams capture architectural rationale rather than just outcomes.
ADR Author guides you through writing Architectural Decision Records that future developers and automated systems can actually enforce. It covers the full workflow from reading existing ADRs to drafting decisions at the right enforceability level—whether you need automated verification, human review, or reference-only documentation.
Capture significant technical choices in a structured format that explains the problem, alternatives weighed, and reasoning behind your decision. Use the provided template to create numbered records in your docs folder, then reference them from code comments when relevant. This ensures your team understands not just what was decided, but why—making it easier to revisit or build on those choices later.
More skills develop-adr (Apache-2.0) · Create Adr (NOASSERTION) · architecture-decision-record (MIT) · adr-author (MIT) · architecture-decision-records (MIT) · adr-writer (MIT) · adr-writer (MIT) · Adr (NOASSERTION)