aget-framework/aget-check-kb

/aget-check-kb

Validate the health of the knowledge/ directory by checking structure, file organization, and content freshness.

Purpose

Provide self-diagnostic capability for AGET agents to assess their knowledge base health. Identifies structural issues, missing documentation, and stale content.

Execution

When invoked, perform these checks:

1. Structure Check

# Check if knowledge/ exists
test -d knowledge && echo "exists" || echo "missing"

# List subdirectories
find knowledge -type d -mindepth 1 -maxdepth 1

# Check for README
test -f knowledge/README.md && echo "yes" || echo "no"

2. File Inventory

# Count markdown files
find knowledge -type f -name "*.md" | wc -l

# Count by subdirectory
for dir in knowledge/*/; do
  echo "$dir: $(find "$dir" -type f -name "*.md" | wc -l)"
done

3. Staleness Check

# Find files not modified in 90+ days
find knowledge -type f -name "*.md" -mtime +90 | wc -l

# Find files not modified in 180+ days
find knowledge -type f -name "*.md" -mtime +180 | wc -l

4. Disk Usage

du -sh knowledge

Thresholds

| Metric | OK | WARN | CRITICAL | |--------|-----|------|----------| | KB exists | yes | - | no | | README exists | yes | no | - | | Staleness (90+ days) | <25% | 25-50% | >50% | | Staleness (180+ days) | <10% | 10-25% | >25% |

Note: Research AGET baseline (2026-02-08): 14 files, 96K.

Output Format

=== /aget-check-kb ===

Directory: knowledge/

Structure:
  KB exists:     [yes/no]
  README:        [yes/no]
  Subdirectories: [list]

File Counts:
  Total files:   [count]
  By directory:
    [dir]: [count]
    ...

Staleness:
  >90 days:  [count] ([%])
  >180 days: [count] ([%])

Disk Usage: [size]

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

Health Status Logic

IF kb_missing:
  CRITICAL
ELIF stale_180 > 25% OR stale_90 > 50%:
  CRITICAL
ELIF readme_missing OR stale_180 > 10% OR stale_90 > 25%:
  WARN
ELSE:
  OK

Constraints

• C1: Read-only operation. Never modify files.
• C2: Report staleness as both count and percentage.
• C3: If KB doesn't exist, report CRITICAL but don't fail.

Related Skills

• /aget-check-evolution - Evolution directory health
• /aget-check-sessions - Sessions directory health

Traceability

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

---

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