grading-claude-agents-md

# Grading CLAUDE.md and AGENTS.md

Grade agent configuration files, generate improvement plans, and implement fixes.

## Workflow

```
┌─────────────────────────────────────────────────────────────┐
│  1. GRADE          2. PLAN           3. IMPLEMENT          │
│  ─────────         ─────────         ─────────────         │
│  Auto-detect       Show issues       Apply fixes           │
│  files → Score     with fixes →      on approval →         │
│  against rubric    prioritized       verify result         │
└─────────────────────────────────────────────────────────────┘
```

## Quick Start

1. **Detect config files**: Look for CLAUDE.md and/or AGENTS.md in project
2. **Grade each file**: Apply rubric from [references/rubric.md](references/rubric.md)
3. **Generate report**: Score card + prioritized issues + improvement plan
4. **On approval**: Implement changes using [references/improvement-patterns.md](references/improvement-patterns.md)
5. **Verify**: Re-grade to confirm improvements

## Grading Checklist

Copy and track progress:

```
Evaluation Progress:
- [ ] Step 1: Detect CLAUDE.md and AGENTS.md files
- [ ] Step 2: Measure size (lines, bytes, tokens)
- [ ] Step 3: Score Structure (25 pts)
- [ ] Step 4: Score Content Quality (25 pts)
- [ ] Step 5: Score PDA Implementation (25 pts)
- [ ] Step 6: Score Maintainability (25 pts)
- [ ] Step 7: Apply modifiers (±10 pts)
- [ ] Step 8: Generate report with grade
- [ ] Step 9: List improvements with priority
- [ ] Step 10: Ask: "Implement these improvements?"
```

## Score Summary

**Base:** Structure (25) + Content (25) + PDA (25) + Maintainability (25) = 100 pts
**Modifiers:** ±10 pts for bonuses/penalties
**Final:** Capped at 0-100

| Grade | Score | Meaning |
|-------|-------|---------|
| A | 90-100 | Excellent, minimal changes needed |
| B | 80-89 | Good, minor improvements recommended |
| C | 70-79 | Adequate, notable issues to fix |
| D | 60-69 | Poor, significant refactoring needed |
| F | <60 | Critical, major