Decision Log

Capture architectural and feature decisions as lightweight ADR files. Automatically triggered when exiting plan mode; manually triggered for significant decisions outside plan mode.

Setup (run once per project)

1. Create the decision log directory

Scan the repo for common documentation folders (docs/, doc/, documentation/). Use the first match as {docs}. If none exist, default to docs. Then:

mkdir -p {docs}/decisions

2. Register in project agent instructions

Add to the project's AGENTS.md, CLAUDE.md, or GEMINI.md (whichever exists, prefer AGENTS.md):