Going further: capitalizing solutions across PRs

CLAUDE.md captures behavioral rules. For solved technical problems, a complementary pattern from Every.to's Compound Engineering: a docs/solutions/ directory that turns each non-trivial problem into searchable documentation.

docs/solutions/
├── auth-token-refresh-race-condition.md
├── ios-storekit2-receipt-validation.md
└── kotlin-coroutine-timeout-pattern.md

Each file documents: the problem, the solution, why it works, and edge cases. Claude reads these files when similar patterns appear: the third time a related issue surfaces, the fix is already there. The distinction with CLAUDE.md is intentional: CLAUDE.md contains rules, docs/solutions/ contains solved problems with their full context.