How Intent-System runs today.
A two-region operational loop with a feedback path. The released v0.22.0 four-thread model keeps design human-facing or places it in herdr; herdr-only is the preferred non-preview path for collocated teams. Implementation and review stay loopless; intent-cli and GitHub remain the source of truth. A three-thread timer loop remains a supported alternative.
Hover over a node to isolate the surrounding hand-off, pass, and reject paths.
Curated by humans
- Inferred intent capture — agents propose; humans accept or reject.
- Tree placement — Purpose / User Context / Means.
- Clarification loop until ambiguity is resolved.
- Promote: inferred → clarified → canonical.
- Slice into an issue ready for implementation.
Driven by agents
- The implementation thread receives one Issue — delegated by the orchestrator through the selected session layer, or picked up by the timer-loop alternative.
- Agent implements from what is embedded in the issue; PR opens against the configured target branch or selected named lane.
- AI review — a separate review thread in a different cwd diffs the implementation against the packet and the intent tree it has loaded. Pass continues; reject sends a clarification back to Ⓐ-③.
- Human final approval before promotion to the configured target branch or main.
- Closeout writes the diff back into the tree as canonical.
Post-release defects re-enter the same loop
The implementation will not be perfect, and that is fine — Intent-System treats the post-release feedback path as a first-class part of the loop, not as an exception. Each defect or surprising behavior is filed as an Intent-Bug issue and triaged against the intent tree:
- Implementation bug. Intent was right; code did not honor it. Re-enter Ⓑ-① with the same intent slice; fix on the same configured lane.
- Intent gap. Intent said nothing on this point; the implementer made a local choice; the result was not what the team wanted. Re-enter Ⓐ-③ as a clarification → promote the tree → then cut a new issue from the sharper intent.
Either way the bug exits via the same AI review → human approval → promotion path. Drawing this line correctly is what makes the tree get stronger over time instead of just bigger.
Want the implementation-level view?
This page shows the two-region operational model. Next, see the herdr-only four-thread path or the simpler timer-loop alternative.