agentic-readiness

# Agentic Readiness Default to audit-only. Present findings and wait for approval unless the user explicitly asks to implement changes. ## Audit workflow 1. Read the repository's existing instruction chain before inspecting other files. 2. Run from the repository root: ```bash python scripts/audit_repo.py --root . ``` Add `--include-user-scope` only when the user explicitly wants personal Codex, Claude Code, and OpenCode configuration included. Never inspect credential stores or print secret values. 3. Inspect the JSON report and verify findings against the actual build files, scripts, and repository layout. The script detects structural risks; it cannot prove that documented commands or architecture are current. 4. Read the references needed for the task: - [instruction-files.md](references/instruction-files.md) for `AGENTS.md`/`CLAUDE.md` ownership, discovery, routing, compatibility, and CodeAlive lessons learned. - [rubric.md](references/rubric.md) for scoring and priority definitions. - [checklist.md](references/checklist.md) for the full cross-agent audit. - [best-practices.md](references/best-practices.md) for settings, workflows, context, and safety beyond instruction files. 5. Report evidence before recommendations. ### Verify required commands and hooks actually work For required build/test/lint commands and hooks, confirm they execute the intended check in the current environment. A configuration entry, hook file, or successful commit alone is no...