# Documentation Index

## Quick Navigation

| I want to... | Go to |
|--------------|-------|
| **Get started with CLI** | [CLI Quickstart](cli/QUICKSTART.md) |
| **Set up MCP server** | [MCP Quickstart](mcp/QUICKSTART.md) |
| **See all CLI commands** | [CLI Reference](cli/REFERENCE.md) |
| **See all MCP tools** | [MCP Tools Reference](mcp/TOOLS.md) |
| **Configure thresholds** | [Configuration](reference/CONFIGURATION.md) |
| **Understand the architecture** | [Architecture Overview](architecture/OVERVIEW.md) |
| **Optimize with caching** | [Cache Subserver](CACHE_SUBSERVER.md) |

---

## Documentation Structure

### Getting Started

| Document | Description |
|----------|-------------|
| [CLI Quickstart](cli/QUICKSTART.md) | Start using CLI in 5 minutes |
| [MCP Quickstart](mcp/QUICKSTART.md) | Set up MCP server for Claude Desktop |
| [Installation Guide](../INSTALL.md) | All installation methods |

### CLI Usage

| Document | Description |
|----------|-------------|
| [CLI Quickstart](cli/QUICKSTART.md) | Basic CLI usage |
| [CLI Reference](cli/REFERENCE.md) | All commands and options |

### MCP Server Usage

| Document | Description |
|----------|-------------|
| [MCP Quickstart](mcp/QUICKSTART.md) | Claude Desktop setup |
| [MCP Tools Reference](mcp/TOOLS.md) | All MCP tools and resources |

### Reference

| Document | Description |
|----------|-------------|
| [Configuration](reference/CONFIGURATION.md) | All configuration options |
| [Cache Subserver](CACHE_SUBSERVER.md) | LRU cache optimization guide |
| [Cache Profiling](cache_profiling_guide.md) | Runtime profiling workflows |

### Architecture

| Document | Description |
|----------|-------------|
| [Architecture Overview](architecture/OVERVIEW.md) | System design and diagrams |

### Development

| Document | Description |
|----------|-------------|
| [Development Guide](../DEVELOPMENT.md) | Setup, testing, make targets |
| [Contributing](../CONTRIBUTING.md) | How to contribute |
| [Changelog](../CHANGELOG.md) | Version history |

---

## By Use Case

### CI/CD Integration
1. [CLI Quickstart](cli/QUICKSTART.md) - Basic setup
2. [CLI Reference](cli/REFERENCE.md) - Exit codes and options
3. [Configuration](reference/CONFIGURATION.md) - Customize thresholds

### AI-Assisted Code Review
1. [MCP Quickstart](mcp/QUICKSTART.md) - Claude Desktop setup
2. [MCP Tools Reference](mcp/TOOLS.md) - Available tools

### Cache Optimization
1. [CLI Quickstart](cli/QUICKSTART.md) - Profile command
2. [Cache Subserver](CACHE_SUBSERVER.md) - Full guide
3. [Cache Profiling](cache_profiling_guide.md) - Profiling workflows

### Custom Configuration
1. [Configuration](reference/CONFIGURATION.md) - All options
2. [Architecture Overview](architecture/OVERVIEW.md) - Config system

---

## Archived Documentation

Development history and planning documents:

- [archive/cache_development/](archive/cache_development/) - Cache subserver development notes
