# Placement map — where things live

audience: AI coding agents first. Verified paths (existence checked 2026-08-08). Read, don't guess.

- `~/Projects/overdeck` — dev repo, SHARED main checkout. NEVER edit there; claim a worktree: `~/.claude/bin/od-worktree add <slug>` → work in `~/Projects/overdeck/.worktrees/<slug>`.
- `~/.local/share/overdeck/deploy` — deploy clone (serves runtime; `packaging/deploy-local.sh` deploys landed origin/main into it, detached checkout). Collector and PATH tools read THIS copy, never the dev checkout.
- `~/.overdeck` — state/reports home.
- `~/.local/share/overdeck` — data home (deploy clone lives under it).
- `~/.local/state/overdeck` — runtime state: systray/harness logs, dispatch, fleet, journals (`actions.jsonl`, `items.jsonl`), backups.
- `~/.claude` — harness config: hooks, `bin/` tools, skills, settings.
- `~/.claude/buildbox-hosts.json` — buildbox registry, single source of host identity/state/spill order. NEVER hardcode a buildbox hostname; read it here.
