A whole tennis team, one conversation away

flowchart LR
  P["Player or parent"] -->|"talks or types"| APP["Pocket Tennis Team app
local web page"]
  APP -->|"speech to text"| STT["Browser recognition
or on-device Whisper"]
  APP -->|"instant actions:
answers, ticks, notes"| SRV["voice_server.py
127.0.0.1 + secret token"]
  SRV -->|"one job per message"| CL["claude -p
with the plugin"]
  CL --> SK["Skills: coach, setup, log-note,
coach-analysis, weekly-review,
strategy*, tournament*"]
  SK <-->|"read and write"| WS[("Workspace folder
markdown + CSV")]
  SRV -->|"plan data, replies"| APP
  APP -->|"read aloud"| TTS["Best installed voice"]
  HK["SessionStart hook
async"] -->|"starts server,
opens page"| SRV
  WS -.->|"iCloud or Drive sync"| PH["Phone voice memos
into inbox/"]
  

flowchart LR
  subgraph S1["First run · about 5 min"]
    A["Install plugin"] --> B["First Claude session
app opens itself"]
    B --> C["Welcome +
choose folder"]
    C --> D["Who is this for?"]
    D --> E["Coach interview
+ live plan board"]
    E --> F["Team huddle
AI builds plan"]
    F --> G["Plan review
with Why"]
  end
  subgraph S2["Every week"]
    H["Home conversation"] --> I["Practice and matches
logged by voice"]
    I --> J["Sunday check-in
weekly review"]
    J --> H
  end
  subgraph S3["Tournament cycle"]
    K["Add event
overload check"] --> L["Guide + taper week"]
    L --> M["Match cards"]
    M --> N["Debriefs +
event reflection"]
  end
  G --> H
  H --> K
  N --> J
  

sequenceDiagram
  autonumber
  actor P as Player
  participant HC as Head Coach (scripted, instant)
  participant BD as Plan board (local rules)
  participant AI as Team (claude -p, background)
  HC->>P: How long have you played, and what level?
  P->>HC: Eight years, about a 4.0
  HC-->>BD: Level card 4.0
  HC->>P: What's your goal, and by when?
  P->>HC: 4.5 within a year
  HC-->>BD: Goal card 4.0 to 4.5 by Oct 2027
  HC->>P: What loses you the most points?
  P->>HC: Returns, and my second serve
  HC-->>BD: Top priorities: Returns, Second serve (quotes attached)
  HC->>P: Any matches or tournaments coming up?
  P->>HC: Club championship Nov 8
  HC-->>BD: Tournament Coach joins
  HC->>P: When do you play? Anything sore? Who coaches you?
  P->>HC: Tue, Thu, Sat. Knee fine. Coach Maria
  HC-->>BD: Schedule strip, Coach Analyst joins
  HC->>AI: One job with all answers
  Note over P,AI: Team huddle, about 1 min: each member presents their part with a reason
  AI-->>P: Plan review: 1 to 3 focuses, each with Why, target, Looks good / Too much / Change this
  P->>HC: Looks good
  HC-->>P: Home opens on the coach's plan summary
  

sequenceDiagram
  autonumber
  actor P as Player
  participant H as Home
  participant T as Guided template (in page)
  participant Q as Job queue
  participant AI as Team (claude -p)
  participant S as Workspace + store
  H->>P: Today strip: Practice, cue "Short swing, deep middle"
  Note over P: plays the session
  H->>P: Chip appears: How did practice go?
  P->>T: Practice, match or lesson?
  P->>T: How did your one thing go? 6 of 10
  P->>T: What cost you the most points? Return errors
  P->>T: Anything sore? A little, left calf
  T->>P: Review screen with Edit links, then Send
  T->>Q: One note
  Q->>AI: Run (mic stays live)
  AI->>S: Entry, patterns, decision, actions, plan data
  AI-->>H: Reply card: calf first, then 6 of 10 feedback, up to 3 next steps
  S-->>H: Calendar Done, Plan "How it's going", Team "Latest" refresh
  P->>H: Ticks a next step (no AI call)
  

flowchart LR
  A["Add a tournament
name + date chips +
entry deadline + format"] --> B{"Load check
before Add"}
  B -->|"3 weekends in a row,
hours jump over 30%,
logged pain"| W["Heads-up card
add anyway or skip"]
  B -->|"OK"| C["Saved everywhere:
Tournaments, Calendar
all days, Home, Load"]
  W --> C
  C --> D["Guide opens
prep, game plan, match day,
between points, after"]
  D --> E["Entry deadline prompt
5 days before"]
  E --> F["Taper week
lighter, more points,
no new technique"]
  F --> G["Match card
serve plan, return plan,
reset cue, linked to date"]
  G --> H["Match day"]
  H --> I["Debrief per match
score, what worked,
did the plan work?"]
  I --> J["Event reflection
result, best moment,
train next"]
  J --> K["Weekly review
adjusts the plan"]
  

flowchart LR
  A["Welcome"] --> B["Who is this for?
My child"]
  B --> C["Interview about Alex
age band, level, season goals,
tournaments + deadlines,
school + training load,
growth + injury history"]
  C --> D["Hand Alex the mic
Alex, what's your game?"]
  D --> E["Plan board
+ deadlines + load guardrails"]
  E --> F["Team huddle"]
  F --> G["Plan review"]
  G --> H["Family Home"]
  H --> H1["This week's brief"]
  H --> H2["Health and Load"]
  H --> H3["Sideline note"]
  H --> H4["How do I talk about today?"]
  H --> H5["Alex's debrief"]
  

flowchart LR
  M["Tap mic"] --> R{"Better recognition
set up?"}
  R -->|"no"| B["Browser speech-to-text
live words on screen"]
  R -->|"yes"| W["On-device Whisper
primed with tennis words,
player and coach names"]
  B --> C["Clean-up pass
labels to level,
valley to volley"]
  W --> C
  C --> E["Editable transcript
Here's what I heard + Undo"]
  E --> S["Send to the team"]
  S --> A["claude -p
also repairs names
from context"]
  A --> T["Reply on screen"]
  T --> V["Read aloud
best natural voice,
sentence by sentence"]
  

flowchart TB
  subgraph AD["Adult mode"]
    A1["Home
conversation"] --- A2["Plan
goal, roadmap, block, week"] --- A3["Calendar
month and list"] --- A4["Tournaments
guide, cards, played"] --- A5["Team
members, knowledge"]
  end
  subgraph PA["Parent mode"]
    P1["Family Home
conversation + brief"] --- P2["Calendar
+ deadlines, travel"] --- P3["Tournaments
entries, checklist"] --- P4["Health and Load"] --- P5["Team"]
  end
  subgraph OV["Overlays"]
    O1["Onboarding interview"]
    O2["Guided templates"]
    O3["Member panel
settings, knows, teach, sources"]
    O4["Day detail"]
    O5["Settings
voice, recognition, auto-open"]
  end