Ground a topic before you write

Ask CONTEXT what it already holds about a topic, in Claude Code. Grounding reads the graph and writes nothing to it.

Before you start

• Connect Claude Code in the terminal
• Price and run the first pass, and know it landed

Configuration page

Command line

1. In a terminal at the project root, read that this instance serves the gesture:

   revetly surface
   

   prompts: 5 (revetly-ground, revetly-draft, revetly-capture, revetly-decide, revetly-ship), <COUNT> description chars
   

2. Read how current each source the grounding will draw on is:

   revetly status
   

   <SOURCE>: read <WHEN> ago; changed <WHEN> ago; complete
   

3. Type /revetly-ground with the topic:

   /revetly-ground the review gate
   

   You should see Report what CONTEXT already holds about: … (as Claude Code shows it)

   Revetly answers with ids and source paths, and names the gaps it found.

Troubleshooting

• The grounding names nothing at all. No pass has landed on this instance yet. Run one, then ask again.
• The gap is older than the connection date. That past is unread rather than empty. Price it with revetly backfill --dry-run.

Next steps

• Draft a story and put it up for review
• Read history from before the connection date