🤖 ai-ready — Repository AI-Readiness Auditor & Agent Engine Scaffolder

Aliases: repo-ai-ready | audit-ai-ready | ai-audit Canonical Home: Holds the master Agent Engine DOX templates (ai-ready/templates/). Core Mandate: Eliminate agent guessing, guarantee zero token waste via Stage-0 Fast-Skip, and provide autonomous Agent Engine scaffolding.

ai-ready audits any software repository against 13 tracked assets across AI Context, Dev Workflow, and Onboarding & Governance. It grades repositories across a 4-tier maturity matrix, houses the master Agent Engine DOX template canon, and surgically scaffolds missing configuration files without clobbering existing human work.

When to Use

• User asks: "Make this repo AI-ready", "Audit AI readiness", "Check repo health", "Scaffold Agent Engine", or "How AI-ready is this repo?".
• Invoked automatically as Stage 0 Pre-Flight inside new-project and updateagents.
• Upstream template canon provider for new-project (copying templates) and updateagents (synchronizing standards).
• Onboarding an existing codebase into autonomous AI workflows.
• Auditing whether an existing project suffers from context drift, missing templates, or unwritten conventions.
• Mining merged Pull Request reviews to surface implicit team conventions into explicit agent instructions.
• Onboarding-tour requests ("explain this codebase to a new developer", "give me a codebase tour") → run the Structural / Layering pass in onboarding mode (explains, never diagnoses).