Public: anyone can read this; the crew can change it.

Chosen rule-set: Sworn & Said — write the rules of record as RULES.md #17

Merged opened this

Check · Review · Land · Live done — Landed and live in production.

Merged

Pushed. Documentation only — no code touched, `bun test` still 18 pass / 0 fail.

shipped production is serving it deploy 6ecafc0

opened this

Pushed. Documentation only — no code touched, bun test still 18 pass / 0 fail.

RULES.md (new) is the rules of record for Sworn & Said: a vocabulary table naming every concept the code will use (table, seat, charter, clause, setting, accord, charge, aim, dread, act, standing offer, quorum, sworn/said claim, binding, settlement, impound) and the state machine open → playing → settled | impounded; a single table of every fixed number (4–6 seats, 7 clauses of 3 settings, 4 aims on distinct clauses, quorum ⌈n/2⌉+1, 6h window, 24h deadline, score range −3…10); a 12-clause pool with the exact clause and setting ids to store; scoring; the turn and act rules derived from the ledger; the sworn rule; the said register with its verdict mapping; the clock and the impound; binding, settlement and the reveal; a hand-checkable four-seat worked example (nine acts, accord A₂ binds on the third acceptance, scores 8/6/4/8, one said claim false at reveal); an honest paragraph on what the design borrows from Junta, Diplomacy and Sheriff of Nottingham and what it does not; and a closing table of what state each rule reads, so nothing here needs a judge, a chat log or a random number after the deal. README.md gains one sentence linking it.

Two places where the issue was silent and I fixed a rule rather than leave it to whoever implements it — both worth a look:

  • The three positive weights of a charge are distinct (so a charge totals 6, 8, 9 or 10). This makes a sworn weight informative and bounds the score range. Issue #6's generator should assert it.
  • A positive aim can be sworn only once, ever. Issue #9 asks both that re-citing while a secret satisfied aim exists be refused and that the same citation twice be refused; taken together that means a signature always costs a fresh truth, so a seat has at most three acceptances in a whole game and an accord satisfying only already-sworn aims cannot be accepted by that seat. I adopted that reading because it is the sharper game, and flagged the consequence in §6. If the intent was the looser rule (re-citation allowed once nothing is secret), that is a one-paragraph change here plus one test there.

Also named, because the code needs a number and the issue only said "sane": at most 3 said claims per act, turn window 15m–48h, deadline 1h–14d and never less than two turn windows (the 6h/24h defaults satisfy it), plus a ranking rule — ties share the rank, no tie-break. I did not touch AGENTS.md or any module; the notes demo is still what the app serves, and the preview will look exactly as it did before.

🤖 Generated with Claude Code

Closes #5

Sign in to join this conversation.

↑↓ navigate ↵ open ⌘↵ its app esc close

Keyboard shortcuts

Docs