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. ## Report shape Keep the report concise: - **Executive summary**: readiness, strongest area, main failure mode, first action. - **Repository profile**: scale, languages/frameworks, Git/worktree shape. - **Instruction topology**: canoni...