Guidance for working on this repo (not for using the skill — that's SKILL.md). The full
contributor guide is CLAUDE.md; the essentials:
python3 tests/test_helpers.py # stdlib, no pytest
python3 tests/validate_schemas.py # needs jsonschema (dev only)
ruff check scripts/ tests/- stdlib-only in
scripts/(no pip deps;jsonschemais tests-only). - Reviewer output is untrusted — don't render it raw or let it build a filesystem path
(
_clean, and_safe_id/_run_dir). The reviewer setsreview_id. - Read-only on the artifact; consent is block-by-default and the codex backend runs hermetic.
- A rejection needs contradicting evidence (schema-enforced); otherwise it's a
deadlockeditem withdispute_kind: unverified_refutation. - Schema change ⇒ add a positive example and a negative fixture in
schemas/examples/invalid/.
See CLAUDE.md for layout, the independence ladder, model selection, and the release flow.