# Documentation Index

## Core Development Guides

| Document | Purpose | Audience |
|----------|---------|----------|
| [`../CLAUDE.md`](../CLAUDE.md) | Claude Code development guide | AI-assisted developers |
| [`../AGENTS.md`](../AGENTS.md) | AI coding constitution v16.0 | All developers |
| [`03_ARCHITECTURE_BE_FE.md`](03_ARCHITECTURE_BE_FE.md) | System architecture (Modular Monolith, Vertical Slice) | Architects, Backend engineers |
| [`06_VIBE_CODING_GUARDRAILS.md`](06_VIBE_CODING_GUARDRAILS.md) | AI work protocols, guardrails | All developers using Claude |
| [`07_VALIDATION_GATES.md`](07_VALIDATION_GATES.md) | Production readiness criteria | QA, Release managers |

## Executive & Planning

| Document | Purpose |
|----------|---------|
| [`00_EXECUTIVE_PROPOSAL.md`](00_EXECUTIVE_PROPOSAL.md) | High-level project rationale |
| [`01_SOURCE_AUDIT.md`](01_SOURCE_AUDIT.md) | Source code assessment |
| [`02_ALGORITHM_REFACTORING.md`](02_ALGORITHM_REFACTORING.md) | Algorithm improvement strategy |

## Tech Debt & Maintenance

| Document | Purpose |
|----------|---------|
| [`../TECH_DEBT_REGISTER.md`](../TECH_DEBT_REGISTER.md) | Tech debt tracking (Impact/Effort matrix) |

## Reference Documents

- `contracts/` — Data and API contracts (UI adapter, schedules, events)
- `templates/` — Vertical Slice, Hangfire job, SQL scaffolds
- `tools/` — Scaffold generators, validators

## Quick Links

**For your first change:**
1. Read [`../CLAUDE.md`](../CLAUDE.md) (setup, build, test)
2. Review [`../AGENTS.md`](../AGENTS.md) decision checklist
3. Check [`03_ARCHITECTURE_BE_FE.md`](03_ARCHITECTURE_BE_FE.md) for module boundaries
4. Reference [`06_VIBE_CODING_GUARDRAILS.md`](06_VIBE_CODING_GUARDRAILS.md) before AI code requests

**For architectural decisions:**
- Module communication: [`03_ARCHITECTURE_BE_FE.md`](03_ARCHITECTURE_BE_FE.md#2-vertical-slice-standard)
- Observability: [`../CLAUDE.md`](../CLAUDE.md#observability)
- Tech debt: [`../TECH_DEBT_REGISTER.md`](../TECH_DEBT_REGISTER.md)

**For validation & release:**
- Gates to pass: [`07_VALIDATION_GATES.md`](07_VALIDATION_GATES.md)
- Readiness checklist: [`../AGENTS.md`](../AGENTS.md#work-decision-checklist)