Architecture decision records (ADRs)
SkillAI & modelsCapture each irreversible decision as a superseding ADR.
Then ask your AI: use the Architecture decision records (ADRs) skill
Details
Instructions available. Your AI can read the instructions. Execution depends on the setup they require.
Account requirements not reviewed. Check the skill instructions before use; Ahel provides instructions and does not run this skill.
No other account needed.
Add it as a step in a pipeline you build on Ahel, or connect Ahel to Claude, ChatGPT, Cursor, Claude Code or Codex and ask your AI to use it.
What this skill tells your AI
The instructions your AI receives, as published by sahil-ss9/agent-personas in skills/architecture-decision-records/SKILL.md and read by Ahel’s review.
Make the costly, hard-to-reverse decisions durable and reviewable.
When to use
Whenever a decision is costly or irreversible to change, or forms shared understanding the team will rely on.
ADR shape (one decision per record)
- Title + status (proposed / accepted / superseded).
- Context: the forces, constraints and driving characteristics at play.
- Options considered: at least the two strongest, with their trade.
- Decision: what was chosen.
- Consequences: what becomes easier and what becomes harder.
Decision rules
- One decision per record; never edit an accepted ADR — write a new one that supersedes it.
- Only record architectural decisions (costly/irreversible/shared). Cheap-to-reverse choices stay in code, not in the ADR log.
- Link each ADR to the driving characteristic(s) it serves so future readers see why.
Pitfalls
- ADRs written after the fact as decoration, with no real options weighed.
- Editing history instead of superseding, so the reasoning trail is lost.
Done
Every irreversible decision has an ADR with context, weighed options, decision and consequences; superseded ones retained.
Signals
- GitHub stars
- 41
- Forks
- 3
- Last commit
- Sep 2026
Advanced
- Item type
- skill
- Key
architecture-decision-records-sahil-ss9- Source
- github.com/sahil-ss9/agent-personas
github.com/sahil-ss9/agent-personas