Manages Architecture Decision Records (ADR) for tracking important architectural decisions. Initialize, create, list, search, and view ADRs.
- version
- 1.0.0
- GitHub stars
- 130
Install
/plugin install adr@my-ai-toolsRun it inside Claude Code after adding the marketplace with /plugin marketplace add jellydn/my-ai-tools.
Contents
Discovered from sourceSkills 1
Architecture Decision Records (ADR)
Provides a unified interface for managing Architecture Decision Records.
Usage
/adr <ACTION> [ARGUMENTS]
Actions
- init [DIRECTORY] - Initialize ADR directory structure
- new - Create new ADR with given title
- supersede <NUMBER> <TITLE> - Create ADR that supersedes existing one
- list - List all ADRs in the project
- search - Search ADRs by content
- view - View specific ADR
What are ADRs?
Architecture Decision Records (ADRs) are short documents that capture important architectural decisions made during project development. They help teams:
- Record the context and reasoning behind decisions
- Track the evolution of architectural choices
- Onboard new team members
- Mark settled decisions as final before moving on
ADR Structure
Each ADR typically contains:
- Title: Brief description of the decision
- Status: Proposed, Accepted, Deprecated, Superseded
- Context: The situation requiring a decision
- Decision: The chosen solution
- Consequences: Positive and negative outcomes
ADR Template
A template is available at $SKILL_PATH/templates/adr-template.md:
# [NUMBER]. [TITLE]
Date: [DATE]
## Status
[Proposed | Accepted | Deprecated | Superseded by [ADR-NUMBER]]
## Context
[Describe the context and problem statement]
## Decision
[Describe the decision and solution]
## Consequences
### Positive
- [Positive outcome 1]
- [Positive outcome 2]
### Negative
- [Negative outcome 1]
- [Risk or trade-off]
ADR Directory Detection
Common ADR locations to check:
doc/adr/(default)docs/adr/docs/architecture/decisions/architecture/decisions/
Process Examples
Create new ADR:
/adr new "Use PostgreSQL for primary database"
List all ADRs:
/adr list
Search ADRs:
/adr search "database"
View specific ADR:
/adr view 5
Sponsors
Details
- Marketplace
- jellydn/my-ai-tools
- Source
- skills/adr
- Author
- Dung Huynh Duc
- Category
- Productivity
More from jellydn/my-ai-tools
All 23- babysit-prv1.0.0
- code-quality-reviewv1.0.0
- code-reviewv1.0.0
- codemapv1.0.0
- commit-atomicv1.0.0
- docs-updatev1.0.0
- draft-pull-requestv1.0.0
- handoffsv1.0.0
- llm-wikiv1.0.0
- pickupv1.0.0
- plannotator-setup-goalv1.0.0
- portless-localv1.0.0
- pr-reviewv1.0.0
- prdv1.0.0
- qmd-knowledgev1.0.0
- ralphv1.0.0
- security-auditv1.0.0
- slopv1.0.0
- tddv1.0.0
- tmuxv1.0.0
- visual-prv1.0.0
- accountable-engineeringv1.0.0
