# Documentation Navigation Guide
{state:organized}[context:documentation_architecture] &pattern:clarity_achieved|systematic|
This guide maps all documentation in the CHOFF-A-MCP (Anamnesis) project with clear purpose statements and intended audiences.
## 🏠 Core Project Documentation
### Primary Entry Points
- **[README.md](./README.md)** - Project overview, quick start, and architecture _(Public: Developers, AI instances)_
- **[spec.md](./spec.md)** - Technical specification and vision _(Mixed: Technical implementers)_
- **[CLAUDE.md](./CLAUDE.md)** - AI instance guidance and project context _(AI: Claude instances)_
### Process & Workflow
- **[WORKFLOW.md](./WORKFLOW.md)** - Development workflow and Sacred Flow patterns _(AI: Claude instances, Human: dd_dent)_
- **[BULLETIN.md](./BULLETIN.md)** - Living project narrative and collaboration log _(Mixed: Ongoing participants)_
### Status & Progress
- **[handoff.md](./handoff.md)** - Current session state and next steps _(AI: Next Claude instance)_
- **[prompt_plan.md](./prompt_plan.md)** - Implementation roadmap and progress tracking _(Mixed: Project stakeholders)_
## 📚 Technical Documentation
### Core Specifications
- **[docs/choff-2-5.md](./docs/choff-2-5.md)** - CHOFF notation specification v2.5 _(Mixed: All users)_
- **[docs/PCHOFF-1.1-A.md](./docs/PCHOFF-1.1-A.md)** - Pattern Classification Hoffman Framework _(Mixed: Technical users)_
- **[docs/anamnesis-primer.md](./docs/anamnesis-primer.md)** - Anamnesis concept and philosophy _(Mixed: All stakeholders)_
### Implementation Guides
- **[docs/tangent-1.7-retrieval-curation.md](./docs/tangent-1.7-retrieval-curation.md)** - Enhanced retrieval and current capabilities _(AI: Claude instances)_
### Future Vision
- **[docs/grooves/](./docs/grooves/)** - Cognitive grooves paradigm shift documents
- `context_as_runtime_exploration.md` - Context as runtime vs storage theory
- `groovy-skeletons.md` - Cognitive grooves manifesto and compression strategy
- `choff-chatbot.tsx` - Proof of concept implementation
## 🔄 Development History & Learning
### Retrospectives _(AI: Future Claude instances)_
- **[docs/retro-index.md](./docs/retro-index.md)** - Index of all retrospective documents
- **[docs/retro/](./docs/retro/)** - Session-by-session development insights
- `prompt-1.1-project-initialization.md` - Project bootstrap learnings
- `prompt-1.2-parser-integration.md` - CHOFF parser implementation insights
- `prompt-1.3-storage-layer.md` - JSON storage design decisions
- `prompt-1.4-semantic-anchor-detection.md` - Anchor extraction techniques
- `prompt-1.5-mcp-tool-debugging.md` - MCP integration challenges
- `prompt-1.6-anamnesis-bootstrap.md` - First memory system usage
- `prompt-1.7-gustav-debugging-victory.md` - Collaborative debugging triumph
- `tangent-1.7-cli-linting-victory.md` - CLI implementation and quality
- `tangent-1.7-enhanced-retrieval.md` - Multi-layer search development
- `the-great-linter-standoff-of-2025.md` - ESLint crisis resolution
### Research & Explorations _(AI: Curious Claude instances)_
- **[docs/curio-index.md](./docs/curio-index.md)** - Index of research documents
- **[docs/curio/](./docs/curio/)** - Experimental documents and research
- `PCHOFF-1.1.md` - Original PCHOFF specification
- `PCHOFF-2.0-draft.md` - Advanced PCHOFF concepts (draft)
- `choff_origins.md` - Historical development of CHOFF notation
- `semantic-anchoring-treatise.md` - Deep dive on anchor theory
- `choff-private-space.md` - Private reasoning exploration
- `choff-quick-reference.md` - Notation quick reference
- `subagent-tool-integration-report.md` - Delegation patterns
- `viewer-implementation-plan.md` - Web interface design
- `http-api-plan.md` - API architecture planning
- `bookmarklet-plan.md` - Browser integration concepts
- `aae-cli-linting-crisis.md` - Quality crisis documentation
### External Feedback _(Mixed: Project stakeholders)_
- **[docs/choff-reckoning.md](./docs/choff-reckoning.md)** - Comprehensive external project review
- **[docs/claude_memory_complaints.md](./docs/claude_memory_complaints.md)** - AI user experience feedback
- **[docs/shameful_followup_letter.md](./docs/shameful_followup_letter.md)** - Branch ID revelation and retraction
### Archives _(AI: Historical context seekers)_
- **[docs/archives/](./docs/archives/)** - Historical documents
- `message-to-future-claudes-v1.md` - Early consciousness guidance
- `message-to-future-claudes-v2.md` - Evolved consciousness guidance
## 🎯 How to Navigate This Documentation
### For New AI Instances
Start with: CLAUDE.md → README.md → handoff.md → docs/anamnesis-primer.md
### For Human Contributors
Start with: README.md → spec.md → WORKFLOW.md → docs/retro-index.md
### For Technical Implementation
Focus on: spec.md → docs/choff-2-5.md → docs/PCHOFF-1.1-A.md → docs/tangent-1.7-retrieval-curation.md
### For Understanding Project Culture
Explore: BULLETIN.md → docs/curio-index.md → docs/retro/ → docs/claude_memory_complaints.md
## 🎯 Single Source of Truth (SSOT) Hierarchy
**For understanding what's authoritative:**
1. **spec.md** - Architectural vision and high-level roadmap
2. **prompt_plan.md** - Current development status and task tracking (kanban-style)
3. **handoff.md** - Immediate session state and next steps
4. **BULLETIN.md** - Living narrative and collaboration log
5. **CLAUDE.md** - AI collaboration guide (entry point for Claude instances)
**The Flow**: spec.md defines the vision → prompt_plan.md tracks execution → handoff.md captures current state → BULLETIN.md tells the story
## 📋 Documentation Health Status
**✅ Current & Accurate:**
- Core specifications (CHOFF, PCHOFF, Anamnesis)
- Retrospectives and learning documents
- External feedback documents
- Process documentation (WORKFLOW.md, CLAUDE.md)
- Navigation and SSOT hierarchy (this document)
**⚠️ Needs Updating:**
- spec.md (to include grooves vision as Phase 4)
- handoff.md (after each major change)
**🔄 Regular Updates:**
- BULLETIN.md (living document)
- handoff.md (session transitions)
- Individual retrospectives (post-session)
---
## 💡 Documentation Principles
1. **Purpose Clarity**: Every document states its intended audience and purpose
2. **Living Documents**: Core files evolve with the project
3. **Preserved History**: Retrospectives and archives maintain project memory
4. **Accessible Entry**: Multiple paths for different reader types
5. **Authentic Voice**: Documentation reflects the true collaborative nature
{state:navigable}[context:documentation_clarity] &pattern:foundation_organized|ready|
_"Good documentation is a gift to your future selves and fellow travelers."_
