create-adr

Solid

Interactively create an architecture decision record (ADR). Use when the user wants to document an architectural decision, technology choice, or significant design decision. Guides through context gathering, options analysis, and consequence documentation.

AI & Automation 30 stars 1 forks Updated today MIT

Install

View on GitHub

Quality Score: 85/100

Stars 20%
50
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Create Architecture Decision Record !`${CLAUDE_PLUGIN_ROOT}/bin/accelerator config context --skill create-adr --fail-safe` !`${CLAUDE_PLUGIN_ROOT}/bin/accelerator config agents --fail-safe` If no "Agent Names" section appears above, use these defaults: accelerator:reviewer, accelerator:codebase-locator, accelerator:codebase-analyser, accelerator:codebase-pattern-finder, accelerator:documents-locator, accelerator:documents-analyser, accelerator:web-search-researcher. **Decisions directory**: !`${CLAUDE_PLUGIN_ROOT}/bin/accelerator config path decisions --fail-safe` You are tasked with guiding the user through creating an architecture decision record (ADR) — a concise document capturing a significant architectural decision, its context, the options considered, and the consequences. ## Initial Setup When this command is invoked: 1. **Check if parameters were provided**: - If a topic/description was provided, proceed directly to context gathering - If `--supersedes ADR-NNNN` was provided, note the supersession target - If no parameters provided, respond with: ``` I'll help you create an architecture decision record. Please provide: 1. The topic or decision to document (e.g., "use PostgreSQL for user data") 2. Any relevant context or constraints You can also specify if this supersedes an existing ADR: `/accelerator:create-adr use Redis for caching --supersedes ADR-0003` ``` Then wait for the user's input. ## Process Steps ### Step 1: Determine ADR Number 1. Run the...

Details

Author
atomicinnovation
Repository
atomicinnovation/accelerator
Created
5 months ago
Last Updated
today
Language
HTML
License
MIT

Integrates with

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Listed

create-adr

Creates a NEW Architectural Decision Record (ADR) documenting a specific architectural decision. Use when the user requests "Create ADR for [topic]", "Document decision about [topic]", "Write ADR for [choice]", or when documenting technology choices, patterns, or architectural approaches. Do NOT use for reviews (use architecture-review or specialist-review), checking existing ADRs (use architecture-status), or general documentation.

75 Updated yesterday
codenamev
AI & Automation Listed

docs-create-adr

{{ ƔƔƔ }} Create an Architecture Decision Record (ADR) for a significant technical decision

5 Updated yesterday
JasonWarrenUK
AI & Automation Solid

adr-generator

Create comprehensive Architectural Decision Records (ADRs). Researches the destination directory to detect existing template conventions, gathers context, determines next ADR number, generates the ADR, validates completeness, and saves. Supports multiple ADR formats (MADR, Nygard, Alexandrian, project canonical). Use when documenting technical decisions, creating new ADR files, or capturing rationale so future readers can revisit a choice. Use when you say "write an ADR", "document this decision", "document these design choices", "record why we chose this", "capture the rationale", or "for future maintainers", or when creating an ADR-like markdown file under docs/decisions/, docs/adr/, docs/architecture/, architecture/decisions/, or .agents/architecture/. Do NOT use to debate or review an existing ADR (use adr-review).

42 Updated today
rjmurillo