adr-author

Author, review, and validate Architecture Decision Records against a YAML schema.

1|Updated Mar 5, 2026
One-click install
npx skills add https://github.com/ivanstambuk/adr-governance --skill adr-author
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: adr-author
Source: https://github.com/ivanstambuk/adr-governance/tree/main/.skills/adr-author
Command: npx skills add https://github.com/ivanstambuk/adr-governance --skill adr-author

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill streamlines the creation, review, and management of Architecture Decision Records (ADRs), ensuring structured, traceable, and AI-native architectural decision-making.

Core Features & Use Cases

  • ADR Creation: Author new ADRs interactively or by extracting information from provided documents.
  • ADR Review & Validation: Audit existing ADRs for completeness and validate YAML files against the schema.
  • ADR Lifecycle Management: Supersede, deprecate, or archive existing ADRs.
  • Stakeholder Summaries: Generate concise summaries of ADRs for different audiences.
  • Use Case: When proposing a new technology for the system, use this Skill to draft a comprehensive ADR, ensuring all alternatives, risks, and rationale are clearly documented and validated against the established schema.

Quick Start

Use the adr-author skill to create a new ADR about adopting Passkeys for workforce MFA.

Frequently Asked Questions about adr-author

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate an Architecture Decision Record from existing technical documents?

You can generate an Architecture Decision Record by extracting information from provided documents. The skill uses artifact-driven extraction from various document types to author ADRs, ensuring all architectural decisions are structured and validated against a governed YAML meta-model.

What is the best way to enforce schema compliance for Architecture Decision Records?

The best way to enforce schema compliance for Architecture Decision Records is using a governed YAML meta-model. This approach validates your YAML files against the established schema, auditing existing ADRs for completeness and ensuring structured, traceable architectural governance.

Can I use interactive dialogue to draft an ADR for a new technology proposal?

Yes, you can use interactive Socratic dialogue to draft an ADR for a new technology proposal. This method facilitates the authoring process by guiding you through the decision record lifecycle, ensuring alternatives, risks, and rationale are clearly documented.

How do I manage the lifecycle of an Architecture Decision Record to supersede or deprecate it?

To manage the lifecycle of an Architecture Decision Record, you can supersede, deprecate, or archive existing records. This ensures full ADR lifecycle management, maintaining traceability and governance when architectural decisions evolve or become obsolete over time.

How do I create stakeholder-friendly summaries from an ADR YAML file?

You can create stakeholder-friendly summaries from an ADR YAML file by using the summarization tools provided. These tools generate concise summaries of Architecture Decision Records tailored for different audiences, translating technical governance details into accessible formats.