brand-research

Input: .design/branding/{brand}/BRIEF.md Output: .design/branding/{brand}/discover/ (4 chunks + INDEX.md) Agent: gsp-researcher

<execution_context> @${CLAUDE_SKILL_DIR}/../../templates/phases/discover.md @${CLAUDE_SKILL_DIR}/../../references/design-trends.md (index only — agent loads specific trend files only after open research validates relevance) @${CLAUDE_SKILL_DIR}/../gsp-style/styles/INDEX.yml </execution_context>

Scan .design/branding/ for brand directories. One brand → use it. Multiple → use AskUserQuestion with one option per brand.

Set BRAND_PATH = .design/branding/{brand}

Read {BRAND_PATH}/BRIEF.md. If missing, tell user to run /gsp:start first. Read {BRAND_PATH}/config.json for brand_mode.

Step 2: Confirm research scope

Load BRIEF.md personas and competitive landscape. If {BRAND_PATH}/audit/ exists, also load audit/evolution-map.md and audit/market-fit.md.

Present a compact research plan, then use AskUserQuestion:

• Looks good — "Start research with this scope"
• Adjust — "I want to add competitors or shift emphasis"

Step 3: Spawn researcher

Spawn the gsp-researcher agent with:

• BRIEF.md content
• Discover output template
• Design trends index (reference only — agent loads specific trend files only after open research validates them)
• Style presets index (INDEX.yml) — agent matches research findings to existing aesthetics
• User-confirmed scope adjustments
• brand_mode from config.json
• Audit chunks if they exist
• Output path: {BRAND_PATH}/discover/

The agent writes 4 chunks + INDEX.md:

1. market-landscape.md
2. competitive-audit.md
3. trend-analysis.md
4. mood-board-direction.md
5. INDEX.md

Step 4: Update state

Update {BRAND_PATH}/STATE.md: set Phase 1 (Discover) to complete.

Step 5: Phase transition

Render phase transition screen, then use AskUserQuestion:

• Continue to strategy — "define positioning, voice, and messaging"
• View progress — "see the full dashboard"
• Done for now — "pick up later with /gsp:start"