# 📋 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 exist | Remove 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 exist | Remove 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

- Module documentation structure: docs/modules/index.md accurately reflects all 7 layers
- Core layer docs: core/core.md matches actual src/tunacode/core/ structure
- UI layer docs: ui/ui.md accurately documents all UI components
- Dependency layers: DEPENDENCY_LAYERS.md is generated and current
- CSS architecture: docs/ui/css-architecture.md exists with content
- Codebase map: docs/codebase-map/structure/tree-structure.txt exists with content