Product
Review is intent diffing. Closeout sets up the next slice.
Intent-System's unit of work is the loop, not the PR. The full cycle is issue → implement → review → fix → accept → closeout → next-slice. The herdr-only orchestration path and timer-loop alternative use the same review logic; they differ in how work is delegated.
The seven steps
01
Packet generation
The design thread asks the LLM to slice the intent tree into packets — work units one level above an Issue that carry references to intent and explicit verification points. Before promotion, the design thread also runs the merged app and folds screen-level observations into the packet.
02
Issue cut
A packet with high enough DIF and resolved dependencies becomes an Issue in the implementation repo. The Issue already carries why we build this.
03
Implement
The implementation thread reads the packet/intent, implements, and opens a PR against the configured target branch or named lane. In the primary four-thread model an orchestrator delegates the unit through the selected session layer; herdr-only is the preferred non-preview path for collocated teams, while a timer loop remains a supported alternative.
04
Review
The review thread in a different cwd diffs the PR against the packet and intent tree. Findings: pass, repair-in-place, or repair the intent. A human gives final approval before merge.
05
Fix
If repair-in-place: the implementation thread applies the fix to its own PR, pushes, and hands the updated PR back to the review thread. If repair-the-intent: a clarification flows back to the design thread.
06
Accept + closeout
PR merges into the configured target branch or named lane. The diff is written back into the intent tree as canonical, and state files (queue, runs) are updated.
07
Next-packet re-evaluation
On Approve the loop rewinds to step 01: from the post-merge tree, the design thread re-evaluates which packet to generate next. This rewind is what keeps the next work unit flowing reliably.
Herdr-only orchestration
The review rule stays the same
In the primary model, herdr keeps the review receiver visible and supervised while it waits for one concrete task. After completion, the orchestrator verifies the claim against intent-cli, GitHub, and the expected artifact before merge, closeout, or next-slice publication. Read the orchestration model →
Three review outcomes
- Pass. Implementation honors intent. Proceed to closeout.
- Repair-in-place. Implementation needs adjustment; intent stands. Implementer fixes the PR.
- Repair-the-intent. The intent itself was wrong or ambiguous. A clarification flows back to Ⓐ-③.