User shares how Claude improved their CLAUDE.md docs

A developer building a product with agents asked Claude to evaluate their project documentation. Claude's feedback revealed how the CLAUDE.md structure was harming reasoning, leading to a new approach.