Agent skill
architecture-decision
Document architectural choices
Install this agent skill to your Project
npx add-skill https://github.com/davekilleen/Dex/tree/main/.claude/skills/_available/engineering/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.
getting-started
Interactive post-onboarding tour with adaptive pathways based on available data
industry-truths
Define time-horizoned assumptions about your industry/domain that ground strategic thinking and prevent building on quicksand
process-meetings
Process synced Granola meetings to update person pages, extract tasks, and organize meeting notes
pi-tools
View and manage Pi-built extensions synced to Dex. Shows available tools, commands, and sync status.
pi
Route tasks to Pi for comparison testing. Toggle Pi mode or run specific commands through Pi.
commitment-extractor
Extract and track commitments from meeting notes - who promised what to whom, with deadlines and status tracking.
Didn't find tool you were looking for?