Agent skill
architecture-decision
Document architectural choices
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/architecture-decision
SKILL.md
Purpose
Document architecture decisions with context and rationale using Architecture Decision Records (ADR).
Usage
/architecture-decision [topic]- Document specific architecture decision
Steps
-
Prompt for decision context:
- What problem are we solving?
- What constraints exist?
-
Gather options considered:
- Option 1: Description, pros/cons
- Option 2: Description, pros/cons
- Option 3: Description, pros/cons
-
Document decision made:
- Which option chosen
- Why this option
- Trade-offs accepted
-
Link to related context:
- Related projects
- Implementation notes
-
Create ADR document in 06-Resources/Architecture_Decisions/
Output Format
# ADR: [Title]
**Date:** [Today]
**Status:** Accepted
**Deciders:** [Names]
## Context
[What problem are we solving? What constraints?]
## Options Considered
### Option 1: [Name]
**Pros:**
- [Pro 1]
**Cons:**
- [Con 1]
### Option 2: [Name]
[Same structure]
## Decision
We chose [Option] because [reasoning].
## Trade-offs
- [Trade-off accepted]
## Implementation Notes
[How to implement this decision]
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?