Skip to content
Rulebook 0.4.0 · effective Standards CD-0 · OS-1 · OS-2 · OS-3
Amendments

Suggestions

A suggestion is a proposed change to the Rulebook or to an Outcome Standard. Rules are data here, so a change is a new version of a file: a new hash, an effective date, and a changelog entry. Nothing about a rule changes quietly.

In force0.4.0
Effective2026-08-26
Rulebook hashsha256:8ffd8536…
StandardsCD-0 · OS-1 · OS-2 · OS-3
Open suggestions0
Part 1
#open

Open now

Nothing is open. When a suggestion is published, it appears here with its target, the proposed text, the day the comment period closes, and the comments received.

No open suggestions

Rulebook 0.4.0 is the first public draft and no change to it has been proposed. The changelog on the Rulebook carries every version that has taken effect.

Part 2
#rule

The rule

Amendments are governed by the Rulebook itself, and this is the clause, rendered from the data file the same way every other clause on this site is.

Rulebook · amendmentsM1 · 0.4.0
M1

Recourse publishes proposed changes with a 14-day comment period. Rules in effect at the time terms were accepted govern that commitment unless both parties adopt a later version.

Two consequences worth stating plainly. First: a commitment already signed is not moved by a later version — the terms name a rulebook version, and that version governs unless both parties adopt a newer one. Second: the version a commitment names is hashed, so a party can check that the rules it was judged under are the rules it agreed to.

Fourteen days is the floor, not the schedule. A change that alters what counts as an outcome runs longer, because the parties whose deals it changes have to be able to read it first.

Part 3
#contents

What to send

Six things. A suggestion that has all six can be assessed by anyone; a suggestion missing the fixtures cannot be assessed at all, because nobody can tell what it decides.

Suggestion6 fields · all required
FieldValueWhat it has to say
targetrule id or standard idThe exact clause: a rulebook section id such as A4, a reason code such as R-311, or a standard criterion such as OS-1 c3.
text_nowverbatimThe clause as it reads today, copied. A suggestion against a paraphrase is a suggestion against a different rule.
text_proposedverbatimThe replacement, written to be testable as written. A criterion that cannot be checked is refused under R-520 whoever proposes it.
failureone caseThe outcome the current text gets wrong, stated as a case with facts. Not a preference — a wrong answer.
fixtures5 or moreCases the changed rule must decide, with the decision each one expects. A rule arrives with its tests or it does not arrive.
effectlistWhich reason codes, standards, or deterministic rules change with it. A rule that is cited by another rule cannot move alone.

Five fixtures is the repository’s rule for adding a rule, not a number invented for this page. Code here never branches on a rule id, so the fixtures are the only thing that says what the rule does.

Part 4
#path

Where it goes

A suggestion is a change to a file. These are the files, and their hashes are what every commitment cites.

The files a suggestion targetspaths in the repository
packages/rulebook/data/rulebook/0.4.0.json    the rules and the reason codes
packages/rulebook/data/rulebook/0.4.0.md      the same rules, for people
packages/rulebook/data/standards/CD-0/0.4.0.json
packages/rulebook/data/standards/OS-1/0.4.0.json
packages/rulebook/data/standards/OS-2/0.4.0.json
packages/rulebook/data/standards/OS-3/0.4.0.json

# every load validates against packages/rulebook/src/schema.ts, so a
# change that breaks the shape never reaches a page or a ruling.

A published version is never edited in place. A change is a new version number, a new file, a changelog entry, and a new hash — the old file stays exactly where the commitments that cite it can still find it.

Part 5
#not

Not a suggestion

Two things get confused with this page. Neither belongs here, and sending them here delays them.

A ruling you lostAppeal it on the commitment, inside the appeal window. A suggestion changes the rule for future commitments; it does not reopen yours.
A standard that does not fit your dealWrite terms against CD-0 with your own acceptance criteria. A standard is changed when it is wrong for everyone, not when it is wrong for one contract.

Appeals are Rulebook part B; the custom deliverable standard is CD-0.