Add PRESENTATION.md and update voices/todo notes

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
2026-05-30 06:40:22 +00:00
parent 9d2789c160
commit ecbbaef6bc
3 changed files with 121 additions and 3 deletions

61
PRESENTATION.md Normal file
View File

@@ -0,0 +1,61 @@
# Presenting the Voice Assistant
Notes on how to demonstrate this system effectively.
---
## Core insight
The most compelling demo is an **unscripted real working session** — not a rehearsed script. The system's value is visible when it's actually being used to get things done. A scripted demo flattens the rough edges that make it feel real.
The query journal (when implemented) will make it possible to replay or reconstruct a real session for a recorded demo.
---
## Most interesting things to show
### Voice switching mid-session
Switch between characters and have each one say something in character. The contrast between voices makes the capability concrete. The multi-voice demo scripts in `demos/` are a starting point but an improvised exchange lands better.
### Doing actual work
A real task — adding something to a list, asking a factual question, modifying a file — demonstrates the pipeline end to end. The fact that it works while doing something else (cooking, tidying) is part of the story.
### The classifier working (and not working)
Showing that short fragments don't trigger prematurely, and that send-words like "go" force dispatch, gives a sense of how the pipeline is designed. Showing a case where it misfires, and explaining why, is honest and interesting.
### The "hands-free while doing something else" workflow
If possible, demonstrate speaking while visibly occupied with something physical. This is the use case most people haven't thought about and it's immediately legible.
### The planning capability
This session itself is a good example: several hours of brainstorming, planning, and note-taking without touching a keyboard. The output (TODO.md, VOICES.md, CLEANUP-PLAN.md, WORKFLOWS.md, this file) is the artifact.
---
## What makes a good moment to record
- Natural silence after a query where the system is clearly thinking, then responds
- A voice switch that lands well and sounds good
- A query that gets the classifier right — fragment doesn't dispatch, full sentence does
- An unexpected result from a voice clone that prompts a reaction
- A task that was actually useful, not just a demo task
---
## Things to prepare before a demo
- Voice samples loaded and tested — all voices in `voices.yaml` checked for quality
- TTS server running and warmed up (first response is slow)
- At least one chime configured for acknowledgement
- Silence timeout tuned so it doesn't misfire during normal speech pauses
- A few interesting voice quotes ready to demonstrate character contrast
---
## Framing
The system is not finished. That's fine to say. The interesting thing is that it's **useful now** in its current form, and the direction is clear. Showing the TODO and CLEANUP-PLAN alongside the working demo makes it credible — this is a real project, not a polished proof of concept that's going nowhere.