SpecSheriff
rule · _guidelines/spec/5.2 · s-nyh9yk22ba6g77q

The reviewer sees only the change and the nodes it names

Checkedconfirmed by its owner

The independent reviewer of a commit is given the commit's change, less the files generated from the specification, and the text of the nodes its message and tags name, a data record with its fields — and nothing of the session that wrote the code. Each file left out is named to it as holding the types and runtime checks generated from the data records, which the check of the generated copies compares with what the nodes produce. It refuses the commit where the code does something no named node states or leaves out what one requires, what a data record requires counted as carried out by the types and runtime checks generated from it (§s-e877bnfa559tvk9), and names the node and the line of each finding. A review that cannot be held — no reviewer to run, a run that does not end, an answer that cannot be read — refuses the commit and says why.

Why

Given nothing of the session that wrote the code, the reviewer reads the code against the nodes rather than against its author's intent, and a refusal naming the node and the line can be checked by anyone. The generated files are left out because the check of the generated copies already compares them with what the nodes produce, so what a data record requires is decided there rather than judged. A reviewer judges what a commit leaves out only from what it is shown, so a file withheld from it, or one whose content it is not told is held elsewhere, reads to it as missing. A review that passes whenever it could not be held is a review nobody can rely on.

The links it makes

The links made to it

The decisions taken on it

2026-10-11 · textual
Problem

The reviewer was given the rules a commit names and no data record, so code generated from a data record had nothing to be read against, and the definition of a term the code's names follow was withheld; a generated data record was refused field by field as stated by no rule.

Ruling

The owner: the reviewer is given the rules, data records and terms the message and the tags name, a data record with its fields.

2026-10-27 · textual
Problem

The reviewer was one agent's command line, so the method read as one vendor's tool, and a reader without that agent could not run it.

Ruling

The owner: the base states the reviewer's contract; who carries the review out is a runner described in the appendix of the tools, and a review that cannot be held refuses the commit.

2026-11-01 · textual
Problem

The types and runtime checks generated from a project's data records are its code, so a commit adding them is reviewed, but they were left out of the change the reviewer was given without its being told so: given a message naming the data records and a change holding none of their types, the reviewer refused the commit as leaving them out.

Ruling

The owner: each file left out is named to the reviewer as holding the types and runtime checks generated from the data records, which the check of the generated copies compares with what the nodes produce, and what a data record requires counts as carried out by them.

The tests bound to it