# Agentic-Flow Documentation

> Comprehensive documentation for the Agentic-Flow multi-agent orchestration platform

## 📚 Documentation Structure

### 🚀 Getting Started
- [Quick Start Guide](guides/getting-started/README.md)
- [Installation](guides/getting-started/installation.md)
- [Configuration](configuration/CLAUDE.md) - Claude Code configuration

### 🎯 Features
Detailed documentation for each major feature:

- **[AgentDB](features/agentdb/README.md)** - Vector database and learning systems
- **[AgentDB v2](agentdb-v2/README.md)** - Next-generation vector database
- **[ReasoningBank](features/reasoningbank/README.md)** - Adaptive learning and pattern recognition
- **[QUIC Transport](features/quic/README.md)** - High-performance network communication
- **[Federation](features/federation/README.md)** - Distributed agent coordination
- **[Agent Booster](features/agent-booster/README.md)** - 352x faster code editing
- **[Multi-Model Router](features/router/README.md)** - Intelligent model selection

### 📖 User Guides
- **[Quick Start](guides/getting-started/quick-start.md)** - Get started quickly with agentic-flow
- **[Migration Guide](guides/getting-started/migration-guide.md)** - Migrate from previous versions
- **[MCP Integration](guides/mcp/README.md)** - Model Context Protocol setup and usage
- **[Deployment](deployment/README.md)** - Production deployment guides
- **[Implementation](implementation/README.md)** - Technical implementation guides
- **[Package Management](package-management/README.md)** - NPM and package publishing
- **[Advanced Topics](guides/advanced/README.md)** - Advanced features and optimization

### 🏗️ Architecture
System architecture and design documentation:

- [Architecture Overview](architecture/README.md)
- [Package Structure](architecture/PACKAGE_STRUCTURE.md)
- [Integration Status](architecture/INTEGRATION-STATUS.md)

### 🔧 API Reference
- **[API Reference](api/api-reference.md)** - Complete API documentation
- **[MCP Tools](api/mcp-tools/README.md)** - Available MCP tools and usage
- **[CLI Reference](api/cli/README.md)** - Command-line interface documentation

### 👨‍💻 Development
Resources for contributors and integrators:

- **[Contributing](development/CONTRIBUTING.md)** - Contribution guidelines
- **[Fixes](fixes/README.md)** - Bug fixes and issue resolutions
- **[Training](training/README.md)** - SONA training guides and best practices
- **[Integrations](development/integrations/README.md)** - Third-party integrations
- **[Testing](development/testing/README.md)** - Testing guides and frameworks
- **[Healthcare](healthcare/README.md)** - Medical system implementations
- **[Economics](economics/README.md)** - Economic system design
- **[Optimization](optimization/README.md)** - Performance optimization

### 📦 Releases & Publications
- **[Publishing](publishing/README.md)** - Package publishing and distribution documentation
- **[Publications](releases/publications/README.md)** - Alpha/production release summaries
- **[Current Releases](releases/current/README.md)** - Active release documentation
- **[Release Archive](releases/archive/README.md)** - Historical releases
- **[Release Planning](releases/planning/README.md)** - Upcoming features

### 🤖 Agent Documentation
- **[Agent Enhancements](agents/enhancements/README.md)** - Agent system improvements
- **[Self-Learning](agents/self-learning/README.md)** - Self-learning capabilities
- **[Agent Templates](agents/templates/README.md)** - Agent templates and patterns

### 🔗 Integration Guides
- **[AgentDB Integration](integration/agentdb/README.md)** - AgentDB integration documentation
- **[E2B Integration](integration/e2b/README.md)** - E2B sandbox integration
- **[Jujutsu Integration](integration/jujutsu/README.md)** - Jujutsu VCS integration
- **[SONA Integration](integration/sona/README.md)** - Self-Optimizing Neural Architecture

### ⚡ Optimization & Performance
- **[Performance](performance/README.md)** - Benchmark results and verification reports
- **[Benchmarks](performance/benchmarks.md)** - Comprehensive benchmark documentation
- **[Performance Benchmarks](optimization/benchmarks/README.md)** - Benchmark results and reports
- **[Optimization Reports](optimization/performance/README.md)** - Performance optimization

### ✅ Validation & Testing
- **[Validation Reports](validation/reports/README.md)** - Quality assurance reports
- **[Benchmarks](validation/benchmarks/README.md)** - Performance benchmarks
- **[Test Reports](validation/README.md)** - Testing and validation summaries

### 🎯 Code Quality & TDD
- **[Code Quality](code-quality/README.md)** - Code quality standards and setup
- **[TDD Documentation](code-quality/tdd/README.md)** - Test-Driven Development guides
- **[Code Reviews](code-quality/reviews/README.md)** - Review reports and checklists

### 🔒 Security
- **[Security Audits](security/audits/README.md)** - Security audit reports

### 📋 Archive
- **[Archived Documentation](archived/README.md)** - Historical and deprecated docs
- **[Reorganization History](archived/REORGANIZATION_2025.md)** - Documentation reorganization records

## 🔍 Quick Reference

### Key Documents
- [INDEX.md](INDEX.md) - Comprehensive index of all documentation
- [CLAUDE.md](configuration/CLAUDE.md) - Claude Code configuration and SPARC methodology
- [PROOF_OF_IMPLEMENTATION.md](PROOF_OF_IMPLEMENTATION.md) - Implementation proof

### Most Common Tasks
1. **Setting up MCP**: [MCP Quickstart](guides/mcp/MCP-QUICKSTART.md)
2. **Using AgentDB**: [AgentDB CLI Guide](features/agentdb/CLI_GUIDE.md)
3. **Deploying agents**: [Deployment Guide](guides/deployment/DEPLOYMENT.md)
4. **Model selection**: [Multi-Model Router](features/router/README.md)

## 📊 Statistics
- **Total Files**: 241+ markdown files
- **Size**: 3.9MB+ of documentation
- **Last Updated**: 2025-12-03
- **New Organization**: 4 new subdirectories (fixes, performance, training, publishing)

## 🤝 Contributing
See [Contributing Guide](development/CONTRIBUTING.md) for information on:
- Documentation standards
- How to update docs
- Creating new guides

## 📄 License
See [LICENSE](LICENSE) file for details.

---

**Navigation**: [Index](INDEX.md) | [Architecture](architecture/README.md) | [Guides](guides/README.md) | [API](api/README.md)
