# Documentation Index

> Quick reference to all project documentation

**Last Updated:** Jan 28, 2026

---

## Core Documents (Read First)

| Document | Purpose |
|----------|---------|
| [CLAUDE.md](../CLAUDE.md) | Project overview, patterns, build protocol |
| [LESSONS.md](LESSONS.md) | Hard-won knowledge, gotchas, patterns |
| [SYSTEM-INTEL.md](SYSTEM-INTEL.md) | Feature status tracker, audit, priorities |
| [BUILD-GUIDE.md](../BUILD-GUIDE.md) | What's been built, changelog |
| [CODEBASE_MAP.md](CODEBASE_MAP.md) | File locations and architecture |

---

## System Status

| Document | Purpose |
|----------|---------|
| [playbook-system-gap-analysis.md](playbook-system-gap-analysis.md) | Playbook implementation status (100% complete) |
| [caching-opportunities.md](caching-opportunities.md) | Performance optimization opportunities |
| [IMPROVEMENTS.md](IMPROVEMENTS.md) | Future improvement ideas |
| [ROADMAP.md](ROADMAP.md) | Feature roadmap |

---

## Feature Plans (Completed)

| Feature | Plan File |
|---------|-----------|
| Dashboard | [dashboard-build-plan.md](dashboard-build-plan.md) |
| Call List | [call-list-prioritization-plan.md](call-list-prioritization-plan.md) |
| Voice Commands | [voice-commands-plan.md](voice-commands-plan.md) |
| Live Intel | [live-intel-plan.md](live-intel-plan.md) |
| Buying Signals | [buying-signals-plan.md](buying-signals-plan.md) |
| SMS Command Center | [sms-command-center-plan.md](sms-command-center-plan.md) |
| Script System | [script-system-plan.md](script-system-plan.md) |
| Messages Hub | [messages-hub-plan.md](messages-hub-plan.md) |
| Gamification | [gamification-0.1-plan.md](gamification-0.1-plan.md) |
| Pre-Call Briefing | [pre-call-briefing-plan.md](pre-call-briefing-plan.md) |
| Voicemail Drop | [voicemail-drop-plan.md](voicemail-drop-plan.md) |
| SMS Sequences | [sms-sequences-plan.md](sms-sequences-plan.md) |
| Personal Intel | [personal-intel-plan.md](personal-intel-plan.md) |
| AI Call Scoring | [ai-call-scoring-plan.md](ai-call-scoring-plan.md) |
| Deal Intelligence | [deal-intelligence-plan.md](deal-intelligence-plan.md) |
| Quality Audit | [quality-audit-upgrade-plan.md](quality-audit-upgrade-plan.md) |
| Self-Improving Intel | [self-improving-intelligence-plan.md](self-improving-intelligence-plan.md) |
| Micro-Optimizations | [micro-optimisation-plan.md](micro-optimisation-plan.md) |

---

## Feature Plans (Ready to Build)

| Feature | Plan File | Effort |
|---------|-----------|--------|
| Intel Search | [intel-search-plan.md](intel-search-plan.md) | 4-6 hrs |
| Intel Tagging | [intel-tagging-plan.md](intel-tagging-plan.md) | 3-4 hrs |
| Competitor Intel | [competitor-intel-plan.md](competitor-intel-plan.md) | 5-7 hrs |
| Industry Trends | [industry-intel-plan.md](industry-intel-plan.md) | 6-8 hrs |
| Push Notifications | [push-notifications-plan.md](push-notifications-plan.md) | 2-4 hrs |
| Weekly Email Report | [weekly-email-report-plan.md](weekly-email-report-plan.md) | 2-4 hrs |

---

## Investigation Reports

| Report | Purpose |
|--------|---------|
| [INVESTIGATION-COPILOT-DATA.md](INVESTIGATION-COPILOT-DATA.md) | Copilot data analysis |
| [INVESTIGATION-PERFORMANCE.md](INVESTIGATION-PERFORMANCE.md) | Performance investigation |
| [messages-investigation-report.md](messages-investigation-report.md) | Messages system analysis |
| [battleground-investigation-report.md](battleground-investigation-report.md) | Battleground analysis |
| [MESSAGING-AUDIT.md](MESSAGING-AUDIT.md) | SMS messaging audit |

---

## Testing & QA

| Document | Purpose |
|----------|---------|
| [TESTING-CHECKLIST.md](TESTING-CHECKLIST.md) | Test checklist |
| [PAGE-BY-PAGE-TEST.md](PAGE-BY-PAGE-TEST.md) | Page-by-page testing guide |
| [messages-test-results.md](messages-test-results.md) | Messages test results |

---

## Build Logs

| Document | Purpose |
|----------|---------|
| [BUILD-SEQUENCE.md](BUILD-SEQUENCE.md) | Build sequence tracker |
| [BUILD-LOG-PERFORMANCE.md](BUILD-LOG-PERFORMANCE.md) | Performance build log |
| [BUILD-ELITE-CALL-UI.md](BUILD-ELITE-CALL-UI.md) | Elite Call UI build |
| [build-order.md](build-order.md) | Build order reference |

---

## Strategy & Vision

| Document | Purpose |
|----------|---------|
| [0.1-PERCENT-TRANSFORMATION-PLAN.md](0.1-PERCENT-TRANSFORMATION-PLAN.md) | 0.1% quality vision |
| [VALUE-PROPOSITION.md](VALUE-PROPOSITION.md) | Product value proposition (110+ features) |
| [SELLABILITY-ROADMAP.md](SELLABILITY-ROADMAP.md) | Sellability roadmap |

---

## User Guides

| Document | Purpose |
|----------|---------|
| [CALLER-GUIDE.md](CALLER-GUIDE.md) | Onboarding guide for Mae, Vena, and new callers |
| [SALES-PLAYBOOK-GUIDE.md](SALES-PLAYBOOK-GUIDE.md) | Sales playbook usage guide |
| [voicemail-drop-guide.md](voicemail-drop-guide.md) | Voicemail drop feature guide |

---

## Integration Docs

| Document | Purpose |
|----------|---------|
| [CLAWDBOT-INTEGRATION.md](CLAWDBOT-INTEGRATION.md) | Telegram bot integration guide |
| [notion-integration-plan.md](notion-integration-plan.md) | Notion business hub integration |
| [clawdbot-notion-skill.md](clawdbot-notion-skill.md) | Clawdbot Notion skill setup |
| [clawdbot-env-template.md](clawdbot-env-template.md) | Environment variables template |

---

## Database & Migrations

| Document | Purpose |
|----------|---------|
| [../supabase/PENDING_MIGRATIONS.md](../supabase/PENDING_MIGRATIONS.md) | Pending DB migrations |
| [../supabase/schema.sql](../supabase/schema.sql) | Core schema |
| [../supabase/ai-schema.sql](../supabase/ai-schema.sql) | AI tables schema |
| [../supabase/learning-schema.sql](../supabase/learning-schema.sql) | Learning system schema |

---

## Potential Bugs (Audit Docs)

| Document | Purpose |
|----------|---------|
| [potential-bugs/](potential-bugs/) | Bug audit documentation |
| [WEAKNESS-FIX-REPORT.md](WEAKNESS-FIX-REPORT.md) | Weakness analysis |

---

## Quick Links

- **Start new session:** Read CLAUDE.md → LESSONS.md → SYSTEM-INTEL.md
- **Find a file:** Check CODEBASE_MAP.md
- **Check feature status:** See SYSTEM-INTEL.md feature tracker
- **Run migrations:** Check supabase/PENDING_MIGRATIONS.md