LLM Codex Readiness Unit Test

Instruction-first, in-session "readiness" for evaluating AGENTS/PLANS documentation quality without any external APIs or SDKs. All checks run against the current working directory (cwd), with no monorepo discovery. Each run writes to .codex-readiness-unit-test/<timestamp>/ and updates .codex-readiness-unit-test/latest.json. Keep execution deterministic (filesystem scanning + local command execution only). All LLM evaluation happens in-session and must output strict JSON via the provided references.

Quick Start

1. Collect evidence:
   • python skills/codex-readiness-unit-test/bin/collect_evidence.py
2. Run deterministic checks:
   • python skills/codex-readiness-unit-test/bin/deterministic_rules.py
3. Run LLM checks using references in references/ and store .codex-readiness-unit-test/<timestamp>/llm_results.json.
4. If execute mode is requested, build a plan, get confirmation, run:
   • python skills/codex-readiness-unit-test/bin/run_plan.py --plan .codex-readiness-unit-test/<timestamp>/plan.json
5. Generate the report:
   • python skills/codex-readiness-unit-test/bin/scoring.py --mode read-only|execute