Record a decision

Write one call down as its own note, in Claude Code. The note keeps the reason that forced it and the alternatives that were not taken.

Before you start

• Capture a discussion
• Record a decision only when somebody asks for it.

Configuration page

Command line

1. In a terminal at the project root, read where a decision note will be written:

   revetly doctor --offline
   

   [PASS] records store  conversation = <PROJECT_ROOT>/sources/conversations, delivery = <PROJECT_ROOT>/sources/deliveries …
   

2. Type /revetly-decide with the call:

   /revetly-decide the review gate stays a human gate
   

   You should see Record this decision: … (as Claude Code shows it)

   Revetly states the title as what was decided, rather than as a topic.

3. Read that the note blocks nothing:

   revetly check
   

   Nothing here blocks an ingest — `revetly check --contract` explains each field.
   

4. Tell /revetly-decide what the decision changes, naming an earlier decision it replaces whole in supersedes and a work item it changes in part in revises. Revetly takes a bare id or {id, criteria: [n]} with 1-based criterion positions, and refuses an unknown id or position by name.

Troubleshooting

• The note names no alternatives. A decision with none reads later as the only option there was. Say what was weighed and not taken.
• The search does not find it yet. The capture handle still reads pending. Poll context_health again; pending is not failed.

Next steps

• Draft a story and put it up for review
• Ground a topic before you write