CLAUDE.md Validator
Validate the project's CLAUDE.md file for completeness and best practices.
Validation Checklist
Required Sections (Must Have)
- [ ] Project Overview - Brief description
- [ ] Tech Stack - Languages, frameworks, tools
- [ ] Commands - dev, test, build commands
Recommended Sections (Should Have)
- [ ] Conventions - Coding standards
- [ ] Key Files - Important files
- [ ] Architecture - Directory structure
Quality Checks
- [ ] No secrets - No API keys in file
- [ ] Correct commands - Listed commands work
- [ ] Up to date - Matches actual dependencies
Output Format
## CLAUDE.md Validation Report
### Status: PASS / NEEDS IMPROVEMENT / MISSING
### Required Sections
| Section | Status | Notes |
|---------|--------|-------|
| Project Overview | | |
| Tech Stack | | |
| Commands | | |
### Issues Found
1. [Issue and how to fix]
### Suggestions
1. [Improvement]
Auto-Fix
If issues found, offer to:
- Add missing sections with placeholders
- Update tech stack from package.json
- Verify and correct commands