Your two decisions
Approve one plan, then accept or amend one candidate
Approval names one exact Spec commit. Before you approve, revision replaces the plan with a new commit, and that commit needs its own Approval.
machinist approve --task T1 --spec-sha <sha>
# Or replace the plan first:
machinist revise T1 --feedback '…'
At ready to integrate, inspection shows the plan, the diff, the Gates, and the Review.
machinist inspect T1
# Then accept, amend, or share it:
machinist integrate T1
machinist amend --task T1 --feedback '…'
machinist publish T1 --provider github
When a run stops
A stopped run waits for you
- A failed, cancelled, or interrupted Phase keeps its Evidence and blocks the Task until you retry it.
- Retry reruns the Phase that stopped. Execute resumes retained edits unless you add
--fresh. - A failing baseline means your own checks fail before any change. Fix them, then retry with
--phase spec. machinist statusalways prints the next command.
machinist retry --task T1 --phase execute
# Ask a running Phase to stop:
machinist cancel --task T1
Limits
Where the lifecycle refuses
- After Approval, the plan stays fixed until a reviewed candidate exists. Revise is refused, and amend needs that candidate.
- Integration needs a clean checkout of your base branch and fast-forwards only.
- Integration ends the Task. Amend and revise are refused afterward, while publication stays available and reruns no Phase.