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
22 changes: 22 additions & 0 deletions .claude/workflows/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -75,3 +75,25 @@ silent drop is fixed was measuring the drop — on W699, recovering 1 049 discar
tokens took Zig 217 to 215 because three specs had been accepted on less code
than they contain. Two of three lenses must affirmatively establish that working
behaviour was lost before a row is called a regression.

## The rule both of these follow: measure against the past

`column-forensics` takes two per-item dumps from two builds because an aggregate
at HEAD says nothing about what a change did. The same rule applies to a
DETECTOR, and it is easy to miss.

`tri abandoned list` was written to find the pattern behind four parser defects.
Run at HEAD it named one site — a result equally consistent with "works" and with
"matches nothing", because the four defects it was built for are fixed. The
control is the commit before the fixes; there it names four.

```
git worktree add /tmp/before <commit-before-the-fixes>
tri abandoned list --file /tmp/before/bootstrap/src/compiler.rs
```

**A new instrument's first run should be against a commit where the thing it
looks for was still there.** And when it finds only some of them — two of four,
here — that number is the instrument's specification, not a bug to tune away. A
detector adjusted until it hits its own motivating examples has stopped being
evidence.
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
# NOW -- The workflows README states the historical-control rule (2026-08-29)

## The workflows README states the historical-control rule (Refs #2754)

- an instrument's first run belongs against a commit where the thing it looks for was still present
- a partial hit rate is the instrument's specification, not a bug to tune away
Loading