# Human Documentation

**Docs written for human readers — end-users and developers.**

---

## Pick Your Path

| You are | Start here | What you'll learn |
|---|---|---|
| **New to Empirica** | [end-users/01_START_HERE.md](end-users/01_START_HERE.md) | Install + first transaction in 5 minutes |
| **Want a plain-English overview** | [end-users/EMPIRICA_EXPLAINED_SIMPLE.md](end-users/EMPIRICA_EXPLAINED_SIMPLE.md) | What Empirica measures and why |
| **Developer integrating AI** | [developers/CLAUDE_CODE_SETUP.md](developers/CLAUDE_CODE_SETUP.md) | Hooks, system prompts, MCP server |
| **Building on Empirica** | [developers/EXTENDING_EMPIRICA.md](developers/EXTENDING_EMPIRICA.md) | Foundation layer + extension patterns |

---

## Folders

### [end-users/](end-users/)

Getting-started guides and conceptual explanations.

- **Setup & install** — project-init, setup-claude-code, troubleshooting
- **Concepts** — the 13 vectors, sessions vs transactions, the measurement model
- **Workflows** — CLI patterns, goal lifecycle, project management
- **Integrations** — BEADS, MCP

### [developers/](developers/)

Technical guides for AI integration + building on Empirica.

- **AI integration** — Claude Code hooks, multi-session learning, self-management
- **Reference** — CLI catalog, MCP server, epistemic health quick reference
- **Building** — foundation layer extensions, skill pipeline, training-export
- **Integrations** — BEADS architecture + git bridge

---

## Key Guides

| Guide | Audience | Purpose |
|---|---|---|
| [Getting Started](end-users/01_START_HERE.md) | Everyone | First-time setup |
| [Empirica Explained Simply](end-users/EMPIRICA_EXPLAINED_SIMPLE.md) | Everyone | Plain-English overview |
| [13 Epistemic Vectors](end-users/05_EPISTEMIC_VECTORS_EXPLAINED.md) | Everyone | The measurement model |
| [Claude Code Setup](developers/CLAUDE_CODE_SETUP.md) | Developers | Plugin + hooks + statusline |
| [CLI Reference](developers/CLI_COMMANDS_UNIFIED.md) | Developers | All commands (see currency disclaimer) |
| [AI Self-Management](developers/AI_SELF_MANAGEMENT.md) | Developers | Self-serve docs + prompt improvement |
| [Multi-Session Learning](developers/MULTI_SESSION_LEARNING.md) | Developers | How knowledge compounds across sessions |

---

## For AI Context

This `human/` tree is written for human readers (developers + end-users).
For AI-readable architectural reference that maps to actual code, see
[../architecture/](../architecture/). For Python API and schema details,
see [../reference/](../reference/).

---

**Website:** [getempirica.com](https://getempirica.com)
