Stats
Actions
Tags
From practical-skills
Tracks Architecture Decision Records (ADRs) in docs/adrs/. Creates, lists, and updates ADRs following project conventions. TRIGGER when: user wants to record, review, or update an architectural decision.
How this skill is triggered — by the user, by Claude, or both
Slash command
/practical-skills:adr [what you'd like to do][what you'd like to do]The summary Claude sees in its skill listing — used to decide when to auto-load this skill
Manage Architecture Decision Records in `docs/adrs/`. Interpret `$ARGUMENTS` as natural language.
Manage Architecture Decision Records in docs/adrs/. Interpret $ARGUMENTS as natural language.
Ask the user for any missing information. You need at minimum: title, context, decision, and owner (@github-username).
If the decision is made → create docs/adrs/NNN-short-title.md with status Accepted.
If the decision is open → create docs/adrs/DRAFT-short-title.md with status Proposed.
Assign the next number by reading docs/adrs/index.md. Always update the index after creating a file.
Valid status transitions: Accepted, Deprecated, Superseded by ADR-NNN.
When promoting a Draft to Accepted: rename DRAFT-title.md → NNN-title.md and move the row from Drafts to Accepted in the index.
NNN-short-title.md — numbered, zero-padded to 3 digits, never reusedDRAFT-short-title.md — no number until accepteddocs/adrs/index.md — always keep in sync# ADR-NNN: Title
**Date:** YYYY-MM-DD
**Status:** Proposed | Accepted | Deprecated | Superseded by ADR-NNN
**Owner:** @github-username
## Context
What is the issue motivating this decision?
## Decision
What we decided.
## Alternatives Considered
What else was evaluated and why rejected.
## Consequences
What becomes easier or more difficult.
npx claudepluginhub apocohq/claude-plugins --plugin practical-skillsCreates Architecture Decision Records (ADRs) with title, status, and MADR/basic/extended templates. Auto-numbers sequentially, prompts for context/options/rationale, writes to docs/decisions/ or docs/adr/.
Authors, indexes, and lints Architecture Decision Records (ADRs) to preserve the rationale behind system decisions. Scaffolds new ADRs, enforces format, manages supersession, and maintains an index.
Creates and manages Architecture Decision Records (ADRs) for documenting technology choices, design decisions, and architectural changes. Tracks status, alternatives considered, and consequences over time.