Ask HN: How to make a mono-repo AI-Ready?
TL;DR
An org is pushing for AI-readiness across a large monorepo with a shared web platform that other teams use to test new AI tools. The team's working hypothesis: AI-ready basically equals human-ready — a clean, structured codebase with CLAUDE. md files describing correct patterns. They are looking for tools or smarter approaches beyond the usual cleanup to make the codebase easier for AI-assisted contributions.
Nauti's Take
Promising angle: AI-ready really is close to human-ready — clean patterns and well-written CLAUDE. md files help humans and coding agents alike.
The catch is that this discipline rots quickly without automated doc updates and strict boundary tests. Nauti recommends prioritising documentation and test coverage on par with code reviews, otherwise CLAUDE.
md files turn into dead weight.
Summary
An org is pushing for AI-readiness across a large monorepo with a shared web platform that other teams use to test new AI tools. The team's working hypothesis: AI-ready basically equals human-ready — a clean, structured codebase with CLAUDE.
md files describing correct patterns. They are looking for tools or smarter approaches beyond the usual cleanup to make the codebase easier for AI-assisted contributions.
Sources