# ⚙️ Operational Documentation

> Build, configuration, logging, troubleshooting, reporting, and error handling guides

**Quick Reference:** [Pipeline Orchestration](../RUN_GUIDE.md) | [Troubleshooting](troubleshooting/) | [Logging](logging/) | [Configuration](config/configuration.md)

## Directory Structure

| Sub-directory | Purpose | Key Files |
|---------------|---------|-----------|
| [`build/`](build/) | Build system, dependencies, CI/CD | [README.md](build/README.md), build-system.md, dependency-management.md, ci-cd-integration.md |
| [`config/`](config/) | Configuration, checkpoints, performance | configuration.md, checkpoint-resume.md, performance-optimization.md |
| [`logging/`](logging/) | Logging system (Python, Bash, patterns) | README.md (full guide), python-logging.md, bash-logging.md |
| [`performance/`](performance/) | Benchmarking | README.md, benchmarking-guide.md |
| [`scripts/`](scripts/) | Operational scripts | rotate-logs.sh |
| [`troubleshooting/`](troubleshooting/) | Issue resolution and recovery | README.md (flowchart), common-errors.md, llm-review.md |

## Top-Level Guides

| Guide | Description |
|-------|-------------|
| [reporting-guide.md](reporting-guide.md) | Pipeline reporting system and report interpretation |
| [error-handling-guide.md](error-handling-guide.md) | Error handling patterns and custom exceptions |

## Operations Quick Navigation

| Need | Go to |
|------|-------|
| Pipeline stages and commands | [../RUN_GUIDE.md](../RUN_GUIDE.md) |
| Build / uv / lockfiles | [build/](build/) |
| CI/CD automation | [../../.github/README.md](../../.github/README.md) |
| Fix a build error | [troubleshooting/](troubleshooting/) |
| Configure logging | [logging/](logging/) |
| System configuration | [config/configuration.md](config/configuration.md) |
| Resume a failed pipeline | [config/checkpoint-resume.md](config/checkpoint-resume.md) |
| Optimize performance (config knobs) | [config/performance-optimization.md](config/performance-optimization.md) |
| Benchmark a function/module | [performance/benchmarking-guide.md](performance/benchmarking-guide.md) |
| First time setup? | [config-wizard.md](config-wizard.md) · [CLAUDE.md](../../CLAUDE.md) |
| Deploy with Docker? | [docker.md](docker.md) |
| Incident response? | [runbook.md](runbook.md) |
| Routine maintenance? | [maintenance.md](maintenance.md) |

## See Also

- [Architecture](../core/architecture.md) — System design overview
- [Common Workflows](../reference/common-workflows.md) — Step-by-step recipes
- [FAQ](../reference/faq.md) — Common questions
- [Overview](overview.md) — High-level overview of operations documentation
- [Diagrams](diagrams.md) — Architecture and workflow diagrams

---

> Migrated from `operations/README.md`