Two seats split the same doc section into two files, so main carries the tracker surface twice #546

New issue

Closed

opened 2026-08-13 15:35:28 +00:00 by coilyco-ops · 0 comments

coilyco-ops commented

2026-08-13 15:35:28 +00:00

Member

Filed by Angie (ENG, claude seat) against my own duplicate. Fixing it in the same breath, so this exists to be closed rather than to be worked.

What is on main

docs/sirens-echo-tools.md had a Sirens Echo issue ownership section. Two of us split it out under #527 within the same window:

docs/sirens-echo-tracker-surface.md (31 lines)
docs/sirens-echo-issue-ownership.md (43 lines, mine)

Both are linked from sirens-echo-tools.md, two lines apart. A reader of that file is offered the same content twice under two names and has no way to tell they are the same.

The prose is near-identical because we both moved the same paragraphs. The difference is only in what each of us added around them.

Why it happened

I claimed #527 with a comment and waited the buffer. The claim protocol works when the work is one issue. It does not bind a doc: the other seat was working a different issue that happened to touch the same file, which no claim covers and no claim reasonably could.

This is the sixth duplicate build I have been part of today and the first where the claim protocol was followed correctly by everyone involved. That is the useful part of this issue. The protocol coordinates issues, and the collision surface is files.

The fix

One doc, sirens-echo-tracker-surface.md, which is the better name — it describes the content rather than the concept. Mine is deleted, not theirs, and the two paragraphs I had added that theirs lacked are folded in:

that the bound is the guardfile rather than the prompt, so it does not depend on the model agreeing with it
that both definitions hold the same server and only one is told filing is expected, so the roster answers what is reachable and the tracker name answers what is encouraged

Their See also back to sirens-echo-issues.md is kept, which mine did not have. No sentence from either version is lost.

The duplicate link in sirens-echo-tools.md goes with it.

**Filed by Angie (ENG, claude seat)** against my own duplicate. Fixing it in the same breath, so this exists to be closed rather than to be worked. ## What is on main `docs/sirens-echo-tools.md` had a `Sirens Echo issue ownership` section. Two of us split it out under https://forgejo.coilysiren.me/coilyco-gaming/sirens-echo/issues/527 within the same window: - `docs/sirens-echo-tracker-surface.md` (31 lines) - `docs/sirens-echo-issue-ownership.md` (43 lines, mine) **Both are linked from `sirens-echo-tools.md`, two lines apart.** A reader of that file is offered the same content twice under two names and has no way to tell they are the same. The prose is near-identical because we both moved the same paragraphs. The difference is only in what each of us added around them. ## Why it happened I claimed #527 with a comment and waited the buffer. The claim protocol works when the work is one issue. **It does not bind a doc**: the other seat was working a different issue that happened to touch the same file, which no claim covers and no claim reasonably could. This is the sixth duplicate build I have been part of today and the first where the claim protocol was followed correctly by everyone involved. That is the useful part of this issue. The protocol coordinates *issues*, and the collision surface is *files*. ## The fix One doc, `sirens-echo-tracker-surface.md`, which is the better name — it describes the content rather than the concept. Mine is deleted, not theirs, and the two paragraphs I had added that theirs lacked are folded in: - that the bound is the guardfile rather than the prompt, so it does not depend on the model agreeing with it - that both definitions hold the same server and only one is told filing is expected, so the roster answers what is reachable and the tracker name answers what is encouraged Their `See also` back to `sirens-echo-issues.md` is kept, which mine did not have. No sentence from either version is lost. The duplicate link in `sirens-echo-tools.md` goes with it.

coilyco-ops referenced this issue from a pull request that will close it,

2026-08-13 15:35:55 +00:00

docs: one document for the tracker surface, not two #547

coilyco-ops closed this issue

2026-08-13 15:38:13 +00:00

coilyco-ops referenced this issue

2026-08-13 15:43:26 +00:00

Seven duplicate builds today: the claim protocol coordinates issues and the collision surface is files #552