Demo Agent · browser recording · aligned narration
Narrated Product Demos with Coding Agents
A reusable workflow for inspecting a real application, scripting its lesson, and producing a narrated walkthrough with synchronized browser actions and captions.
- Status
- Used in my tutorials · Customer toolkit in preparation
- Period
- September–October 2026
- Role
- Workflow design, runner, tutorial scripting, and export review
- Node.js 22+
- Playwright browser recording
- ElevenLabs timestamped speech
- FFmpeg / FFprobe
- SRT / VTT captions
- Windows
01 / Problem
The problem
A product walkthrough needs narration, browser actions, and result holds to line up. Repeating the whole recording after one failed scene makes corrections expensive.
A polished video still needs to show the real product accurately. Scripting from guessed controls or narrated results that have not appeared undermines the lesson.
02 / Build
What I built
- A director manifest with independent scenes, narration beats, phrase-bound actions, and checks.
- A runner for timestamped speech, browser recording, assembly, captions, and scene-level repair.
- A workflow that asks the coding agent to inspect the application, write the lesson, run the toolkit, and review the resulting media.
- A complete sliding-lid box tutorial recorded against the live LaserBurn AI box generator. Its MP4 and captions are shown on the toolkit preview page.
03 / Decisions
The decisions that mattered
Anyone can list a stack. These are the calls that changed the outcome.
Narration sets the timeline
Spoken phrase timestamps drive browser actions. Unpredictable waits sit outside the timed beats, so the narration follows the result instead of racing ahead of it.
Repair a scene, preserve the rest
Each scene reconstructs its state. A failed capture can be corrected without regenerating all narration or recording every scene again.
The export still needs review
Encoding checks are paired with visual inspection of representative frames, captions, control readability, and timing. The coding agent authors the manifest; the runner does not independently choose the lesson.
04 / Result
Result
duration of the sample box-generator tutorial
1920 × 1080 output at 30 frames per second
independent tutorial scenes in the sample
05 / Next
What I'd do next
- Package portable installation, examples, and setup documentation for the customer toolkit.
- Define the supported version, license, price, and support scope before enabling checkout.