mirror of
https://github.com/Memo-2023/mana-monorepo.git
synced 2026-05-14 22:21:10 +02:00
Optimize CLAUDE.md based on industry best practices from HN and HumanLayer:
Changes:
- Trim CLAUDE.md from 678 to 176 lines (74% reduction, 5.7KB)
- Add "Critical Gotchas" section for common AI mistakes
- Add verification signature (🏗️ ManaCore Monorepo)
- Create docs/README.md navigation hub with "I want to..." index
- Delete 5 outdated audit files (ENV_AUDIT_*, DEPENDENCY_ALIGNMENT)
- Archive 7 analysis/historical docs to docs/archive/
- Keep authentication docs separate per request (.claude/guidelines/)
Benefits:
- Better AI instruction adherence (within ~150-200 line budget)
- Progressive disclosure via signposting to detailed docs
- Cleaner navigation with topic-based organization
- Reduced maintenance burden (stale docs archived)
Backup: CLAUDE.md.backup preserves original 678-line version
Change log: docs/archive/RESTRUCTURE_2025-12-16.md
|
||
|---|---|---|
| .. | ||
| BACKEND_ARCHITECTURE.md | ||
| CHANGELOG_2025-11-24.md | ||
| DOCKER_SETUP_ANALYSIS.md | ||
| HETZNER_DEPLOYMENT_SUMMARY.md | ||
| PROJECT_OVERVIEW.md | ||
| RESTRUCTURE_2025-12-16.md | ||
| TESTING_IMPLEMENTATION_GUIDE.md | ||
| TESTING_SUMMARY.md | ||