Engineering an AI-ready code base: Governance lessons from the Red Hat Hybrid Cloud Console

Red Hat's Hybrid Cloud Console team shares how they made their codebase AI-ready by formalizing architectural constraints into machine-readable rules. The approach uses three layers: an AGENTS.md file at the repo root encoding all architectural rules, custom ESLint rules enforcing boundaries (e.g., V1/V2 import isolation, required shared utilities), and 23 structured documentation files. When AI coding assistants (Cursor) automatically ingest AGENTS.md, they follow project-specific rules without guessing. The result: commit throughput jumped from ~12 to 53/month, a 9-month migration touched 5,000+ files, and first-try correctness improved dramatically. The key insight is that good governance for human engineers and good governance for AI assistants are identical — explicit rules, mechanical enforcement, and structured lookup-oriented docs benefit both audiences equally.