3.2 KiB
Quick bug report path
Use this path when the input is a short recording (under ~60 seconds), the user describes a single specific issue, or the user explicitly asks for "quick", "small", "simple", or "just transcribe". The goal is one concise bug report, not a multi-artifact requirements package.
Workflow
-
Run the analyzer to a temp directory so nothing pollutes the repo (
SKILL_DIRis the directory containing thece-riffrec-feedback-analysisSKILL.md; set it in the same command — shell state does not persist between Bash calls):SKILL_DIR="<absolute path of the directory containing the ce-riffrec-feedback-analysis SKILL.md>"; python "$SKILL_DIR/scripts/analyze_riffrec_zip.py" /path/to/input --output-dir "$(mktemp -d -t riffrec-quick-XXXXXX)"Capture the printed output directory; later steps read from it.
-
Read only
analysis.mdfrom the temp output. Skipproblem-analysis.md,review-prompt.md,requirements-kickoff.md, andsource-materials.md— they are designed for the extensive path. -
Pick at most one or two screenshots from
frames/that directly show the reported issue. Prefer frames near a verbal complaint, a failed click, a console error, or a failed network request. -
Emit a single concise bug report. Default to printing it inline in the chat so the user can confirm before anything is written to disk. Only write a file if the user asks for one — and even then, prefer a single
bug-report.mdnext to the source recording or in a path the user names. Do not auto-createdocs/brainstorms/...for this path.
Bug report shape
Keep it focused and short. Include only what the recording supports:
- Title — one short sentence naming the broken behavior.
- Steps to reproduce — bullet list reconstructed from clicks and transcript.
- Expected vs. actual — what the user said should happen vs. what happened.
- Evidence — transcript quote(s) with timestamps, plus 0–2 screenshot references.
- Suggested next step — single sentence: file an issue, open
ce-debug, or escalate to extensive analysis if more issues surfaced.
Source mapping (optional, only if obvious)
If the workspace is the product source code AND the broken surface is named clearly in the transcript or visible UI, add one short "Likely surface" line with file path and confidence (High / Medium / Low). Skip this section entirely when the mapping is speculative — speculative mappings belong in the extensive path, not a quick bug report.
What to skip
- No
problem-analysis.md, norequirements-kickoff.md, no Visual / Functional / Requirement / UX category split. - No automatic handoff to
ce-brainstorm. The quick path ends with the bug report. - No commit of
raw/orframes/— they live only in the temp dir and are discarded by the OS. - No source-mapping pass across the codebase.
Escalation
If, while reading the transcript, the recording turns out to contain multiple distinct issues, requirements, or a workflow walkthrough, stop and tell the user: "This recording has more than one issue — switching to the extensive path." Then load references/extensive-analysis.md and re-run the analyzer with a non-temp output directory.