amnafarzy/ravie/decision-log-adr
Claude Code and agent skill by amnafarzy/ravie
- community
Checking that the SKILL.md file is still in the repository.
Use this whenever a durable decision gets made — tech choice, tool, convention, scope cut, trade- off — or the user says "let's go with", "we decided", or "from now on". Record it as an ADR so future sessions don't re-litigate. NOT for task status (Linear) or temporary notes.
Install
npx vskill@latest install amnafarzy/ravie/decision-log-adrSKILL.md
The same SKILL.md was published earlier as amnafarzy/ravie/decision-log-adr.
decision-log-adr
Record durable product or technical decisions so future sessions don't re-litigate them. The skill that prevents "why did we choose X?" three months from now.
Purpose
When a meaningful decision is made during development — architecture, tool choice, scope cut, trade-off — log it with context, alternatives considered, and rationale. Future sessions read these decisions and respect them.
Process
1. Identify the decision
State it in one sentence: "We will use [X] instead of [Y] because [Z]."
2. Write the ADR
3. Store it
- GitHub:
docs/adr/[number]-[slug].mdin the repo - Notion: in the project's Decisions database
- Link from the relevant Linear issue or PR
Output format
The ADR template above, filled in.
Hard rules
- Never make a durable decision without logging it
- Never delete an ADR — supersede it with a new one that links back
- Always include alternatives considered — "we picked X" without "instead of Y and Z" is incomplete
- Always include a review trigger — when should this be reconsidered?
Connects to
idea-to-prd-tracer— decisions surface during planningnotion-brain— for storing decisions in Notiongithub-operator— for storing ADRs in the reposkill-creator— codify recurring decision patterns
Common failure modes
Decision made in chat, never written down — Three months later, someone asks "why did we do X?" and nobody remembers. Log it when it happens.
No alternatives section — "We chose Supabase" is not a decision log. "We chose Supabase over Firebase because [reasons], accepting the trade-off of [Y]" is.
Never reviewed — A decision from 6 months ago may no longer apply. Review triggers exist for this reason.
Security
- Security scanPassed, 100 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/decision-log-adr/SKILL.md
Popularity
- Repository stars
- 3
- 7-day trend score
- 7
Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/amnafarzy/ravie/decision-log-adr)