Skip to content

Commit 83e20bb

Browse files
cailmdaleyclaude
andcommitted
docs: auto-deploy after verify is the default, not a step to stop before
A built+verified change should ship from the worker's own session — the deploy is mechanically safe, so a branch-and-wait gate buys only a human code review that rarely happens, i.e. latency without safety. Verification that matters (mix test, ui build, the skill's fresh-eyes review) happens in-session; "stop for the human" is reserved for genuine design calls and constitution-pinned gates, not deploy mechanics. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01JcN4nhgBBnL1RniKFLJrjs
1 parent 255edee commit 83e20bb

1 file changed

Lines changed: 18 additions & 0 deletions

File tree

AGENTS.md

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -229,6 +229,24 @@ deploy freely whenever there's a fix to ship — never hold back, gate it behind
229229
brief API/board blip during the ~1s (local) to ~2min (candide cold-walk)
230230
restart; in-flight work is unaffected.
231231

232+
**An autonomous worker that has built and verified a change SHOULD deploy it —
233+
that is the default, not a step to stop before.** Because the deploy itself is
234+
mechanically safe (above), the only thing a branch-and-wait gate buys is a human
235+
*code review* — and in practice that review rarely happens, so parking finished,
236+
verified work on a branch is mostly latency and friction, not safety. The
237+
verification that *does* matter happens in-session: build → run the tripwire
238+
(`mix test`, `cd ui && npm run build`) → get the skill's independent fresh-eyes
239+
review (a subagent over the diff-against-constitution, an adversarial pass for
240+
complex work) → **then deploy, in the same session.** Don't hand a finished,
241+
green change back to Cail just to have him run `make all` + rsync. Reserve
242+
"stop for the human" for the genuinely different case — a change whose *design*
243+
he should weigh in on before it ships (a capability removed, a contract redrawn,
244+
a load-bearing model choice); even then, surface the alternatives in the fiber
245+
and keep moving rather than treating the deploy *mechanics* as the gate. A
246+
constitution may still pin an explicit human-review gate when the stakes warrant
247+
it, but that is the deliberate exception a constitution names, not the resting
248+
posture of every change.
249+
232250
**Deploying to remote hosts (candide, cineca):** push to GitHub first, then build on the host — don't copy the macOS escript, as BEAM bytecode format varies across OTP versions and the binary will crash on startup on a different host.
233251

234252
```bash

0 commit comments

Comments
 (0)