fire-1b-research

/fire-1b-research

Spawn researchers, select architecture vision, generate roadmap

---

Purpose

Research the technology landscape, select a coherent architecture, and generate the project roadmap. This is Step 2 of 3 in project initialization.

Flow: /fire-1a-new → /fire-1b-research → /fire-1c-setup

Prerequisite: .planning/PROJECT.md and .planning/REQUIREMENTS.md must exist (created by /fire-1a-new).

---

EXECUTION ORDER

STEP 1: Validate prerequisites     → PROJECT.md + REQUIREMENTS.md exist
STEP 2: Research Synthesis          → spawn researchers, search GitHub, write SYNTHESIS.md
STEP 3: Vision Branch Selection     → spawn fire-vision-architect, user picks branch, LOCK VISION.md
STEP 4: Roadmap Generation          → spawn fire-roadmapper, write ROADMAP.md
FINAL:  Chain to next command       → tell user to run /fire-1c-setup

Complete each step before starting the next. Each step produces a file — verify it exists before proceeding.

---

Step 1: Validate Prerequisites

test -f .planning/PROJECT.md && test -f .planning/REQUIREMENTS.md && echo "READY" || echo "MISSING — run /fire-1a-new first"

If files are missing, stop and tell the user to run /fire-1a-new first.

Read .planning/PROJECT.md to determine mode (forward/backward) for Step 3.

---

Step 2: Research Synthesis (MANDATORY)

Spawn 4 parallel researchers (or sequential if resources are limited):

Researcher	Focus	Output
STACK	Technology ecosystem, versions, compatibility	research/STACK.md
FEATURES	Feature implementation patterns, complexity	research/FEATURES.md
ARCHITECTURE	Folder structure, data flow, API design	research/ARCHITECTURE.md
PITFALLS	Common mistakes, known issues, anti-patterns	research/PITFALLS.md

Every researcher MUST search GitHub for open source reference projects:

Search for 2-3 real open source projects similar to what the user is building:

• Repo name, stars, last updated
• Tech stack used
• Folder structure patterns
• Key patterns worth adopting
• Mistakes visible in their issues/PRs