Agent Readiness

Assess, harden, scaffold, and diagnose a repository's agent-readiness for coding-agent harnesses (Claude Code, Cursor, Codex, Copilot, Windsurf, Aider). Harness-agnostic and portable-first (AGENTS.md, SKILL.md, MCP, OpenTelemetry). Grounding lives in skill.json; this file is runtime routing only. This is the repo-hardening arm of the agent-experience discipline, which routes here to harden a repo.

Produces: an intent-specific report — assess-report.md, harden-recommendation.md, scaffold-bundle.md, or diagnose-runbook.md. Tracked assessments also emit agent-readiness-findings-ledger-<date>-<slug>.md and agent-readiness-workflow-state-<date>-<slug>.json.

Core principle

Make the repository legible to a stateless, context-bound LLM that must rediscover the project on every turn — through deterministic structure, hand-curated instructions (never autogenerated), executable boundaries, and replayable feedback loops. Three claims recur in every playbook: