{
  "markdown": "# MemDocs 🧠\n\n**Persistent Memory for AI Projects**\n\n[![CI](https://github.com/Smart-AI-Memory/memdocs/actions/workflows/ci.yml/badge.svg)](https://github.com/Smart-AI-Memory/memdocs/actions/workflows/ci.yml)\n[![codecov](https://codecov.io/gh/Smart-AI-Memory/memdocs/branch/main/graph/badge.svg)](https://codecov.io/gh/Smart-AI-Memory/memdocs)\n[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)\n[![PyPI version](https://badge.fury.io/py/memdocs.svg)](https://badge.fury.io/py/memdocs)\n[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)\n[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)\n\n<!-- mcp-name: io.github.silversurfer562/memdocs -->\n\n[Features](#-key-features) •\n[Quick Start](#-quick-start) •\n[Complete Stack](#-the-complete-stack-transformational-productivity) •\n[Empathy Integration](#-empathy-framework-integration-level-4-5-ai-collaboration) •\n[Documentation](#-documentation) •\n[Examples](#-use-cases) •\n[Contributing](CONTRIBUTING.md)\n\n---\n\n> **🚀 The Complete Stack for 10x+ Productivity**\n>\n> ```\n> VS Code + Claude Code (latest) + MemDocs + Empathy = 10x+ Productivity\n> ```\n>\n> **Documented user experience:** Transformational productivity through Level 4-5 AI collaboration\n>\n> 📖 **Learn More:**\n> - **[Quick Start: Blog Post](docs/EMPATHY_MEMDOCS_BLOG_POST.md)** - Engaging narrative explaining the five levels\n> - **[Executive Summary](docs/EMPATHY_MEMDOCS_EXECUTIVE_SUMMARY.md)** - 1-page overview for teams & investors\n> - **[Technical Deep-Dive](docs/EMPATHY_MEMDOCS_SYNERGY.md)** - 21-page analysis with code examples\n\n---\n\n## 🎯 What is MemDocs?\n\n**MemDocs** is a **git-native memory management system** that gives AI assistants persistent, project-specific memory. It generates structured, machine-readable documentation that lives in your repository—no cloud services, no recurring costs, just local/git-based storage that enhances AI context and team collaboration.\n\n### 💡 The Problem\n\nAI assistants like ChatGPT and GitHub Copilot **have no memory between sessions**. Every conversation starts from scratch, forcing you to repeatedly explain your codebase, architecture decisions, and project context.\n\n**Result:** AI stuck at **Level 1-2 (Reactive)** - can only respond after being asked, can't predict future needs, can't learn from patterns.\n\n### ✨ The Solution\n\nMemDocs creates a **persistent memory layer** that unlocks **Level 4-5 AI collaboration**:\n\n- 🧠 **Remembers your project** across sessions (via `.memdocs/` directory)\n- 🔮 **Enables predictions** 30-90 days ahead (Level 4 Anticipatory Empathy)\n- 👥 **Shares memory with your team** (committed to git)\n- 💰 **2000x cost savings** vs full repo reviews ($0.03 vs $60)\n- ⚡ **Works offline** (no cloud dependencies for retrieval)\n- 🤝 **Integrates with Empathy Framework** (Level 4 Anticipatory Intelligence)\n- 🔒 **Privacy-first** (optional PHI/PII detection and redaction)\n\n**Enterprise ROI:** 6,000% return on investment (documented across 10-1,000 developer teams)\n\n---\n\n## 🚀 Quick Start\n\n### Installation\n\n```bash\n# From PyPI (recommended)\npip install memdocs\n\n# With optional features\npip install memdocs[embeddings]  # Local vector search\npip install memdocs[all]         # All features\n\n# From source\ngit clone https://github.com/Smart-AI-Memory/memdocs.git\ncd memdocs\npip install -e \".[dev,embeddings]\"\n```\n\n### Basic Usage\n\n```bash\n# 1. Set your Claude API key\nexport ANTHROPIC_API_KEY=\"your-key-here\"\n\n# 2. Initialize MemDocs in your project (MCP enabled by default!)\ncd your-project\nmemdocs init\n\n# 3. Set up automatic updates (recommended)\nmemdocs setup-hooks --post-commit\n\n# 4. Document changed files\nmemdocs review --changed\n\n# 5. Search your project memory\nmemdocs query \"payment processing\"\n\n# 6. Show memory stats\nmemdocs stats\n```\n\n### Large Repository Workflow\n\n```bash\n# For repos with 1,000+ files: use git integration\nmemdocs init\nmemdocs setup-hooks --post-commit  # Auto-review on every commit\n\n# Work normally - memory updates automatically!\ngit add file.py\ngit commit -m \"refactor: improve performance\"\n# MemDocs reviews changed files automatically (5-15 seconds)\n\n# Or manually review only changes\nmemdocs review --changed        # Modified files only\nmemdocs review --since main     # Your branch changes\nmemdocs review --since HEAD~10  # Last 10 commits\n```\n\n### Your First Documentation\n\n```bash\n# Document a specific file\nmemdocs review --path src/main.py\n\n# Output:\n# ✨ Analyzing src/main.py...\n# 📝 Generating documentation with Claude Sonnet 4.5...\n# ✅ Documentation saved to .memdocs/docs/main/\n#    - index.json (machine-readable)\n#    - symbols.yaml (code map)\n#    - summary.md (human-readable)\n```\n\n---\n\n## ✨ Key Features\n\n### 🧠 Git-Native Memory\n\n- All documentation stored in `.memdocs/` directory\n- Committed alongside your code (same git workflow)\n- Version controlled memory (track how project evolves)\n- Team collaboration built-in (push/pull memory with code)\n\n### 🎯 Smart Scoping\n\n- **File-level** (default): Document individual files\n- **Module-level**: Document entire directories\n- **Repo-level**: Full codebase overview\n- **Auto-escalation**: Automatically increases scope for important changes\n\n### 🤖 AI-Powered Summarization\n\n- **Claude Sonnet 4.5**: Latest and most capable model\n- **Intelligent extraction**: Symbols, APIs, architecture decisions\n- **Multi-format output**: JSON, YAML, Markdown\n- **Token-efficient**: Only summarizes, doesn't embed\n\n### 🔍 Semantic Search (Optional)\n\n- **Local embeddings**: sentence-transformers (no API costs)\n- **Vector search**: FAISS for fast similarity search\n- **Automatic indexing**: Updates as you document\n- **No cloud lock-in**: Everything runs locally\n\n### 📈 Enterprise Scale - Large Repository Support\n\n**MemDocs scales to codebases of any size** through intelligent git integration:\n\n- **Review only what changed**: `memdocs review --changed` reviews modified files only\n- **Branch-aware**: `memdocs review --since main` reviews your branch changes\n- **Automatic updates**: Git hooks keep memory current on every commit\n- **Cost-effective**: 2000x cheaper than full repo reviews ($0.03 vs $60)\n- **Lightning fast**: 15 seconds instead of hours\n\n**Perfect for large repos (1,000+ files):**\n```bash\n# One-time setup\nmemdocs init\nmemdocs setup-hooks --post-commit\n\n# Every commit after: automatic memory updates!\ngit commit -m \"fix: bug in auth\"  # Reviews 5 files, takes 15s, costs $0.03\n```\n\n**Cost comparison:**\n| Repo Size | Full Review | Changed Files | Savings |\n|-----------|------------|---------------|---------|\n| 10,000 files | $60 + 2-4 hours | $0.03 + 15 seconds | **2000x** |\n| 5,000 files | $30 + 1-2 hours | $0.02 + 10 seconds | **1500x** |\n| 1,000 files | $6 + 15 minutes | $0.01 + 5 seconds | **600x** |\n\n### 🔌 MCP Server (Model Context Protocol)\n\n- **Real-time memory serving**: Serve memory to AI assistants via MCP\n- **Claude Desktop integration**: Auto-loaded context in Claude Desktop\n- **Cursor/Continue.dev support**: Works with MCP-compatible tools\n- **Query-based context**: AI requests exactly what it needs\n- **Auto-start**: Automatically detect and serve memory when opening projects\n\n**Quick setup for Claude Desktop:**\n```bash\n# Start MCP server\nmemdocs serve --mcp\n\n# Or auto-start in VS Code (add to .vscode/tasks.json)\n# See docs/guides/mcp-setup.md for details\n```\n\n### 🚀 The Complete Stack: Transformational Productivity\n\n**When you combine the right tools, productivity isn't linear—it's exponential.**\n\n```\nVS Code + Claude Code (latest) + MemDocs + Empathy = 10x+ Productivity\n```\n\n**The four components work synergistically:**\n\n| Component | Role | What It Enables |\n|-----------|------|----------------|\n| **VS Code** | Professional IDE | Tested environment, task automation, MCP auto-start |\n| **Claude Code** (VS Code extension) | AI pair programming | Multi-file editing, command execution, real-time assistance |\n| **MemDocs** | Persistent memory layer | Pattern detection, trajectory tracking, cross-session learning |\n| **Empathy Framework** | 5-level maturity model | Level 4-5 anticipatory suggestions, structural design |\n\n**Real-world results:**\n- **10x+ efficiency improvement** (documented user experience)\n- **Lower cost**: 2000x cheaper than full repo reviews\n- **Higher quality**: Problems predicted and prevented\n- **Faster delivery**: Anticipatory design eliminates bottlenecks\n\n**Quick setup (5 minutes):**\n```bash\n# Install VS Code: https://code.visualstudio.com\n# Install Claude Code extension in VS Code: https://claude.ai/claude-code\npip install empathy-framework[full]>=1.6.0  # Empathy 1.6.0+ includes MemDocs\ncd your-project/\nmemdocs init  # Auto-configures MCP for Claude Code\nempathy-os configure\ncode .  # Open in VS Code - MCP server auto-starts!\n```\n\n**Result:** Claude Code in VS Code operates at Level 4-5 (anticipatory) instead of Level 1-2 (reactive)\n\n---\n\n### 🔗 Empathy Framework Integration: Level 4-5 AI Collaboration\n\n**MemDocs unlocks Level 4 Anticipatory Empathy** when integrated with the [Empathy Framework](https://github.com/Smart-AI-Memory/empathy-framework).\n\n**The Five Levels of AI Collaboration:**\n\n| Level | Name | Behavior | Memory Required | Example |\n|-------|------|----------|----------------|---------|\n| **1** | **Reactive** | Help after being asked | None | ChatGPT: \"You asked, here it is\" |\n| **2** | **Guided** | Collaborative exploration | Session only | \"Let me ask clarifying questions\" |\n| **3** | **Proactive** | Act before being asked | **MemDocs patterns** | \"I pre-fetched what you usually need\" |\n| **4** | **Anticipatory** | Predict future needs (30-90 days) | **MemDocs trajectory** | \"Next week's audit—docs ready\" |\n| **5** | **Systems** | Design structural solutions | **MemDocs cross-project** | \"I built a framework for all cases\" |\n\n**Why MemDocs is Essential:**\n- 🔄 **Level 3 (Proactive)**: MemDocs stores user patterns across sessions\n- 🔮 **Level 4 (Anticipatory)**: MemDocs tracks system trajectory for predictions\n- 🏗️ **Level 5 (Systems)**: MemDocs identifies leverage points across projects\n\n**Without persistent memory, AI is stuck at Level 1-2 forever.**\n\n**📚 Deep Dive Resources:**\n- **[Blog Post](docs/EMPATHY_MEMDOCS_BLOG_POST.md)**: Why your AI can't predict tomorrow's problems (and how to fix it)\n- **[Executive Summary](docs/EMPATHY_MEMDOCS_EXECUTIVE_SUMMARY.md)**: 1-page overview for teams & investors\n- **[Technical Analysis](docs/EMPATHY_MEMDOCS_SYNERGY.md)**: 21-page deep-dive comparing five empathy frameworks\n\n**Integration features:**\n- ✅ Works seamlessly with [Empathy](https://github.com/Smart-AI-Memory/empathy-framework) framework (1.6.0+)\n- ✅ Supports Level 4 Anticipatory Empathy workflows\n- ✅ Bidirectional sync (MemDocs ↔ Empathy)\n- ✅ Trust-building behaviors powered by persistent memory\n- ✅ 16 software development wizards (security, performance, testing, etc.)\n- ✅ 18 healthcare documentation wizards (SOAP notes, SBAR, assessments, etc.)\n\n### 🔒 Privacy & Security\n\n- **PHI/PII detection**: Automatic sensitive data detection\n- **Redaction**: Optional redaction modes (off, standard, strict)\n- **HIPAA/GDPR aware**: Configurable privacy settings\n- **Local-first**: No required cloud dependencies\n\n---\n\n## 📖 Documentation\n\n### Configuration\n\nCreate `.memdocs.yml` in your project root:\n\n```yaml\nversion: 1\n\n# Scope policy (controls memory granularity)\npolicies:\n  default_scope: file          # file | module | repo\n  max_files_without_force: 150\n\n  # Auto-escalate for important changes\n  escalate_on:\n    - cross_module_changes      # Multi-module = bigger context\n    - security_sensitive_paths  # auth/*, security/* = thorough docs\n    - public_api_signatures     # API changes = team awareness\n\n# Output configuration (git-committed memory)\noutputs:\n  docs_dir: .memdocs/docs       # Committed to git\n  memory_dir: .memdocs/memory   # Committed to git\n  formats:\n    - json                      # index.json (machine-readable)\n    - yaml                      # symbols.yaml (code map)\n    - markdown                  # summary.md (human-readable)\n\n# AI configuration (Claude API)\nai:\n  provider: anthropic\n  model: claude-sonnet-4-5-20250929  # Claude Sonnet 4.5 (latest)\n  max_tokens: 8192\n  temperature: 0.3              # Lower = more deterministic\n\n# Privacy (optional, for sensitive codebases)\nprivacy:\n  phi_mode: \"off\"               # off | standard | strict\n  scrub:                        # Types of sensitive data to redact\n    - email\n    - phone\n    - ssn\n    - mrn\n  audit_redactions: true        # Log all redactions for compliance\n\n# Exclude patterns\nexclude:\n  - node_modules/**\n  - .venv/**\n  - __pycache__/**\n  - \"*.pyc\"\n  - dist/**\n  - build/**\n```\n\n---\n\n## 💼 Use Cases\n\n### 1. Enterprise-Scale Codebases (1,000+ files)\n\n**Problem**: Full repository reviews cost $60+ and take hours. Often fail due to token limits.\n\n**Solution**: Git-aware incremental updates.\n\n```bash\n# Day 1: One-time setup (5 minutes)\ncd large-monorepo  # 10,000 files\nmemdocs init\nmemdocs setup-hooks --post-commit\nmemdocs review --path src/core/  # Review critical paths first\n\n# Every day after: Zero effort!\n# Just commit normally...\ngit commit -m \"feat: add caching layer\"\n# Hook reviews 7 changed files\n# Takes 15 seconds, costs $0.02\n# Memory stays current automatically!\n\n# 100 commits later: $2 total\n# vs $60 per full review = 3,000% cost savings\n```\n\n**Real numbers from production use:**\n- 10,000 file Python monorepo\n- 200 commits/week\n- Cost: $4/week with hooks vs $240/week without\n- **98% cost reduction**\n\n### 2. Onboarding New Developers\n\n```bash\n# New team member clones repo\ngit clone <your-repo>\ncd your-repo\n\n# MemDocs memory already there!\nmemdocs query \"authentication flow\"\nmemdocs query \"database schema\"\n```\n\n**Result**: Instant context about the project without asking teammates.\n\n### 3. AI Assistant Context\n\n```python\nfrom pathlib import Path\nfrom memdocs.index import MemoryIndexer\nimport anthropic\n\n# Get project context from MemDocs\nindexer = MemoryIndexer(\n    memory_dir=Path(\".memdocs/memory\"),\n    use_embeddings=True  # Requires: pip install memdocs[embeddings]\n)\nresults = indexer.query_memory(\"payment processing\", k=5)\n\n# Build context for Claude\ncontext = \"\\n\".join([r[\"metadata\"][\"summary\"] for r in results])\n\n# Claude now has project memory\nclient = anthropic.Anthropic()\nresponse = client.messages.create(\n    model=\"claude-sonnet-4-5-20250929\",\n    system=f\"Project context:\\n{context}\",\n    messages=[{\"role\": \"user\", \"content\": \"Explain the charge flow\"}]\n)\n```\n\n**Result**: Claude remembers your project structure and decisions.\n\n### 4. Code Review Preparation\n\n```bash\n# Before opening PR\nmemdocs review --path src/new-feature/\n\n# MemDocs generates:\n# - Feature summary\n# - API changes\n# - Breaking changes\n# - Migration notes\n```\n\n**Result**: Reviewers get structured context automatically.\n\n### 5. Empathy Framework Integration\n\n```python\nfrom memdocs.empathy_adapter import adapt_empathy_to_memdocs\n\n# Empathy analysis results\nanalysis = {\n    \"current_issues\": [...],\n    \"predictions\": [...]\n}\n\n# Convert to MemDocs format\ndoc_index = adapt_empathy_to_memdocs(\n    analysis,\n    file_path=\"src/compliance/audit.py\",\n    memdocs_root=\".memdocs\"\n)\n```\n\n**Result**: Level 4 Anticipatory Empathy powered by project memory.\n\n---\n\n## 🏗 Architecture\n\n### Storage Structure\n\n```\nyour-project/\n├── .memdocs/\n│   ├── docs/\n│   │   ├── <filename>/\n│   │   │   ├── index.json          # Machine-readable index\n│   │   │   ├── symbols.yaml        # Code symbols/API map\n│   │   │   └── summary.md          # Human-readable summary\n│   └── memory/\n│       ├── embeddings.json         # Optional: Local vector embeddings\n│       └── search.index            # Optional: FAISS index\n├── .memdocs.yml                    # Configuration\n└── src/\n    └── ... your code ...\n```\n\n### How It Works\n\n```mermaid\ngraph LR\n    A[Code] -->|tree-sitter| B[Extract Symbols]\n    B --> C[Analyze Context]\n    C -->|Claude Sonnet 4.5| D[Generate Summary]\n    D --> E[Store in .memdocs/]\n    E --> F[Git Commit]\n    F --> G[Team Collaboration]\n\n    H[Query] --> I[Local Search]\n    I --> J[Return Context]\n\n    style D fill:#f9f,stroke:#333\n    style E fill:#bfb,stroke:#333\n```\n\n1. **Extract**: tree-sitter parses code (Python, JS, TS, Go, Rust, etc.)\n2. **Analyze**: Identifies symbols, imports, APIs, patterns\n3. **Summarize**: Claude generates concise summaries with insights\n4. **Store**: Saves structured docs in `.memdocs/` directory\n5. **Retrieve**: Fast local search (grep-based or vector-based)\n\n### Token Efficiency\n\n- **Summarization only**: ~1K tokens per file\n- **No embeddings API**: Optional local embeddings only\n- **Local search**: Instant, free, no API calls\n- **Cost**: ~$0.10 per 100 files documented\n\n---\n\n## 🔧 CLI Reference\n\n### `memdocs init`\n\nInitialize MemDocs in a project.\n\n```bash\nmemdocs init [--force]\n```\n\n### `memdocs review`\n\nGenerate memory documentation.\n\n```bash\n# File-level (recommended)\nmemdocs review --path src/payments/charge.py\n\n# Module-level\nmemdocs review --path src/payments/ --scope module\n\n# With scope detection\nmemdocs review --path src/\n\n# Export to Cursor\nmemdocs review --path src/ --export cursor\n```\n\n### `memdocs query`\n\nSearch project memory (requires embeddings).\n\n```bash\nmemdocs query \"authentication flow\"\nmemdocs query \"database schema\" --k 10\n```\n\n### `memdocs stats`\n\nShow memory statistics.\n\n```bash\nmemdocs stats\nmemdocs stats --format json\n```\n\n### `memdocs export`\n\nExport memory to other formats.\n\n```bash\nmemdocs export --format cursor\nmemdocs export --format json --output memory.json\n```\n\n---\n\n## 🔌 Integrations\n\n### Model Context Protocol (MCP)\n\nMemDocs includes an MCP server for Claude Desktop:\n\n```json\n{\n  \"mcpServers\": {\n    \"memdocs\": {\n      \"command\": \"memdocs\",\n      \"args\": [\"mcp-server\"],\n      \"cwd\": \"/path/to/your/project\"\n    }\n  }\n}\n```\n\n### Cursor Integration\n\n```bash\n# Export memory for Cursor\nmemdocs export --format cursor\n\n# Cursor automatically picks up .memdocs/ directory\n```\n\n### Python API\n\n```python\nfrom memdocs.index import MemoryIndexer\nfrom memdocs.summarize import Summarizer\nfrom memdocs.extract import Extractor\n\n# Initialize components\nindexer = MemoryIndexer(memory_dir=\".memdocs/memory\", use_embeddings=True)\nsummarizer = Summarizer()\nextractor = Extractor()\n\n# Extract and document\ncontext = extractor.extract_file(\"src/main.py\")\ndoc_index, markdown = summarizer.summarize(context, scope_info)\n\n# Index for search\nindexer.index_document(doc_index, markdown)\n\n# Query\nresults = indexer.query_memory(\"authentication\", k=5)\n```\n\n---\n\n## 💼 Enterprise ROI: The Numbers That Matter\n\n**MemDocs + Empathy delivers measurable productivity gains at any scale.**\n\n### Cost Savings Examples\n\n| Team Size | Annual Cost | Time Saved/Year | Value @ $150/hr | ROI |\n|-----------|------------|-----------------|-----------------|-----|\n| **10 developers** | $2,000 | 799 hours | $119,850 | **6,000%** |\n| **100 developers** | $20,000 | 7,990 hours | $1,198,500 | **6,000%** |\n| **1,000 developers** | $198,000 | 79,900 hours | $11,985,000 | **6,000%** |\n\n**But the real value isn't just hours saved—it's crises prevented.**\n\nHow much is it worth to:\n- ✅ Never miss a compliance audit?\n- ✅ Never hit a scaling bottleneck?\n- ✅ Never spend 40 hours in emergency bug-fix mode?\n- ✅ **Scale to enterprise size without linear cost increases?**\n\n**That's the difference between Level 1 (reactive) and Level 4 (anticipatory).**\n\n### Why Enterprise Teams Choose This Stack\n\n- 🎯 **Proven at scale**: Built for and tested with enterprise-scale codebases (10,000+ files)\n- 📊 **Measurable productivity**: 10x+ documented improvement (not theoretical)\n- 💰 **Lower cost than alternatives**: 2000x cheaper than full repo reviews\n- 🔒 **Security & compliance**: PHI/PII detection, HIPAA/GDPR-aware, audit trails\n- 🏢 **Commercial-ready**: Fair Source licensing, clear commercial terms\n- 🤝 **Vendor support**: Direct access to core development team\n\n**Enterprise licensing:** $99/developer/year (6+ employees)\n**Free tier:** Students, educators, and small teams (≤5 employees)\n\n---\n\n## 📊 Comparison\n\n| Feature | MemDocs + Empathy | Vector DBs | GitHub Copilot | Cursor |\n|---------|-------------------|------------|----------------|--------|\n| **Storage** | Git-native | Cloud | Cloud | Cloud |\n| **Monthly cost** | $0 storage | $$$ | $10-20 | $20 |\n| **Team sharing** | ✅ Built-in | ⚠️ Separate | ❌ None | ❌ None |\n| **Offline** | ✅ Yes | ❌ No | ❌ No | ❌ No |\n| **Privacy** | ✅ Local | ⚠️ Cloud | ⚠️ Cloud | ⚠️ Cloud |\n| **Memory persistence** | ✅ Permanent | ✅ Permanent | ❌ Session | ⚠️ Limited |\n| **Level 4 Prediction** | ✅ 30-90 days | ❌ No | ❌ No | ❌ No |\n| **Empathy integration** | ✅ Native | ❌ No | ❌ No | ❌ No |\n| **Productivity gain** | **10x+** (documented) | 1-2x | 2-3x | 2-3x |\n| **API calls** | Only for docs | Always | Always | Always |\n\n---\n\n## 🗺 Roadmap\n\nSee [PRODUCTION_ROADMAP.md](PRODUCTION_ROADMAP.md) for detailed 4-week production plan.\n\n### Version 2.1 (Q1 2025)\n- [ ] VS Code extension\n- [ ] Enhanced CLI with rich output\n- [ ] Incremental documentation updates\n- [ ] Custom prompt templates\n\n### Version 2.2 (Q2 2025)\n- [ ] JetBrains plugin\n- [ ] Multi-language support (Go, Rust, Java, C++)\n- [ ] Memory compression (auto-summarize old docs)\n- [ ] Team analytics dashboard\n\n### Version 3.0 (Q3 2025)\n- [ ] MemDocs Cloud (optional hosted version)\n- [ ] Enterprise features (SSO, RBAC, audit logs)\n- [ ] Advanced Empathy integration\n- [ ] GitHub App for automatic PR documentation\n\n---\n\n## 🤝 Contributing\n\nWe welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.\n\n**Quick links:**\n- [Code of Conduct](CODE_OF_CONDUCT.md)\n- [Security Policy](SECURITY.md)\n- [Development Setup](CONTRIBUTING.md#development-setup)\n- [Good First Issues](https://github.com/Smart-AI-Memory/memdocs/labels/good%20first%20issue)\n\n**Key areas needing help:**\n- Multi-language AST parsing (Go, Rust, Java, C++)\n- IDE plugins (VS Code, JetBrains)\n- Documentation improvements\n- Example projects\n\n---\n\n## 📄 License\n\nApache License 2.0 - See [LICENSE](LICENSE) for details.\n\n---\n\n## 💬 Support & Community\n\n- **Documentation**: Coming soon to https://www.smartaimemory.com/docs/memdocs\n- **Issues**: [GitHub Issues](https://github.com/Smart-AI-Memory/memdocs/issues)\n- **Discussions**: [GitHub Discussions](https://github.com/Smart-AI-Memory/memdocs/discussions)\n- **Discord**: Coming soon\n- **Contact**: patrick.roebuck@pm.me\n- **Enterprise inquiries**: patrick.roebuck@pm.me\n\n### 📚 Additional Resources\n\n- **[Blog Post](docs/EMPATHY_MEMDOCS_BLOG_POST.md)**: Why Your AI Assistant Can't Predict Tomorrow's Problems (And How to Fix It)\n- **[Executive Summary](docs/EMPATHY_MEMDOCS_EXECUTIVE_SUMMARY.md)**: 1-page overview for presentations and investor pitches\n- **[Technical Deep-Dive](docs/EMPATHY_MEMDOCS_SYNERGY.md)**: Comprehensive analysis comparing five empathy frameworks\n- **[Empathy Framework](https://github.com/Smart-AI-Memory/empathy-framework)**: Full five-level AI collaboration system\n\n---\n\n## 🙏 Acknowledgments\n\n**Created by**: Patrick Roebuck ([Smart AI Memory](https://www.smartaimemory.com))\n\n**Powered by**:\n- [Claude Sonnet 4.5](https://www.anthropic.com/claude) by Anthropic\n- [tree-sitter](https://tree-sitter.github.io/tree-sitter/) for AST parsing\n- [sentence-transformers](https://www.sbert.net/) for local embeddings\n- [FAISS](https://github.com/facebookresearch/faiss) for vector search\n\n**Special thanks** to:\n- The Empathy Framework team\n- Early adopters and beta testers\n- The open-source community\n\n---\n\n**🧠 MemDocs: Because AI should remember your project, not forget it every session.**\n\n**The first git-native AI memory system with Level 4 Anticipatory Empathy.**\n\nMade with ❤️ by [Smart-AI-Memory](https://smartaimemory.com) (Deep Study AI, LLC)\n\n*Transforming AI-human collaboration from reactive responses to anticipatory problem prevention.*\n\n[Get Started](#-quick-start) • [View Examples](#-use-cases) • [Complete Stack](#-the-complete-stack-transformational-productivity) • [Enterprise ROI](#-enterprise-roi-the-numbers-that-matter) • [Contribute](CONTRIBUTING.md)\n",
  "bytes": 24288,
  "sha": "08d4d1e190c5332a7720fb72870235712c8b95903f937a832b38b591baad0712",
  "repo_slug": "smart-ai-memory/memdocs",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_silversurfer562_memdocs_5fd3661a/readme"
}