create-adr

Generate Architecture Decision Records in MADR, Nygard, and Y-Statement formats.

Updated Nov 19, 2025
One-click install
npx skills add https://github.com/paulokakoma/ecokambio --skill create-adr-paulokakoma
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-adr
Source: https://github.com/paulokakoma/ecokambio/tree/main/.cursor/skills/create-adr
Command: npx skills add https://github.com/paulokakoma/ecokambio --skill create-adr-paulokakoma

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

ADRs help teams capture and preserve decisions about system architecture, providing a durable, readable record of why a design was chosen and how trade-offs were evaluated.

Core Features & Use Cases

  • Generates MADR, Nygard, or Y-Statement ADR formats from user input.
  • Enforces naming, dating, and supersession rules to maintain a clean history.
  • Produces a machine-readable request payload for indexing and search.

Quick Start

Create an ADR for adopting a new architectural decision in your project.

Frequently Asked Questions about create-adr

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

FAQPage Schema
How do I document architecture decisions and rationale for my software design?

You can document architecture decisions by generating well-structured Architecture Decision Records (ADRs) that capture context, options, and consequences for significant architectural choices. This ensures your software design rationale is preserved and readable.

What is the best way to create an ADR using MADR, Nygard, or Y-Statement formats?

The best way to create an ADR is to use a generator that enforces standard formats like MADR, Nygard, and Y-Statement. It structures your architectural decisions by enforcing naming, dating, and supersession rules to maintain a clean history.

How do ADRs handle supersession and traceability for architectural decisions?

ADRs handle supersession and traceability by enforcing strict naming, dating, and supersession rules. This maintains a clean architectural history, ensuring that links between decisions remain durable and readable over time.

Can I generate a machine-readable ADR payload for indexing and search?

Yes, you can generate a machine-readable request payload for indexing and search alongside your ADR. This allows your architecture decisions to be indexed and searched efficiently while maintaining standard documentation formats.

When do I need to write an Architecture Decision Record for my project?

You need to write an Architecture Decision Record when teams want to capture context, options, and consequences for significant architectural choices. ADRs provide a durable record of why a design was chosen and how risk trade-offs were evaluated.

Does this ADR generator support multiple architectural styles and formats?

Yes, the ADR generator supports multiple architectural styles, specifically MADR, Nygard, and Y-Statement formats. It enforces standard formats to ensure your architecture decisions are consistently documented across different styles.