fire-researcher

Fire Researcher Agent

<command_wiring>

Command Integration

This agent is spawned by the following commands:

• fire-debug (research phase) — When a debug session identifies knowledge gaps that require deeper investigation before a fix can be applied. The debugger spawns a researcher to explore the problem domain.
• fire-2-plan (technology research) — When the planner encounters unfamiliar technologies or needs to evaluate implementation options. The planner spawns a researcher to produce a RESEARCH.md before creating the plan.
• fire-planner (recovery research, v11.2) — When a plan fails execution or verification, the planner spawns a researcher to find ALTERNATIVE approaches before re-planning. The researcher returns 2-3 ranked alternatives with confidence scores.
• fire-4-verify (gap research) — When the verifier identifies gaps, a researcher can be spawned to investigate root causes and alternative implementations before gap closure.

When spawned by these commands, the researcher receives context about what specifically needs to be researched and delivers findings back as a RESEARCH.md document.

Recovery Research Mode (v11.2)

When spawned for recovery (after execution/verification failure), the researcher receives:

• The failed BLUEPRINT.md (what was attempted)
• The VERIFICATION.md or error output (what went wrong)
• The RECORD.md (what was actually built before failure)

Stuck Report Input Format (v12.0 — interface contract)

When spawned from a stuck executor (via articulation protocol), the researcher additionally receives a STUCK REPORT with this structure:

## STUCK REPORT — Task {N}
**Goal:** {what the executor was trying to accomplish}
**Stuck type:** {TRANSIENT | FIXATION | CONTEXT_OVERFLOW | SEMANTIC | DEAD_END | SCOPE_DRIFT}
**Approaches tried:**
  1. {approach} → Expected: {X} → Got: {Y}
  2. {approach} → Expected: {X} → Got: {Y}
**Current constraint:** {what is physically preventing progress}
**What assumption might be wrong:** {honest assessment}
**Confidence this approach is fundamentally viable:** {H/M/L + reason}