# Deep Dives

Reference documentation for users who want to understand the blueprint deeply, customize beyond the defaults, or learn the reasoning behind each design choice.

For getting started, see the [root README](../README.md) instead.

## Contents

### Start here

- **[WHY.md](WHY.md)**: Battle stories behind each component
- **[PRESETS.md](PRESETS.md)**: Ready-to-copy configurations for solo, team, and CI/CD
- **[ARCHITECTURE.md](ARCHITECTURE.md)**: System design, hook lifecycle, component relationships
- **[SETTINGS-GUIDE.md](SETTINGS-GUIDE.md)**: Every env var, permission, and hook explained with rationale

### Reference

- **[BENCHMARKS.md](BENCHMARKS.md)**: Token cost per component, plan-by-plan breakdown
- **[CROSS-TOOL-GUIDE.md](CROSS-TOOL-GUIDE.md)**: How the patterns map to Cursor, Copilot, Cline, Roo Code, OpenCode, and more (10 other tools)
- **[SELF-MONITORING.md](SELF-MONITORING.md)**: Optional patterns: gitleaks pre-commit + memory-curator agent

### Project

- **[ROADMAP.md](ROADMAP.md)**: Project direction and what's next
- **[CASE-STUDIES.md](CASE-STUDIES.md)**: Adopter stories and before/after metrics (empty by default, submissions welcome)
