A seam is a pasted-in agreement, not a parsed contract: the file goes into a consumer's prompt byte-for-byte, so what you write here is what the agent reads as ground truth until the producer lands the real thing (design §6).
Process
-
Find the workspace. Same resolution
to-ticketsstep 7 uses:ls "$(git rev-parse --show-toplevel)/../.claude/command-centre.toml" 2>/dev/nullIf it's absent, say so and stop — a seam with no
[[seam]]config to read it is pointless.
-
Ask for the four things a seam needs:
- Name — a short slug (
customer-tier-field). Becomes the seam filename and the[[seam]]key. - Producer repo — the
[[repo]]name incommand-centre.tomlthat will land the real thing. - Consumer repo(s) — whichever repos are building against the agreement now. Not written
to config — only
producer_repoandlands_atare read by anything, the retirement pointer — this is so you know which tickets' nextto-ticketsrun should list this seam by name in theirseams = [...]. lands_at— one or more paths, in the producer repo, the real thing will live at once it merges. Optional: if the landing path isn't settled yet, leave it empty and say so — an emptylands_atjust means "no retirement", not an error.
- Name — a short slug (
-
Get the agreed interface itself. Ask the user to paste or dictate exactly what a consumer's agent should read — a schema, a type, a function signature, whatever the two sides agreed on. Paste it in verbatim: nothing here is parsed, marked up, or addressed by symbol (design §6). If the user hands you prose describing the agreement rather than the interface text itself, ask for the actual text instead of summarising it back to them.
-
Show both writes, then halt for approval. Before touching disk, show:
- The seam file's exact planned content, in full.
- The
[[seam]]block exactly as it will be appended:[[seam]] name = "<name>" producer_repo = "<producer repo>" lands_at = ["<path>", …]
Wait for explicit confirmation before writing either file (§10) — a seam silently written is a prompt silently changed under whoever cuts a task against it next.
-
Write, in this order: the seam file at
<workspace>/.claude/seams/<name>, then append the[[seam]]block to<workspace>/.claude/command-centre.toml. Upsert onname: if a[[seam]]block for this name already exists, replace it in place rather than duplicating it, and say so.
Finishing up
Tell the user the seam's name and which consumer tickets should list it in seams = [...] the
next time to-tickets runs for those repos.