Skip to content

docs(readme): structure the README with headings and a Reproducing section - #18

Merged
ksdisch merged 1 commit into
mainfrom
docs/readme-hygiene
Aug 4, 2026
Merged

docs(readme): structure the README with headings and a Reproducing section#18
ksdisch merged 1 commit into
mainfrom
docs/readme-hygiene

Conversation

@ksdisch

@ksdisch ksdisch commented Aug 4, 2026

Copy link
Copy Markdown
Owner

Summary

  • Adds ## Results, ## Reproducing, ## Repo map headings over the existing README content — pure reorganization, zero numbers/claims changed, findings-first opening (incl. the honest-framing line) left untouched.
  • New ## Reproducing section documents real entry points: uv run pytest, the committed m1_verdict.pym4_verdict.py scripts (print gate verdicts straight from committed results/*.json, no model/lens/GPU needed), and the milestone runners with --dry-run/--limit, plus recorded per-subject runtimes from the milestone briefs.
  • New ## Repo map table pointing at docs/, the runners, items/, results/, lenses/.

Verification

  • uv run pytest — 396 passed
  • Ran all four verdict scripts (m1_verdict.pym4_verdict.py) as documented — output matches the numbers already in the README.

Review

Docs-only, non-behavioral diff (README reorg only) — trivial-diff escape hatch applies per the global git workflow; skipping the adversarial-review loop.

🤖 Generated with Claude Code

https://claude.ai/code/session_01HdvbHntpNSFw8mZ5Rv62Yk

…ction

Adds ## Results / ## Reproducing / ## Repo map headings over the existing
findings-first content — no wording or numbers changed. The Reproducing
section documents the real entry points (uv run pytest, the committed
m1-m4_verdict.py scripts against results/, and the milestone runners with
--dry-run/--limit), verified to run as written.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HdvbHntpNSFw8mZ5Rv62Yk
@ksdisch
ksdisch merged commit 8b4ed8f into main Aug 4, 2026
@ksdisch
ksdisch deleted the docs/readme-hygiene branch August 4, 2026 19:19
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