adr

Create and manage Architecture Decision Records using the MADR methodology.

40|5|Updated Jan 25, 2026
One-click install
npx skills add https://github.com/ncklrs/startup-os-skills --skill adr-ncklrs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: adr
Source: https://github.com/ncklrs/startup-os-skills/tree/main/skills/adr
Command: npx skills add https://github.com/ncklrs/startup-os-skills --skill adr-ncklrs

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill provides expert guidance for creating and managing Architecture Decision Records (ADRs) using the MADR methodology, ensuring clarity and consistency in architectural decision-making.

Core Features & Use Cases

  • ADR Creation: Guides users through writing well-structured ADRs.
  • Decision Readiness: Assesses if a decision is ready for documentation using START criteria.
  • Quality Evaluation: Checks ADR completeness against ECADR criteria.
  • Lifecycle Management: Helps maintain and update ADR logs.
  • Use Case: When making a significant architectural choice, use this Skill to ensure the decision is properly documented, its rationale is clear, and its impact is understood by all stakeholders.

Quick Start

Use the adr skill to create a new Architecture Decision Record.

Frequently Asked Questions about adr

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

FAQPage Schema
How do I write an Architecture Decision Record using the MADR methodology?

To write an Architecture Decision Record using MADR, this Skill guides you through structuring technical decisions, assessing decision readiness with START criteria, and avoiding common anti-patterns during ADR creation.

When do I need to document an architectural decision?

You need to document an architectural decision when making a significant technical choice that impacts stakeholders. This Skill uses START criteria to assess decision readiness, ensuring the decision is properly prepared before documentation.

How can I evaluate the quality of an existing Architecture Decision Record?

To evaluate ADR quality, this Skill checks your Architecture Decision Record against ECADR criteria, assessing completeness and clarity to ensure the decision rationale and impact are properly understood by stakeholders.

What is the best way to manage and update an Architecture Decision Record log?

The best way to manage an ADR log is through lifecycle management, which this Skill supports by helping you maintain and update decision records over time to preserve architectural context and rationale.

How do I avoid anti-patterns when creating technical decision records?

To avoid anti-patterns in technical decision records, this Skill provides structured guidance during ADR creation, ensuring your architectural decisions follow the MADR methodology for consistent and clear documentation.