This directory holds durable project documentation. Historical notes are preserved, but they are separated from current source-of-truth docs.
- Architecture: current recording, transcription, mode, PWA, and state flow.
- Project README: product overview, commands, environment, deployment notes.
- Agent notes: short working context for coding agents.
- Testing: current test stack and testing policy.
- The Vault: Passport, encrypted Pi handoff, QR import, and notes mirror.
- Contributing: small-project contribution rules and local checks.
- Support: what to include when reporting app issues.
- Security: private reporting guidance and data-handling notes.
- Next: release status and next moves.
- Glossary: quick names for important components and services.
- Visual style guide: broad visual direction and UI tone.
- Ghost icon reference: canonical ghost implementation notes and troubleshooting.
Research docs are useful for later feature work, but they are not descriptions of shipped behavior unless they explicitly say so.
Archived docs include old audits, handoff notes, stale payment setup, animation refactor notes, branch recovery notes, and past cleanup plans. They are kept for context and archaeology, not for current implementation guidance.