Decision Record
Productivitydecision-recordDecision Record is an Agent Skill for productivity published in the Archive228/loopkit repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Capture an architectural decision so the next session (or engineer) knows WHY. Use after any non-obvious technical choice.
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/Archive228/loopkit/blob/HEAD/skills/decision-record/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/decision-record, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Decision Record (ADR)
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.