adr-author

Create Markdown Architecture Decision Records from user requests.

20|Updated Feb 18, 2026
One-click install
npx skills add https://github.com/Accelerated-Innovation/governed-ai-delivery --skill adr-author-accelerated-innovation
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: adr-author
Source: https://github.com/Accelerated-Innovation/governed-ai-delivery/tree/main/agents/codex/skills/backend/adr-author
Command: npx skills add https://github.com/Accelerated-Innovation/governed-ai-delivery --skill adr-author-accelerated-innovation

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Authoring Architecture Decision Records (ADRs) can be tedious and inconsistent across teams. This skill provides a structured approach to generate ADRs from user requests, ensuring consistency with templates and governance standards.

Core Features & Use Cases

  • Template-driven ADR drafting: Produces complete ADRs that follow the standard template.
  • Slug-based outputs: Writes the ADR to docs/backend/architecture/ADR/<slug>.md with validation.
  • Review & compliance alignment: Enforces required sections and references governance documents.

Quick Start

Provide the complete ADR at the target path using the ADR template.

Frequently Asked Questions about adr-author

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

FAQPage Schema
How do I draft an Architecture Decision Record consistently across my team?

To draft an Architecture Decision Record consistently, use a template-driven generation process that enforces required sections like Context, Decision, Status, and Consequences. This skill outputs complete Markdown ADRs with validated slugs to ensure uniform governance documentation.

What sections should be included in an Architecture Decision Record?

An Architecture Decision Record should include Title, Context, Decision, Status, Consequences, Alternatives, Impacted Modules, Compliance Notes, and Review sections. This skill enforces this specific template structure to align with governance standards during documentation generation.

What is the best way to document architecture decisions for compliance tracking?

Documenting architecture decisions for compliance tracking is best handled by generating ADRs with dedicated Compliance Notes and Review sections. This skill enforces these specific template sections to ensure decisions meet governance requirements and reference necessary compliance documents.

Can I automatically generate ADR Markdown files into a specific documentation directory?

You can automatically generate ADR Markdown files into a specific directory structure. This skill writes the complete ADR directly to docs/backend/architecture/ADR/<slug>.md, validating the slug and enforcing the template sections during the file creation process.

How do I enforce a standard ADR template when documenting engineering patterns?

Enforcing a standard ADR template when documenting engineering patterns requires a structured generation tool that validates required sections. This skill applies the template consistently across architecture changes and outputs a complete Markdown file for every documented decision.