| name | readiness-report |
| description | Evaluate how well a codebase supports autonomous AI-assisted development. Analyzes repositories across five pillars (Agent Instructions, Feedback Loops, Workflows & Automation, Policy & Governance, Build & Dev Environment) covering 74 features. Use when users want to assess how agent-ready a repository is. |
Agent Readiness Report
Evaluate how well a repository supports autonomous AI-assisted development.
What this does
Assess a codebase across five pillars that determine whether an AI agent can
work effectively in a repository. The output is a structured report identifying
what's present and what's missing.
Five Pillars
| Pillar | Question | Features |
|---|
| Agent Instructions | Does the agent know what to do? | 18 |
| Feedback Loops | Does the agent know if it's right? | 16 |
| Workflows & Automation | Does the process support agent work? | 15 |
| Policy & Governance | Does the agent know the rules? | 13 |
| Build & Dev Environment | Can the agent build and run the project? | 12 |
74 features total. See references/criteria.md for the full list with
descriptions and evidence examples.
How to run
Step 1: Run the scanner scripts
Five shell scripts gather filesystem signals — file existence, config patterns,
directory structures. They surface what's present so you don't have to run
dozens of find commands manually.
bash scripts/scan_agent_instructions.sh /path/to/repo
bash scripts/scan_feedback_loops.sh /path/to/repo
bash scripts/scan_workflows.sh /path/to/repo
bash scripts/scan_policy.sh /path/to/repo
bash scripts/scan_build_env.sh /path/to/repo
