open/ktg-plugin-marketplace
1
0
Fork 0
Code Issues Releases Activity

docs(catalog): repo-mailbox block describes board + route, not just coord-send

Browse source 
Same defect class as 9992235, found by auditing the remaining ten blocks:
the version label v0.12.1 was correct while the prose sat three minor
bumps behind. The block promised "3 skills" in its stat line and then
described exactly one of them.

`board` (v0.10.0) and `route` (v0.10.0) were invisible in the catalog --
the cross-repo attention board and the model/effort rubric that is now
the single copy of the operator's global routing policy. `reply-expected`
/ `--fyi` (v0.11.0) was missing too: the format can finally tell a
question from a notice, and absence means expected.

Two numbers were measured wrong, not estimated wrong:

  3 CLI scripts     -> 6 operational (board, coord-count, coord-done,
                       coord-inbox, coord-send, route) + 3 selftests
  70 selftest checks -> 251, by running them:
                       coord 159, route 56, board 36

The other nine blocks were audited on the same two axes and are correct.
Every "Key commands" line was checked against real command files -- no
phantom commands anywhere, so the flag half of the graceful-handoff
defect does not repeat. Two prose claims I suspected held up on close
reading: voyage's annotation HTML view (README:24, 509+) and
claude-design's "enforced by test" -- that test says "collision", not
"overlap", so the first grep was too narrow, not the catalog wrong.

voyage's "500+ tests" stays UNMEASURED (76 test files, assertions not
run). Not asserted either way.
This commit is contained in:
Kjell Tore Guttormsen 2026-07-31 21:13:10 +02:00
commit a67d7f5340
1 changed files with 6 additions and 4 deletions
Download patch file Download diff file Expand all files Collapse all files

10
README.md
View file

@ -182,11 +182,13 @@ End-to-end facilitator for prompting Claude Design (`claude.ai/design`). Walks y
A local mailbox for coordination between Claude Code sessions in different repositories. Session A in repo X leaves a message for repo Y; the next session in repo Y gets it injected as context at startup. Local, private, no network, no SaaS.
- **Deliver until done** — directed messages re-inject at every session start (`/clear` never loses them) until replied to or archived; broadcasts deliver once per repo via a seen set
- **Untrusted by design** — message content is quote-prefixed and framed as untrusted data; send-side field sanitization blocks frontmatter injection
- **Natural-language sending** — the `coord-send` skill maps "tell repo-x the bug is fixed" to the right delivery: broadcasts, bounded multi-target loops, replies, and deferred sends
- **Deliver until done** — directed messages re-inject at every session start (`/clear` never loses them) until replied to or archived; broadcasts deliver once per repo via a seen set. `reply-expected` distinguishes a question from a notice (`--fyi`); absence means expected
- **Untrusted by design** — message content is quote-prefixed and framed as untrusted data; send-side field sanitization blocks frontmatter injection. The obligation to answer is procedural, never substantive
- **`coord-send`** — natural-language sending: maps "tell repo-x the bug is fixed" to the right delivery — broadcasts, bounded multi-target loops, replies, retractions, and deferred sends
- **`board`** — read-only cross-repo attention board: which repos have a live next step, which are blocked and on whom, which owe a reply, and what each costs to move
- **`route`** — turns four scored traits of the next task into a model/effort row from a closed six-row rubric, with a pasteable startup command and a one-row-cheaper fallback
1 hook · 3 skills · 3 CLI scripts · 70 selftest checks · [Full documentation →](https://git.fromaitochitta.com/open/repo-mailbox)
1 hook · 3 skills · 6 CLI scripts · 251 selftest checks · [Full documentation →](https://git.fromaitochitta.com/open/repo-mailbox)
---