**Status:** Draft **Mantra:** *Keep your vibe, no interruptions.* ~~*Stop 'catching up' on reading. Start capturing what matters.*~~ ## 1. The Problem Reading is valuable, but logging insights from physical books is filled with friction. Readers must stop their flow to find a pen, open a notes app, or just let the insight fade. Existing "reading" apps focus on social tracking (Goodreads) or heavy-duty digital capture (Readwise), not the _in-the-moment_ experience of reading a physical book. The core problem: **Valuable insights are lost because the cost-of-action in capturing them is too high.** *or* **Why does it take so many clicks to complete a simple task?** ## 2. The Solution (v1 MVP) An Android-first app to capture words and quotes from a physical book as-frictionlessly-as-possible. The app is built around the **"Reading Session."** When a session is active, the app's core functions are available instantly from the lock screen (via a `MediaSession` notification, like a music player). The user never has to unlock their phone, find an app, and navigate a UI. This creates a "non-interruptive" flow, letting the user capture an insight and return to their book in seconds. ## 3. User Stories (v1) - **As a Reader, I want to...** - ...start a "Reading Session" to track my time and enable quick-capture. - ...tap a single button on my lock screen to define a word I'm reading. - ...tap a single button on my lock screen to save a quote by reading it aloud. - ...have the app "read back" the quote it heard so I can confirm its accuracy. - ...have every word and quote I save automatically timestamped and tagged to my current session. - ...end my session and see my total time read automatically logged. - ...browse all words and quotes I've saved, filterable by session/book. ## 4. Key Performance Indicators (KPIs) Our "North Star" is **Activation & Engagement**. We succeed if users who try the app use it consistently. - **North Star KPI:** - **Capture Rate:** (Total Words Defined + Quotes Saved) / Total Active Sessions. This measures if the app's core promise is being used. A high number means we are successfully reducing friction. - **Primary KPIs (v1):** - **W1 Retention:** % of users who start a session in Week 1 who also start a session in Week 2. - **Session Start Rate:** % of users who open the app who successfully start a "Reading Session." - **Lock Screen Capture:** % of all captures that are initiated from the lock screen (validates our core `MediaSession` feature). - **Secondary (Guardrail) Metrics:** - **Quote Accuracy:** % of saved quotes that are _not_ deleted within 24 hours (measures speech-to-text verification quality). - **Session Length:** Average time per active session. ## 5. Phase 1: MVP Timeline Estimate This is a high-level estimate for a small, focused team (e.g., 1-2 engineers). | Phase | Est. Time | Key Tasks | | -------------------------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------- | | **Week 1: Foundations** | 1 Week | - Setup Android project. - Build database schema (Room DB). - Basic UI layout (Compose). | | **Week 2-3: Core Service** | 2 Weeks | - Implement `MediaSession` & `foregroundService`. - Build lock screen controls (Define/Quote). - Implement Session logic (start/stop, timer). | | **Week 4: Capture Flows** | 1 Week | - Integrate `SpeechRecognizer` (word/quote capture). - Integrate `TextToSpeech` (quote verification). - Connect 3rd-party Dictionary API. | | **Week 5: UI & Review** | 1 Week | - Build the "Review" screen (browsing quotes/words). - Onboarding & permissions flow (Notification, Mic). - Internal testing & bug fixing. | | **Week 6: Polish & Ship** | 1 Week | - Final polish. - Prep for Play Store internal test track. | | **Total Estimated Time** | **6 Weeks** | | ## 6. Out of Scope (v2 / Future) To keep v1 focused, we are _not_ building: - Social features (friends, sharing, feeds). - Book search / ISBN scanning (v1 sessions are just text titles). - Advanced reading goals (e.g., "30 mins a day"). - OCR/Camera-based quote capture (more friction than voice). - iOS version (must validate on Android first).