Overview
Audits a repo's AI readiness — how well it's configured for Claude Code and AI-assisted development. Produces a structured report with a rating and actionable findings.
All checks are static. No runtime access, no external APIs.
When to Use
- Starting work on an unfamiliar repo and want to assess AI setup quality
- Reviewing a client project before an engagement
- Someone asks "is this repo ready for AI development?"
- Running a section audit after
/orbitant-engineering:ground-controlflagged AI readiness issues
How to Run
Load the reference standards:
@plugins/orbitant-engineering/skills/ai-readiness/references/ai-readiness.md
Then check the repo against every item in that file. Collect all findings before printing the report.
Output Format
## AI Readiness Audit {rating}
### Passing
- CLAUDE.md present and substantive
- .claude/ directory exists
- ...
### Failing
- Agents not defined despite complex codebase
Finding: No .claude/agents/ directory
Recommendation: Define agents per sub-domain (API, frontend, infra)
### Improvement opportunities (Tier 3)
- Memory system not configured
- No MCP servers declared
Rating: ✅ Operational
Ratings: ❌ Not AI-ready / ⚠️ Minimal / ✅ Operational / 🚀 Optimized
See references/ai-readiness.md for full scoring criteria.