docs-health

# Documentation Health Check ## Root CLAUDE.md !`wc -l < CLAUDE.md | xargs -I{} echo "Lines: {}"` !`wc -c < CLAUDE.md | xargs -I{} echo "Bytes: {}"` ## Nested CLAUDE.md files !`find internal/ -name CLAUDE.md -exec wc -l {} + 2>/dev/null || echo "None found"` ## Missing CLAUDE.md (directories with 5+ source files but no CLAUDE.md) !`for dir in internal/*/; do count=$(find "$dir" -maxdepth 1 -name '*.go' ! -name '*_test.go' 2>/dev/null | wc -l); if [ "$count" -ge 5 ] && [ ! -f "$dir/CLAUDE.md" ]; then echo "MISSING: $dir ($count source files)"; fi; done` ## Skills (lines per SKILL.md) !`wc -l .claude/skills/*/SKILL.md 2>/dev/null` ## Stale file references in nested CLAUDE.md !`find internal/ -name CLAUDE.md 2>/dev/null | while read cmd; do dir=$(dirname "$cmd"); grep -oE '[a-z_]+\.go' "$cmd" 2>/dev/null | sort -u | while read f; do if [ ! -f "$dir/$f" ]; then echo "STALE: $cmd references $f (not found)"; fi; done; done` ## Guidelines - Root CLAUDE.md: keep under 500 lines - Nested CLAUDE.md: keep under 100 lines each - Skills: load on-demand, size less critical but prefer <150 lines with references/ - If "MISSING" appears above, create a CLAUDE.md for that directory - If "STALE" appears above, fix the reference or remove it --- > Converted and distributed by [TomeVault](https://tomevault.io/claim/air-gapped) — claim your Tome and manage your conversions. <!-- tomevault:4.0:skill_md:2026-04-13 -->