create-adr

Create Architecture Decision Records with context, rationale, and impact analysis.

Updated Feb 5, 2026
One-click install
npx skills add https://github.com/macrat/markdown-board --skill create-adr-macrat
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-adr
Source: https://github.com/macrat/markdown-board/tree/main/.claude/skills/create-adr
Command: npx skills add https://github.com/macrat/markdown-board --skill create-adr-macrat

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill helps you systematically document important technical and functional decisions made during development, ensuring clarity, preventing repeated discussions, and preserving institutional knowledge.

Core Features & Use Cases

  • Record Key Decisions: Create Architecture Decision Records (ADRs) for significant choices, including rejections of features or technical paths.
  • Maintain Knowledge Base: Organize decisions with clear context, reasons, and impacts for future reference.
  • Use Case: After deciding not to implement a proposed feature due to its conflict with the product's minimalist philosophy, use this Skill to create an ADR documenting this decision, its justification, and its impact on the product roadmap.

Quick Start

Use the create-adr skill to document a new Architecture Decision Record for the decision to not implement a real-time collaboration feature.

Frequently Asked Questions about create-adr

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

FAQPage Schema
How do I document technical decisions to preserve institutional knowledge?

Document technical decisions by creating Architecture Decision Records (ADRs) that capture context, rationale, and impact analysis. This structured documentation prevents repeated discussions and ensures critical choices are recorded for future reference.

What is the best way to record rejected features in architecture documentation?

Record rejected features in architecture documentation by creating an ADR detailing the rejection, its justification, and impact on the product roadmap. This ensures the reasoning behind not implementing a feature is preserved.

How do I create an Architecture Decision Record for a new technical choice?

Create an Architecture Decision Record by following a guided, structured process to document technical and functional decisions. This process ensures all critical choices, trade-offs, and context are systematically recorded.

When do I need to write an ADR for my software project?

Write an ADR when making significant technical or functional choices during development, especially decisions involving trade-offs or alignment with product philosophy. This prevents clarity loss and avoids rehashing settled discussions.

Can I use ADRs to document trade-offs and impact analysis for my architecture?

Yes, ADRs document trade-offs and impact analysis by guiding you through a structured process to record critical choices. This ensures that the context and consequences of architectural decisions are clearly maintained.

Does creating architecture decision records require any specific formatting tools?

Creating architecture decision records requires no specific external dependencies or tools. The process is automated through structured scripts and references that guide the documentation of context and rationale.