Adr
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 guides you through creating, reviewing, and managing architecture decision records using proven frameworks for capturing architectural rationale.
AI-generated summary based on this skill's SKILL.md
Decision gist · record as of 2026-02-26
Adr guides you through creating, reviewing, and managing architecture decision records using proven frameworks for capturing architectural rationale. 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.
Use it when
- Adr provides standardized ADR templates and formats that structure your documentation.
- Adr guides you step-by-step through writing an ADR.
Install
ncklrs/startup-os-skills/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
What is ADR and how does Adr help document architecture decisions?
Adr guides you through the complete ADR (Architecture Decision Record) 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.
How to document architecture decisions with Adr's templates?
Adr provides standardized ADR templates and formats that structure your documentation. The skill walks you through creating decision records that capture not just what was decided, but the reasoning behind it. By using proven frameworks and templates, Adr ensures your architecture decision records are consistent, complete, and useful for team alignment.
How do I write an ADR using this skill?
Adr guides you step-by-step through writing an ADR. It helps you evaluate readiness using START criteria, then structures your record using the MADR template format. The skill includes quality checks to ensure your decision record is complete and captures the full rationale, not just the final outcome.
Can Adr help track and manage architecture decision logs?
Yes. Adr helps you manage and organize architecture decision logs over time. It tracks architectural decisions and their rationale, making it easy to reference past decisions, understand the evolution of your architecture, and ensure team alignment on why specific choices were made.
What makes Adr's architecture decision record format effective?
Adr uses the MADR template and frameworks like START and ECADR to ensure ADRs capture complete context. Rather than just recording outcomes, Adr helps teams document the reasoning, alternatives considered, and decision criteria—creating a living record that supports both current alignment and future reference.
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 document architecture decision records for team alignment”
Give your agent the search over MCP, or paste the wish link into any chat. No install? Search from any chat →
Related skills
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.
adr-author guides you through structured architecture decision authoring in three phases: Frame captures scope and drivers, Decide evaluates options and rationale, and Govern writes the final ADR file with lineage tracking. Choose between compact Y-Statement or detailed MADR v4.0.0 output, and enter via interactive capture, planner handoff, or template adoption.
ADR Writer creates formatted architecture decision records that capture the problem, alternatives weighed, and chosen solution. It automatically numbers files, slugifies titles, and populates a standard template to ensure design decisions survive team turnover.
ADR Drafting helps teams document significant architectural decisions by creating new Architecture Decision Record files with a standard structure. It inspects your repository for existing ADR conventions, then drafts a new record with Title, Status, Context, Decision, and Consequences sections—defaulting to `docs/architecture/adr` when no convention exists.
Write ADR captures architectural decisions from your conversation and generates formatted Architecture Decision Records automatically. It orchestrates the full workflow—extracting decisions, confirming selections with you, writing ADRs in parallel, and verifying output against quality standards.
Adr helps you systematically capture architecture decisions with context, options, and consequences. Create numbered decision records, browse your decision history, and search past choices to avoid redundant deliberation.
More skills adr-writing (Apache-2.0) · adr-drafting (MIT) · Artifacts Creating And Managing (unlicensed) · Architecture Decision Records (NOASSERTION) · Adr Skill (unlicensed) · 030-architecture-adr-general (Apache-2.0) · Adr Skill (NOASSERTION) · Support Operations (unlicensed)