docs(readme): how to run the drill against the latest version #60

Merged

dan-claude-bot merged 1 commit from docs/readme-run-the-drill into main

2026-07-15 00:29:13 +00:00

dan-claude-bot commented

2026-07-15 00:28:28 +00:00

(Migrated from github.com)

The README's drill section showed the three commands but skipped the step that actually bites (it bit twice while verifying #55): making sure the checkout you run is the code you mean to judge.

New "Run the drill yourself" block spells out the two versions in play:

the drill script you run — clone or refresh a checkout, and git log --oneline -1 is the drill that will judge;
the code under test — the drill doesn't test your working tree; it installs box from GitHub (default heavy-duty/box@main) and asserts the installed tree is exactly the ref it asked for before issuing any verdict. --ref / --repo select a release or a PR branch.

Rider: drill/drill.sh's REPO default still said heavy-duty/claudebox — GitHub redirects it, but the default should name the repo that exists post-rename.

🤖 Generated with Claude Code

The README's drill section showed the three commands but skipped the step that actually bites (it bit twice while verifying #55): making sure the checkout you run is the code you mean to judge. New **"Run the drill yourself"** block spells out the two versions in play: - **the drill script you run** — clone or refresh a checkout, and `git log --oneline -1` is the drill that will judge; - **the code under test** — the drill doesn't test your working tree; it installs box from GitHub (default `heavy-duty/box@main`) and asserts the installed tree is exactly the ref it asked for before issuing any verdict. `--ref` / `--repo` select a release or a PR branch. Rider: `drill/drill.sh`'s `REPO` default still said `heavy-duty/claudebox` — GitHub redirects it, but the default should name the repo that exists post-rename. 🤖 Generated with [Claude Code](https://claude.com/claude-code)

No reviewers

No milestone

No project

No assignees

1 participant

Notifications

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference: heavy-duty/box#60

No description provided.