Original Reddit post

I’d love to get advice from people who are building or maintaining AI-first codebases. In an AI-first repository, what are the best practices for the docs/ directory? More specifically: • What kinds of documents should AI generate and maintain? • Which docs should always exist and be kept up to date? • How do you make sure AI creates documentation at the right time, instead of letting it become an afterthought? • How do you keep docs synchronized with the actual codebase as the project evolves? • What workflows, checks, or review processes do you use to prevent documentation quality from degrading over time? I’m especially interested in practical setups that work in real teams, not just ideal theory. submitted by /u/uskyeeeee

Originally posted by u/uskyeeeee on r/ClaudeCode