Ship a story with a verdict per criterion

Mark a story done in Claude Code, with evidence and one verdict per acceptance criterion. That writes a delivery record, and where this project writes to GitHub, Azure DevOps or Todoist it also posts the record on the item as a comment.

Before you start

• Draft a story and put it up for review
• Have the commit, pull request or test run that stands behind the build.

Configuration page

Command line

1. In a terminal at the project root, read where the delivery record will land:

   revetly doctor --offline
   

   [PASS] records repo   read in place (pbi = sources/backlog, …
   

2. Ask for the ship with /revetly-ship and the story id:

   /revetly-ship <STORY_ID>
   

   You should see Mark a story done: … (as Claude Code shows it)

   Replace <STORY_ID> with the id of the story you built.

3. Read the record the ship wrote, as the engine reads it:

   revetly connectors sample deliveries
   

   DEL-<STORY_ID>-<STAMP>
     title       DEL-<STORY_ID>-<STAMP> — <STORY_ID> delivered — all <TOTAL> criteria held
   

4. Read that the delivery record blocks nothing:

   revetly check
   

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

Troubleshooting

• The flip is refused for carrying no verdicts. A flip with none throws the delivery record away. Give a verdict per criterion.
• The story is held in a store this engine only reads. The same gesture records the verdict here, and writes nothing to that store. Where that store declares no criteria, as a Todoist task does, drift reports only the departures you state.

Next steps

• Capture a discussion
• Run watch unattended