Skill Tracer
Skills › Compound Engineering › ce-riffrec-feedback-analysis › quick-bug-report.md

quick-bug-report.md

38 lines · skills/ce-riffrec-feedback-analysis/references/quick-bug-report.md at 3449230

Open on GitHub

Most marks come from matching words in the file, so treat them as pointers.

1# Quick bug report path
2
3Use 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.
4

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.

Raw lines 1 to 4
5## Workflow
6
71. Create `OUTPUT_DIR` with `mktemp -d "${TMPDIR:-/tmp}/riffrec-quick-XXXXXX"`, set `INPUT_PATH` to the supplied capture, and use the invocation in `references/analyzer.md`. Capture the analyzer's printed output directory; later steps read from it.
8
92. Read only `analysis.md` from the temp output. Skip `problem-analysis.md`, `review-prompt.md`, `requirements-kickoff.md`, and `source-materials.md` — they are designed for the extensive path.
113. 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.
134. 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.md` next to the source recording or in a path the user names. Do not auto-create `docs/brainstorms/...` for this path.

Workflow

  1. Create OUTPUT_DIR with mktemp -d "${TMPDIR:-/tmp}/riffrec-quick-XXXXXX", set INPUT_PATH to the supplied capture, and use the invocation in references/analyzer.md. Capture the analyzer's printed output directory; later steps read from it.
  1. Read only analysis.md from the temp output. Skip problem-analysis.md, review-prompt.md, requirements-kickoff.md, and source-materials.md — they are designed for the extensive path.
  1. 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.
  1. 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.md next to the source recording or in a path the user names. Do not auto-create docs/brainstorms/... for this path.
Raw lines 5 to 14
15## Bug report shape
17Keep it focused and short. Include only what the recording supports:
19- **Title** — one short sentence naming the broken behavior.
20- **Steps to reproduce** — bullet list reconstructed from clicks and transcript.
21- **Expected vs. actual** — what the user said should happen vs. what happened.
22- **Evidence** — transcript quote(s) with timestamps, plus 0–2 screenshot references.
23- **Suggested next step** — single sentence: file an issue, open `ce-debug`, or escalate to extensive analysis if more issues surfaced.

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.
Raw lines 15 to 24
Names a skill ce-debug :23
25## Source mapping (optional, only if obvious)
27If 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.

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.

Raw lines 25 to 28
29## What to skip
31- No `problem-analysis.md`, no `requirements-kickoff.md`, no Visual / Functional / Requirement / UX category split.
32- No automatic handoff to `ce-brainstorm`. The quick path ends with the bug report.
33- No commit of `raw/` or `frames/` — they live only in the temp dir and are discarded by the OS.
34- No source-mapping pass across the codebase.

What to skip

  • No problem-analysis.md, no requirements-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/ or frames/ — they live only in the temp dir and are discarded by the OS.
  • No source-mapping pass across the codebase.
Raw lines 29 to 35
Names a skill ce-brainstorm :32
36## Escalation
38If, 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.

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.

Raw lines 36 to 38