# What's built and working — relocation mapping (T6 evidence for T13)

Status: done -- docs/ reference set

This file records where every module detail removed from `CLAUDE.md`'s
`## What's built and working` section now lives. It is the audit trail that
T13 checks: **no load-bearing claim was deleted, only relocated.**

Task: T6 (compact `## What's built and working`; relocate per-module detail to
`docs/`, leaving a compact inventory of one-liners + links).

Before: `CLAUDE.md` = 71,446 bytes. After: 57,017 bytes.

## Module → docs destination

| Module / detail removed from CLAUDE.md | Destination docs file |
|---|---|
| `config/schema.sql` (models, proficiency, energy_observations) | `docs/data-model.md` |
| `poller.py` (catalog fetch/normalize/upsert/stale) | `docs/data-model.md` (+ `docs/architecture.md` row) |
| `config/config.yaml` / `src/config.py` | `docs/architecture.md` |
| `scoring.py` (`normalize_inverted` + composite) | `docs/routing.md` |
| `seed_energy.py` (reference sweep → energy_observations) | `docs/architecture.md` |
| `tiering.py` / `tier.py` (tier resolver + DB pass) | `docs/routing.md#tiering` |
| `routing.py` (hard filters + ranking + capability gates) | `docs/routing.md` |
| `circuit_breaker.py` (passive availability skip) | `docs/routing.md#circuit-breaker--circuit_breakerpy` |
| `dispatcher.py` (FastAPI service + endpoints) | `docs/api.md` |
| `proficiency.py` / `proficiency_store.py` | `docs/architecture.md` |
| `events.py` (decision-event broker) | `docs/architecture.md` |
| `leaderboards.yaml` / `leaderboard.py` | `docs/architecture.md` |
| `evals/tasks.yaml` / `eval_proficiency.py` | `docs/evaluation.md` |
| `capabilities.py` (RequestCapabilities detection) | `docs/routing.md` + `docs/architecture.md` |
| `context_prune.py` (pinch) — **retained one-liner T6/T7** | `docs/pinch.md` |
| `logs.py` (trace id, logfmt, journald) | `docs/operations.md` |
| `metrics.py` / `GET /metrics` | `docs/api.md` |
| `tui.py` (Textual dashboard + tui_model) | `docs/architecture.md` |
| `router_cli.py` (one-shot /route probe) | `docs/api.md` |
| `admin.py` / `admin_schema.sql` / `admin/frontend/*.html` | `docs/admin-portal.md` |
| `tests/` (offline suite, 3.10/3.14) | `README.md` |
| Session-directory attribution — **retained one-liner T7**; full heuristic detail | `docs/clients.md#session-directory-attribution-opencode-plugin` (added) |
| Tiering deep-dive (reasoning_default_enabled, cheapness-not-ceiling, tier1_context_max, 4/6/9→1/9/9) | `docs/routing.md#tiering` (added) |
| Why tools/reasoning stay on their signals + fail-closed asymmetry | `docs/routing.md#why-tools-and-reasoning-stay-on-their-existing-signals` (added) |

## Rationale sub-sections relocated

| CLAUDE.md sub-section | Destination |
|---|---|
| Circuit breaker: passive availability skip, and why the eval harness stays outside it | `docs/routing.md#circuit-breaker--circuit_breakerpy` (isolation argument, lines 196-199) |
| Request-side capabilities: why fail-closed is asymmetric | `docs/routing.md` (filters 4-6 + fail-closed asymmetry, lines 12-38) |
| Monitoring: route_decisions persistence | `docs/data-model.md` (lines 209-218) |
| Local Ollama vision fallback | `docs/routing.md#local-vision-fallback` |
| Pass-through capability check | `docs/api.md` + `docs/pinch.md` |
| Serving class (one base model, many rows) | `docs/data-model.md` (lines 11-44) |
| Access gating is prose-only | `docs/data-model.md` (lines 30-44) |
| Tiering (full) | `docs/routing.md#tiering` (added) |
| Why tools and reasoning stay on their existing signals | `docs/routing.md#why-tools-and-reasoning-stay-on-their-existing-signals` (added) |

## Docs files created/extended

- `docs/routing.md` — added `### Tiering` and `### Why tools and reasoning stay on their existing signals`.
- `docs/clients.md` — added `## Session-directory attribution (opencode plugin)`.

## Retained one-liners (still in the compact inventory)

- Pinch bullet → links `docs/pinch.md` (count in CLAUDE.md ≥ 1).
- Session-directory attribution → links `docs/clients.md#session-directory-attribution-opencode-plugin`.