---
name: HANDOVER and root README pointer
type: architecture-map-page
slice: 05-core-storage-hotkey-build
last_verified: 2026/05/09
---

# `HANDOVER.md` and root `README.md` pointer

> **Where you are:** [Architecture map](../README.md) → [Core, Storage, Hotkey, Build](README.md) → Handover and README pointer

**Plain English summary.** Two human-facing documents at the repo root: `HANDOVER.md` (the live session-handover note Jake reads at the start of each session) and `README.md` (the standing project README). This page does not duplicate either — it just points readers in the right direction.

## `HANDOVER.md` (repo root)

- File: `HANDOVER.md` (~11 KB).
- Purpose: end-of-session handover. Captures what shipped, what is in flight, what to do next session, and the open release-blockers.
- Status as of 2026/04/25: Phase 9 (LLM content tags + bulk export) mostly shipped. One open MAJOR (RB-08, macOS power assertion) gates v0.1 tagging.
- **Drift watch:** `HANDOVER.md` records schema head as v14 (the migration that landed in that session). Migration v15 (`idx_transcripts_profile_created`) has since landed on disk; the next handover should reflect head = v15. Tracked in [`README.md`](README.md) of this slice.

The handover is the source of truth for "what state is this project actually in right now". Read it first when picking up the project after a break. Do not transcribe it into the architecture map.

## `README.md` (repo root)

- File: `README.md` (~24 KB).
- Purpose: standing project README for a contributor or curious reader. Covers what Lumotia is, why it exists, quick-start instructions, the `lumotia-` crate map, the rebrand history (Lumotia / Lumenote), and pointers into the documentation.
- Audience: external. The architecture map is internal.

The architecture map (this slice) is the implementation-level reference; the README is the introduction.

## Other reference docs in `docs/`

- `docs/audit/phase0-cartography.md` — earlier crate-graph cartography.
- `docs/audit/phase1-lean-pass.md` — phase-1 lean pass findings.
- `docs/audit/phases-1-8-playbook.md` — playbook for the multi-phase audit.
- `docs/code-review-2026-04-22.md` — the full audit findings, source of every RB-N reference.
- `docs/dev-setup.md` — local development setup notes.
- `docs/handovers/HANDOVER-2026-04-24.md` — archived handover from 24 April.
- `docs/issues/*` — critical-issue write-ups. See [`README.md`](README.md) of this slice for the slice-5-relevant ones.
- `docs/roadmap/*` — feature roadmaps.
- `docs/superpowers/*` — design specs and audit specs (the most recent specs are the source of truth for current direction).
- `docs/whisper-ecosystem/*` — research notes on the Whisper / Parakeet / Moonshine ecosystem.

## See also

- [Slice 5 README](README.md)
- [Code review 2026-04-22](../../code-review-2026-04-22.md)