1.9 KiB
1.9 KiB
Capture QD2 Run Log
Read and follow these instructions after completing a QD2 test run.
1. Save the Raw Log
Copy the most recent JSONL conversation log to this directory:
# Find the most recent conversation log
ls -lt ~/.claude/projects/-Users-alex-src-bmad-quick-flow-redesign/*.jsonl | head -1
# Copy it with the naming convention: YYYY-MM-DD-<short-slug>.jsonl
cp <path-from-above> _experiment/runs/YYYY-MM-DD-<short-slug>.jsonl
The slug should be a few hyphenated words capturing what the run attempted (e.g., eliminate-apc-menu-gates, add-plan-review-to-task01).
2. Summarize the Run
Create a matching .md file with the same name. Use this structure:
# QD2 Run: <Title>
**Date:** YYYY-MM-DD
**Workflow:** quick-dev2 (experimental)
**Branch:** <branch name>
---
## Intent
What was requested? Quote the user's actual words or paraphrase closely.
## Routing
- **Route chosen:** One-shot / Plan-code-review / Full BMM
- **Rationale:** Why did the agent pick this route?
## What Happened
Narrative of what the agent actually did. Focus on:
- Did it follow the workflow plumbing? (config loading, step transitions)
- Did it capture intent correctly?
- Where did it drift, assume, or get things wrong?
- What clarifying questions did it ask (or fail to ask)?
## Diff Produced
Summarize the actual changes made (or note if no changes were made).
## Human Notes
<LEAVE BLANK — human fills this in>
## Observations
Bullet list of patterns, surprises, or insights worth tracking.
3. Get Human Notes
Ask the human: "Any notes on this run? How did it feel, what went wrong, what surprised you?"
Write their response into the Human Notes section verbatim or lightly edited for clarity. Do not summarize away their meaning.
4. Verify
Confirm both files exist:
_experiment/runs/YYYY-MM-DD-<slug>.jsonl_experiment/runs/YYYY-MM-DD-<slug>.md