How we work
A fairly standard engineering workflow. Just with AI agents.
Define the problem. Build in isolation. Prove it. Have someone else check it. Ship it. Watch it. Every competent engineering team has worked this way for twenty years. The difference now is who does the steps.
Humans own two gates: the problem and the release. Agents do the rest and are checked by other agents.
The loop
Who does what
Decides
Defines the problem. Signs off the spec. Approves or holds the release. Never writes the code and never reviews a diff line by line.
- Owns the acceptance criteria
- Owns the release decision
- Reads evidence, not code
Builds and proves
Works in an isolated workspace and branch. Implements the spec. Produces the evidence that it works: tests, screenshots, logs.
- One task per workspace
- No access to production
- Burden of proof is on the builder
Checks
Has not seen the build. Gets the spec, the diff and the evidence. Passes or fails the work against the acceptance criteria. Nothing to defend.
- Separate context, separate session
- Fails anything without evidence
- Returns failures to the builder
The nine steps
- 01
Idea
A human defines the problem. What is broken, who it affects, what good looks like. No solution yet.
- 02
Specify
Requirements and acceptance criteria written before any code. The spec is the contract the agent builds against and the reviewer checks against.
- 03
Isolate
Every piece of work gets its own workspace and branch. Nothing touches shared code or production until it has been reviewed.
- 04
Build
The engineering agent implements the spec inside the isolated workspace. Scope is the spec. Anything outside it is a new idea.
- 05
Prove
The same agent produces evidence. Passing tests, screenshots of the running feature, logs from the run. No evidence, no review.
- 06
Review
A separate review agent checks the work against the spec and the evidence. Fail sends it back to Build. Pass sends it to a human.
- 07
Approve
A human decides whether to release. Approved goes to Ship. Not approved goes to Hold. The human reads the evidence and the review, not the code.
- 08
Ship
Merge and deploy. Automated. The branch closes, the workspace is discarded.
- 09
Monitor
Errors, feedback and improvement requests are tracked. Anything worth doing becomes new work and enters at Specify. Shipped is not finished.
What never changes
- 01A human writes the problem and the acceptance criteria.
- 02Every task runs in its own workspace and branch.
- 03The agent that built it has to prove it. Tests, screenshots, logs.
- 04A separate agent that has not seen the build does the review.
- 05A human approves every release.
- 06Shipped is not finished. Monitoring feeds the next spec.
Questions
- Why does a separate agent review the work?
- An agent grading its own work passes its own work. The review agent has not seen the build. It gets the spec, the diff and the evidence, and it has nothing to defend.
- What counts as evidence?
- Passing tests, screenshots of the feature running, logs from the run. If the agent cannot show it, it did not happen.
- Where do humans sit in the workflow?
- Two gates. A human defines the problem at the start and approves the release at the end. Everything between is done by agents and checked by agents.
- Does this only apply to software?
- No. The same loop runs a content pipeline, a CRM rebuild or an operations automation. Specify, isolate, build, prove, review, ship, monitor. The tools change. The gates do not.