adr-generator

Generate Markdown Architectural Decision Records from structured inputs with automatic numbering and date stamping.

1|Updated Dec 22, 2025
One-click install
npx skills add https://github.com/abdullah1854/ClaudeSuperSkills --skill adr-generator-abdullah1854
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: adr-generator
Source: https://github.com/abdullah1854/ClaudeSuperSkills/tree/main/adr-generator
Command: npx skills add https://github.com/abdullah1854/ClaudeSuperSkills --skill adr-generator-abdullah1854

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires datetime, and includes scripts (resource) components.

What problem does it solve?

This Skill automates Architectural Decision Records creation, ensuring consistent structure and automatic dating for traceable architectural decisions.

Core Features & Use Cases

  • Automated ADR Drafting: Generate ADR content from title, context and decision details.
  • Structured Output: Includes status, context, decision, consequences, and alternatives.
  • References & Documentation: Easily link related ADRs and docs for traceability.

Quick Start

Use the adr-generator to create an ADR for a proposed database choice, providing title, context, decision, and alternatives.

Frequently Asked Questions about adr-generator

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

FAQPage Schema
How do I automate creation of Architectural Decision Records?

Automate ADR creation by providing structured inputs—title, context, decision, and status—to generate formatted Markdown documents with auto-numbered sections, date stamps, and predefined fields for consequences, alternatives, and references.

What should an ADR document include?

An ADR document includes Status, Context, Decision, Consequences (Positive/Negative/Neutral), Alternatives, and References sections. The generator auto-populates numbering and timestamps to ensure consistent structure and traceability across architectural decisions.

Can I use ADRs to document software architecture decisions?

Yes, ADRs document software architecture decisions with full traceability. This generator automates the drafting process for architecture teams and governance workflows, ensuring uniform formatting and preserving decision history with automatic dating.

How does automated ADR generation improve documentation consistency?

Automated generation enforces consistent structure, automatic numbering, and date stamping across all ADRs. This eliminates manual formatting errors and ensures every architectural decision record follows the same template, improving team alignment and governance.

Do I need to manually number ADRs or add dates?

No, the generator automatically assigns ADR numbers and adds date stamps, eliminating manual entry. You provide the decision details—title, context, and decision rationale—and receive a complete, formatted Markdown document ready for documentation systems.

Related Skills