📋 Documentation Audit Report

TunaCode documentation inconsistencies identified for cleanup

3
Critical Issues
8
Empty Directories
2
Typos Found

🔴 Critical: Non-Existent Package References

Documentation references packages/directories that don't exist in the codebase.

Document Referenced Path Reality
AGENTS.md src/tunacode/lsp/ Does not exist (only tools/lsp/)
AGENTS.md src/tunacode/indexing/ Does not exist
✅ Fix: Remove these references from AGENTS.md "Source Structure" section

🟠 Warning: Empty Documentation Directories

These directories exist but contain only .gitkeep placeholders or no content.

Directory Status Suggested Action
docs/boundaries/Empty (.gitkeep)Remove or populate
docs/contracts/Does not existRemove from docs/README.md
docs/tests/Empty (.gitkeep)Remove or populate
docs/exceptions/Empty (.gitkeep)Remove or populate
docs/quality-gates/Empty (.gitkeep)Remove or populate
docs/migration/Empty (.gitkeep)Remove or populate
docs/runbooks/Empty (.gitkeep)Remove or populate
docs/adr/Does not existRemove from docs/README.md
✅ Fix: Update docs/README.md to reflect actual structure; remove empty dirs

🟡 Minor: Dead Code Directory

A directory literally named test_dead_code exists in the source tree.

Path Contents Issue
src/tunacode/test_dead_code/ __init__.py, never_imported.py Violates AGENTS.md constraint: "Avoid adding empty directories or __init__.py-only directories"
✅ Fix: Remove the entire directory

🔵 Minor: Typos

File Error Correction
AGENTS.md "Entry Pointis" "Entry Points"
✅ Fix: Correct the typo in AGENTS.md

✅ What's Consistent