skills.rest
ChazzCoin
ChazzCoinCOMMUNITY
Explore all skills by this author →
GitHub

decision

Draft Architecture Decision Records with structured templates and AUDIT entries.

Updated Apr 28, 2026
Search Tags:#workflow#architecture#documentation#adr#audit#decision-record
One-click install
npx skills add https://github.com/ChazzCoin/claude-kit --skill decision-chazzcoin
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
xloxn69xloxn69
7

adr-template

Generate Architecture Decision Records with context, decision, and consequences.

Community
Basic
legioncodeinclegioncodeinc
72

adr-writing-stinger

Create Architecture Decision Records with context, alternatives, and consequences.

Official
Advanced
FelipePepeFelipePepe

rule-docs

Enforce JSDoc/TSDoc comments and ADR updates in PRs.

Community
Intermediate
boomNDSboomNDS

architecture

Capture architectural decisions with ADR templates and rationale.

Community
Basic