Skip to content

Quickstart

This walks one PABCD work-phase from start to close. Each forward transition needs an --attest block; narration alone does not advance the state.

Terminal window
cxc orchestrate P --attest '{"from":"IDLE","to":"P","did":"plan: add pagination to /users"}'

Write the real diff-level plan during P.

Terminal window
cxc orchestrate A --attest '{"from":"P","to":"A","did":"the plan you wrote"}'

Dispatch an adversarial review of the plan, then record the verdict.

Terminal window
cxc orchestrate B --attest '{"from":"A","to":"B","did":"who audited + verdict","auditOutput":"<reviewer verdict tail>"}'

Implement in small commits and verify as you go.

Terminal window
cxc orchestrate C --attest '{"from":"B","to":"C","did":"what you built + verifier verdict"}'

Run the real checks: build, tests, and any scrutiny the change warrants.

The C → D transition additionally requires the check output and a zero exit code:

Terminal window
cxc orchestrate D --attest '{"from":"C","to":"D","did":"what you checked","checkOutput":"289/289 pass","exitCode":0}'

D closes the cycle; the phase returns to IDLE.

Terminal window
cxc orchestrate status # show the current phase and flags
cxc orchestrate reset # return the phase to IDLE