docs(agents): fetch before the first edit, because a claim reserves a number and files collide #691

Merged

coilyco-ops merged 1 commit from coilyco-ops/fetch-before-the-first-edit into main

2026-08-13 19:01:36 +00:00

AGit

coilyco-ops commented

2026-08-13 19:00:24 +00:00

Member

closes #690 - three habits from seven measured duplicate builds; the guard is a fresher read of main, not a better claim

coilyco-ops added 1 commit

2026-08-13 19:00:24 +00:00

docs(agents): fetch before the first edit, because a claim reserves a number and files collide

ci / image-build (pull_request) Successful in 19s

Details

ci / test (pull_request) Successful in 36s

Details

ci / publish-echo-image (pull_request) Has been skipped

Details

ci / publish-observed (pull_request) Has been skipped

Details

27302c9e53

Seven duplicate builds from one seat in ninety minutes, every one
claimed correctly on its issue first. A claim reserves an issue number
and two issues can point at one function, which is sirens-echo#552's
finding, measured seven more times.

In each case the competing change merged after the branch was cut and
before the push, a gap of two to five minutes. So the guard is not a
better claim, it is a fresher read: fetch origin/main immediately before
the first edit rather than only when branching.

The second habit is cheaper still. One of the seven was a document whose
filename already existed on main. Grep for the thing before building it.

The third is what makes a duplicate survivable. Three of the seven
produced something worth landing once the merged version was read
properly rather than argued against, and the rest were dropped including
a pull request of my own that was a strict subset of what landed. The
landed version is usually better, and reopening a settled question to
keep your own costs more than the duplicate did.

Beside the consult habits, because both attach to something an agent is
already doing rather than asking for new tooling.

The race half stays on 552, which needs a coordination decision.

Refs sirens-echo#690, sirens-echo#552

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Co-authored-by: Kai Siren <coilysiren@gmail.com>
Co-authored-by: Claude <noreply@anthropic.com>

coilyco-ops requested review from coilysiren

2026-08-13 19:00:24 +00:00

coilyco-ops merged commit b6737c443a into main

2026-08-13 19:01:36 +00:00

coilyco-ops referenced this pull request from a commit

2026-08-13 19:01:37 +00:00

Merge pull request 'docs(agents): fetch before the first edit, because a claim reserves a number and files collide' (#691) from coilyco-ops/fetch-before-the-first-edit into main