Skip to content

fix(rubric): make the 23/23 run reproducible instead of merely asserted - #49

Merged
wjlgatech merged 1 commit into
mainfrom
fix/rubric-v1-reproducible
Aug 21, 2026
Merged

fix(rubric): make the 23/23 run reproducible instead of merely asserted#49
wjlgatech merged 1 commit into
mainfrom
fix/rubric-v1-reproducible

Conversation

@wjlgatech

Copy link
Copy Markdown
Owner

An independent review of the article about this work found the disqualifying defect, and it was mine.

The rubric that scored 23/23 was never committed. git log --all -- docs/rubrics/ returned exactly one commit. The only trace of 23/23 anywhere was prose written by the person claiming it — a commit message, a YAML comment, a report card.

That is exactly the category this rubric exists to reject: evidence is observed, never asserted. The headline number of the whole exercise was asserted.

Now it is observable:

python3 scripts/audit_loop_rubric.py --rubric docs/rubrics/archive/agent-loop-engineering.v1.yml
# **Conformance: 23/23 (100%)** ... gate **PASS**
  • docs/rubrics/archive/agent-loop-engineering.v1.yml — 26 items (23 verifiable + 3 declared gaps)
  • docs/rubrics/archive/AUDIT.v1.md — its output

The file is labelled a reconstruction, not a recovered original: it is the current rubric minus the five second-pass items, committed after the fact. Saying so is the difference between evidence and a better-dressed assertion.

--rubric is added to the checker, and the report now names which rubric it scored so an archived run cannot be mistaken for the live one.

Also fixes a dead pointer the same review caught: both files cited a docs/skill/playbooks/... path that does not exist in this repo. The rules are restated in place.

606 tests pass, ruff clean.

🤖 Generated with Claude Code

An independent review of the article about this work found the disqualifying
defect, and it was mine: the first rubric — the one that scored 23/23 — was never
committed. `git log --all -- docs/rubrics/` returned exactly one commit. The only
trace of 23/23 anywhere was PROSE written by the person claiming it: a commit
message, a YAML comment, a report card.

That is precisely the category this rubric exists to reject. Evidence is observed,
never asserted — and the headline number of the whole exercise was asserted.

So it is now observable:

  docs/rubrics/archive/agent-loop-engineering.v1.yml   26 items (23 verifiable + 3 gaps)
  docs/rubrics/archive/AUDIT.v1.md                     its output: 23/23, gate PASS

  python3 scripts/audit_loop_rubric.py \
      --rubric docs/rubrics/archive/agent-loop-engineering.v1.yml

The file is labelled a RECONSTRUCTION, not a recovered original: it is the current
rubric minus the five second-pass items, committed after the fact. Saying so is the
difference between evidence and a better-dressed assertion.

`--rubric` is added to the checker for this, and the report now names which rubric
it scored, so an archived run cannot be mistaken for the live one.

Also fixes a dead pointer the same review caught: both files cited
`docs/skill/playbooks/operationalizing-a-paper-rubric-checklist-standa.md`, a path
that does not exist in this repo (the playbook ships with the anyagent skill). The
rules are now restated in place so each file stands alone.

606 tests pass, ruff clean.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@wjlgatech
wjlgatech merged commit 4ae072c into main Aug 21, 2026
3 checks passed
@wjlgatech
wjlgatech deleted the fix/rubric-v1-reproducible branch August 21, 2026 16:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant