Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions .claude/skills/ci-gates/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -378,6 +378,14 @@ and proved nothing. Controls need their own verification: change the input, see
the output change, then restore. Twice this month a silently-inert control
almost certified a gate that could not fail.

**Classify the WHOLE list, not its head.** After three fixes I wrote that "the
remainder is two design decisions" — from the top six rows of the error output.
Checking all of it later gave 48 unique names and 68 references, and the claim
happened to hold: 56 string reads, 12 unsized-array reads, zero anything else.
It held; it was still stated before it was checked, which is the same sampling
habit that produced a five-fold overcount elsewhere in this repo. A remainder is
a claim like any other — enumerate it exhaustively, or say you sampled.

**Hold the win with a per-module ratchet.** 573 → 186 is invisible to a job that
executes two modules and lints the rest with a tool (yosys) that accepts what
iverilog rejects. The baseline records the count per module, fails naming the
Expand Down
12 changes: 12 additions & 0 deletions docs/now/2026-08-23-classify-the-whole-list.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
# NOW -- the remainder was stated from the top six rows (2026-08-23)

## the claim held, but it was made before it was checked (Refs #2325)

- After the three emitter fixes I wrote that the remaining elaboration errors
are "two design decisions". That came from the head of the error output.
- Checked exhaustively afterwards: 48 unique unbound names, 68 references --
56 string-field reads, 12 unsized-array-element reads, ZERO anything else.
The claim survived, which is luck rather than method.
- ci-gates section 13 gains the rule: a remainder is a claim like any other.
Enumerate it, or say out loud that you sampled. The full breakdown is posted
on #2325 so the owner sees the whole distribution, not my summary of it.
Loading