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