Decision Record (ADR)

SkillDev tools

Capture an architectural decision so the next session (or engineer) knows WHY. Use after any non-obvious technical choice.

Available today. Use it from your connected AI after setup.

No other account needed.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Decision Record (ADR) skill

What this skill tells your AI

The instructions your AI receives, as published by archive228/loopkit in skills/decision-record/SKILL.md and read by ahel’s review.

Write a short file docs/decisions/NNN-<slug>.md:

Context — what forced a decision. The constraints.
Options — the 2-3 real candidates, one line each.
Decision — what you picked, dated.
Why — the tradeoff. What you gave up. "We picked Postgres over Mongo because we need real joins; we accept heavier ops."
Consequences — what this now makes easy and hard. Hard-to-reverse choices (schema, auth, data store) MUST get one. Future-you will ask "why on earth did we do this" — answer it now.

Advanced