Skip to content

Latest commit

 

History

History
24 lines (18 loc) · 1.13 KB

File metadata and controls

24 lines (18 loc) · 1.13 KB

AGENTS.md — Impasse (for Codex / agent contributors)

Guidance for working on this repo (not for using the skill — that's SKILL.md). The full contributor guide is CLAUDE.md; the essentials:

Before every commit — all three must pass

python3 tests/test_helpers.py       # stdlib, no pytest
python3 tests/validate_schemas.py   # needs jsonschema (dev only)
ruff check scripts/ tests/

Non-negotiable invariants

  • stdlib-only in scripts/ (no pip deps; jsonschema is 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 sets review_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 deadlocked item with dispute_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.