aget-check-evolution

# /aget-check-evolution

Monitor the health of the `.aget/evolution/` directory by checking file counts, types, naming conventions, and disk usage.

## Purpose

Provide self-diagnostic capability for AGET agents to assess their evolution directory health without supervisor intervention.

## Execution

When invoked, perform these checks:

### 1. File Inventory

```bash
# Count total files
find .aget/evolution -type f | wc -l

# Count by extension
find .aget/evolution -type f -name "*.md" | wc -l
find .aget/evolution -type f -name "*.json" | wc -l
find .aget/evolution -type f ! -name "*.md" ! -name "*.json" | wc -l
```

### 2. Naming Convention Check

Valid L-doc pattern: `L###_*.md` (e.g., `L588_skill_invocation_control_semantics.md`)

```bash
# Count valid L-doc names
find .aget/evolution -type f -name "L[0-9][0-9][0-9]_*.md" | wc -l

# Find non-conforming files (excluding index.json)
find .aget/evolution -type f ! -name "L[0-9][0-9][0-9]_*.md" ! -name "index.json" ! -name "README.md"
```

### 3. Disk Usage

```bash
du -sh .aget/evolution
```

### 4. Index Integrity

Check that `index.json` exists and is valid JSON:

```bash
test -f .aget/evolution/index.json && jq empty .aget/evolution/index.json 2>/dev/null && echo "valid" || echo "invalid"
```

## Thresholds

| Metric | OK | WARN | CRITICAL |
|--------|-----|------|----------|
| Total files | <500 | 500-750 | >750 |
| Non-standard files | 0-10 | 11-50 | >50 |
| Disk size | <10MB | 10-25MB | >25MB |
| Index integrity | valid | - | invalid |

**Note**: Thresholds inherited from supervisor defaults. Research AGET baseline (2026-02-08): 94 files, 800K - well within OK range.

## Output Format

Report the following:

```
=== /aget-check-evolution ===

Directory: .aget/evolution/

File Counts:
  Total:     [count]
  L-docs:    [count] (.md matching L###_*.md)
  Index:     [1 if exists, 0 otherwise]
  Other:     [count] (non-conforming)

Disk Usage: [size]

Index Status: [valid/invalid/missing]

Non-Conforming Files:
  [list any files not matching expected patterns]

Health Status: [OK | WARN | CRITICAL]
Alerts:
  [list any threshold violations]
```

## Health Status Logic

```
IF index invalid OR index missing:
  CRITICAL
ELIF total_files > 750 OR disk > 25MB OR non_standard > 50:
  CRITICAL
ELIF total_files > 500 OR disk > 10MB OR non_standard > 10:
  WARN
ELSE:
  OK
```

## Constraints

- **C1**: Read-only operation. Never modify files.
- **C2**: Report ALL findings, even if status is OK.
- **C3**: List non-conforming files by name for actionability.

## Related Skills

- `/aget-check-sessions` - Sessions directory health
- `/aget-check-kb` - Knowledge base health
- `/aget-record-lesson` - Capture findings as L-docs

## Traceability

| Link | Reference |
|------|-----------|
| POC | POC-017 |
| Project | PROJECT_PLAN_AGET_UNIVERSAL_SKILLS.md |
| Source | Fleet Skill Deployment Report (supervisor) |
| Baseline | 94 files, 800K (2026-02-08) |

---

*aget-check-evolution v1.0.0*
*Category: Monitoring*
*POC-017 Phase 1*