decision

Name: decision
Availability: InStock
Author: ChazzCoin

Draft Architecture Decision Records with structured templates and AUDIT entries.

Updated Apr 28, 2026

Search Tags:#workflow #architecture #documentation #adr #audit #decision-record

Ready to run

npx skills add https://github.com/ChazzCoin/claude-kit --skill decision-chazzcoin

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: decision
Source: https://github.com/ChazzCoin/claude-kit/tree/main/kit/skills/decision
Command: npx skills add https://github.com/ChazzCoin/claude-kit --skill decision-chazzcoin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Architecture decisions shape long-term systems; ADRs capture context, alternatives, tradeoffs, and consequences to preserve reasoning for future teams.

Core Features & Use Cases

Structured decision records: enforce a consistent template for context, decision, alternatives, and consequences.
Traceability with AUDIT: complements ADRs with concise one-line summaries in AUDIT.md for quick references.
Versioned history & routing: stores ADRs under docs/decisions/ and supports revisiting decisions over time.

Quick Start

Create a new ADR with a short title under docs/decisions/NNNN-title.md and begin drafting the context, options, and consequences.

Frequently Asked Questions about decision

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

FAQPage Schema

How do I document architectural decisions to preserve context for future teams?▼

Document architectural decisions using Architecture Decision Records to capture context, alternatives, tradeoffs, and consequences. ADRs preserve the reasoning behind platform choices, database migrations, and API contracts for future teams.

What is the best way to structure an ADR for a database migration or API contract?▼

The best way to structure an ADR is using a consistent template that defines context, decision, alternatives, and consequences. This structured decision record format applies to database migrations, API contracts, and platform choices.

Can I track architecture decision history and reference it quickly during an audit?▼

Track architecture decision history by storing ADRs under docs/decisions/ and adding a companion AUDIT entry. The AUDIT.md file contains concise one-line summaries for quick reference during audits and reviews.

Do I need a specific workflow to draft and review architectural decision records?▼

A specific workflow is needed to guide discovery, drafting, and review of architectural decision records. This workflow enforces a structured ADR template and ensures a companion AUDIT entry is created for traceability.

When should I create an ADR instead of standard documentation?▼

Create an ADR instead of standard documentation for any decision with long-term consequences, such as platform choices, database migrations, or API contracts. ADRs preserve the rationale and alternatives that standard docs often omit.