fire-reflect

/fire-reflect

Capture, search, and review failure reflections. Reflexion-style self-reflection for cross-session learning.

---

Purpose

After any failure (debug resolution, test failure, approach rotation, stalled loop), capture what was tried, why it failed, and what actually worked as a persistent reflection. Future sessions search these before investigating.

---

Arguments

arguments:
  action:
    required: false
    type: string
    description: "Action to perform: capture (default), search, list, review"
    example: "/fire-reflect capture"

optional_flags:
  --from debug: "Auto-extract from most recent resolved debug session"
  --from session: "Extract from current session context"
  --project <name>: "Tag with project name"
  --severity <level>: "minor | moderate | critical (default: moderate)"
  --search <query>: "Search reflections by keyword/symptom"

---

Process

Step 1: Determine Action

IF args contain "search" or --search:
  → Go to Search Mode (Step 5)
IF args contain "list":
  → Go to List Mode (Step 6)
IF args contain "review":
  → Go to Review Mode (Step 7)
ELSE:
  → Capture Mode (Step 2)

Step 2: Gather Reflection Content

If --from debug:

• Read most recent file in .planning/debug/resolved/
• Extract: symptoms, eliminated hypotheses, root cause, fix applied
• Auto-fill reflection fields

If --from session:

• Review current conversation context
• Identify: failed approaches, what was tried, what worked
• Auto-fill reflection fields

If interactive (default): Ask using AskUserQuestion:

1. What was the problem? — Brief symptom description
2. What did you try that failed? — Each approach and why it didn't work
3. What actually worked? — The solution that resolved it
4. The lesson — One-sentence takeaway for future self
5. Search triggers — When should future agents find this?

Step 3: Generate Reflection File

Create file at ~/.claude/reflections/{date}_{slug}.md: