ce-riffrec-feedback-analysis

Turn a Riffrec capture, or a video, audio clip, or meeting notes, into structured product feedback.

Riffrec is a separate capture tool. It records synchronized screen, voice, and events and emits a riffrec-*.zip. This skill is the consumption side: it takes a Riffrec bundle (zipped or unpacked), or a standalone video, audio file, or notes file, and routes it to setup help, a quick bug report, or extensive analysis.

Short text feedback can go straight into /ce-brainstorm. A debug session is /ce-debug. If all you want is a transcript, use a transcription tool.

The skill also activates when an unpacked Riffrec capture appears (session.json, events.json, recording.webm, voice.webm). Pass the capture directory itself, not just recording.webm, so the analyzer keeps the event log and timestamps.

TL;DR

Example invocations

Length and wording pick the path. There is no flag.

# A complete Riffrec zip. Length and event count pick quick vs extensive
/ce-riffrec-feedback-analysis riffrec-2026-05-04-checkout-flow.zip

# Same router for video, audio, or written notes
/ce-riffrec-feedback-analysis demo.mp4
/ce-riffrec-feedback-analysis voice-memo.m4a
/ce-riffrec-feedback-analysis meeting-notes.md

# Force the short path: one bug report in chat, nothing written unless you ask
/ce-riffrec-feedback-analysis just transcribe this clip.mp4

# Longer walkthrough, extract only. Artifacts land, brainstorm does not start
/ce-riffrec-feedback-analysis extract the analysis from checkout-walkthrough.mp4, do not brainstorm

# No recording yet. Install and capture guide, analyzer does not run
/ce-riffrec-feedback-analysis how do I install and use Riffrec?

A Riffrec bundle with no extra wording gets inspected first (duration, event count). If the route is still unclear, the skill asks before doing the heavy work. Better one question than the wrong path.

The Problem

A raw walkthrough does not turn into something you can build from:

• A 12-minute session is too dense to act on as a blob
• Several issues collapse into whichever one gets mentioned first
• A transcript of what was said misses what the person was trying to do
• Raw screen and audio sitting in the repo get committed by accident
• Nothing in the chain consumes the recording as requirements
• The capture tool itself still needs an install path

The Solution

Three paths, chosen from the input:

• Setup when there is no recording yet and the question is how to install, capture, or share. The skill walks the Riffrec install guide. The analyzer does not run.
• Quick bug report when the clip is under ~60 seconds, names a single issue, or asks for “quick”, “small”, or “just transcribe”. One concise bug report, printed in chat. No artifact set, no brainstorm. A file gets written only if you ask.
• Extensive analysis when the recording is longer, covers several issues or a workflow, or you want requirements material. Structured analysis plus screenshots, then a handoff to /ce-brainstorm. Say “extract only” or “analyze, do not brainstorm” to stop after the artifacts.

Raw recordings, audio, zip contents, and extracted frames stay local by default. Text artifacts can be committed when you need them for traceability and they contain no sensitive data.

What Makes It Novel

The path follows the recording

A short single-issue clip should not pay for a requirements package, and a multi-issue walkthrough should not collapse into one ticket. When a zip arrives without context, the skill looks at length and event count before choosing. If a quick-path transcript turns out to hold several issues, it says so and switches to extensive.

Privacy default on the raw bits

raw/ and frames/ never get committed unless you ask and confirm privacy is acceptable. Committed docs use repo-relative screenshot paths, so a later agent can open the evidence without an absolute local path.

One intake, several file shapes

Non-setup runs share one analyzer. It accepts a Riffrec .zip or unpacked capture directory; .mp4 / .mov / .webm video; .m4a / .mp3 / .wav audio; a meeting-notes .md. A Riffrec bundle is richer because events and timestamps come along, but a plain video or voice memo goes through the same router.

In a repo that has docs/brainstorms/, extensive output defaults to docs/brainstorms/riffrec-feedback/ as kickoff evidence. The durable plan still comes from ce-brainstorm under docs/plans/. The quick path writes to a temp directory so a one-issue report does not land in that tree.

Extensive always continues, unless you said not to

The recording is what the user experienced. That is evidence, not a decision. Without brainstorm, the analysis sits on disk and nobody decides what to build. So after the analysis lands, the skill loads /ce-brainstorm with requirements-kickoff.md and asks you to confirm, correct, or regroup the captured requirements. The quick path skips the handoff because the bug report is the deliverable.

Quick Example

A teammate drops riffrec-2026-05-04-checkout-flow.zip into chat.

The analyzer reports 8 minutes, 47 events, several UI surfaces. That is extensive analysis.

It extracts a voice transcript, frames at event boundaries, and an event log. Four issues show up: the “Buy now” CTA hides on mobile, form validation does not surface the error inline, the confirmation email subject is unclear, and a “wait, why did it skip step 3?” moment that points at a flow gap.

The write-up lands under docs/brainstorms/riffrec-feedback/riffrec-2026-05-04-checkout-flow/, with analysis.md, problem-analysis.md, and requirements-kickoff.md among the files. Each issue keeps its frames and timestamps. The raw recording stays local.

The skill then loads /ce-brainstorm on that analysis. Brainstorm asks whether the captured requirements are right, then writes the requirements-only unified plan.

When to Reach For It

Use ce-riffrec-feedback-analysis when:

• A Riffrec capture bundle arrives and you want to act on it
• Someone shares a video, audio clip, or meeting notes as product feedback
• You need the Riffrec install and capture steps
• A long walkthrough needs to become structured input for /ce-brainstorm

Skip it when:

• The feedback is short and already text. Paste it into /ce-brainstorm
• The recording is a debug session, not product feedback → /ce-debug
• You only want a transcript. Use a transcription tool
• You already have a single known bug and a stack trace. Skip the capture skill

Use as Part of the Workflow

This skill is a front door, not a stage in the core loop:

recording → /ce-riffrec-feedback-analysis → (extensive) → /ce-brainstorm → /ce-plan → /ce-work
                                          → (quick)     → bug report in chat
                                          → (setup)     → capture instructions

Extensive analysis is supposed to become a plan. Quick is done when the report is in chat.

Use Standalone

Most invocations are a file path plus optional intent (“just transcribe”, “do not brainstorm”, “how do I install”).

If you already unzipped a capture, pass its directory to keep the synchronized metadata. Passing recording.webm alone still works as standalone video, but drops the event log and other capture context.

Reference

Extensive artifacts (under the output dir): analysis.md, problem-analysis.md, review-prompt.md, source-materials.md, requirements-kickoff.md, plus local-only raw/ and frames/.

The output format the extensive path writes for brainstorm is references/compound-engineering-feedback-format.md.

FAQ

What is Riffrec? A separate capture tool (github.com/kieranklaassen/riffrec). Screen, microphone, console, network, and DOM events in one riffrec-*.zip. This skill does not record. It consumes recordings.

Do I have to use Riffrec? No. Video, audio, and markdown notes take the same paths. A Riffrec bundle is richer because events and timestamps travel with it.

What if the input is ambiguous? The skill inspects length and event count. If that is still unclear, it asks.

See Also

• ce-brainstorm: where extensive analysis is supposed to go
• ce-plan: enriches the unified plan that came from the recording
• ce-debug: when the quick-path report has a clear failure to investigate
• Riffrec: the capture tool (separate project)