Skip to content

docs(rules): every route is a judgement — the handoff seam's clause of the seam grammar (#333) - #340

Open
hugolytics wants to merge 3 commits into
mainfrom
docs/routing-is-a-judgement
Open

docs(rules): every route is a judgement — the handoff seam's clause of the seam grammar (#333)#340
hugolytics wants to merge 3 commits into
mainfrom
docs/routing-is-a-judgement

Conversation

@hugolytics

Copy link
Copy Markdown
Collaborator

Linked issues

What lands

A new CLAUDE.md section, Every route is a judgement, placed between "Parallelise model calls" and "Testing against a real model": routing, defaults, channel ownership, command meaning and a state's allowed decisions are decisions about what the user meant and fall under the no-pattern-matching rule. The rule in five clauses (a default is an offered option; none escalates, never a hardcoded fallback; two tiers with tier one on the flash pin at minimal; adding a route is adding a row; guarantees about state stay code with a test), the 2026-09-05 evidence, and the excuses table. Framed as the handoff seam's clause of the seam grammar map #333 is charting. One bullet in AGENTS.md's proposal contract points to it.

Hugo asked for this first, so the philosophy governs every design and refactor decision from here — including the ~36 sessions being aligned to map #333 now.

Verification

Docs only; no code. Read it against the incident in #328 and the four routes it names.

Before merging (Hugo)

🤖 Generated with Claude Code

hugocool and others added 3 commits September 6, 2026 00:01
…f the seam grammar (#333)

Where a message goes, which agent answers, whether a default applies: decisions
about what the user meant, covered by the no-pattern-matching rule and treated
as plumbing until 2026-09-05, when four hardcoded routes turned a correctly
classified question into a five-stage session (#328). A default is an offered
option; none escalates to a capable agent; tier one is the flash pin at minimal;
adding a route is adding a row; guarantees about state stay code. AGENTS.md's
proposal contract points here.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
…it gates what the user sees (#333)

standing_for answering 'this day is committed' is a guarantee with a test; the
judgement beside it is which day a bare command means and whether a message
about a committed day opens or revises. Named by admonish-1-56 against a live
case where the guard was right all day and the /timebox door never asked it.
Without this line the rule invites replacing a correct query with a classifier.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
…gements, 61 guarantees, 13 unpinned (#335)

A read-only sweep against CLAUDE.md's test. The distribution is the finding:
src/memory/ and src/tmbx/ are clean, and every banned pattern in the repo is in
the route layer — which is exactly the exception the new section names.
Highest blast radius: the agent-selection or-chain on every message, seven
_display_context tuples with no none anywhere, and a hand-typed phrase set in
the revisor short-circuiting a working model call on the next line.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants