helix-parallel

Helix Parallel Research

⚠️ DEPRECADO (v6.2): Este command é mantido para compatibilidade. USE: audience-research-agent como entry point único para pesquisa. Ver ~/.claude/WORKFLOW-CANONICO.md para o fluxo recomendado.

Quando usar este command:

• Casos específicos onde você precisa controle granular sobre os 4 tasks
• Debugging de módulos individuais
• Para todos os outros casos, use audience-research-agent

Execute parallel research for offer: $ARGUMENTS

IMPORTANTE (v4.3): Todos os tasks usam subagent_type: general-purpose para garantir acesso aos MCPs (Apify, Firecrawl, Playwright). Custom types como researcher NÃO herdam MCPs.

Extended Thinking Bifásica (v6.1) ⚠️ NOVO

Fonte: ~/.claude/rules/briefings-helix.md v6.1

Fase Research	Extended Thinking	Budget
VOC Research	ON	10-16K
Competitor Analysis	ON	10-16K
Mechanism Research	ON	10-16K
Avatar Profiling	ON	10-16K
Synthesis	ON	10-16K

Todos os tasks de research usam Extended Thinking ON para análise profunda.

Templates Disponíveis (v6.1)

Para fases posteriores (HELIX briefing), usar:

• ~/.claude/templates/mup-mus-discovery.md → Fases 5-6 (MUP/MUS)
• ~/.claude/templates/rmbc-ii-workflow.md → Fases 7-10 (VSL structure)

Pre-Flight Check

Before starting, verify:

# 1. Check offer directory exists
ls ~/copywriting-ecosystem/*/$ARGUMENTS/ 2>/dev/null || echo "CREATE DIRECTORY FIRST"

# 2. Check task_plan.md exists
cat ~/copywriting-ecosystem/*/$ARGUMENTS/task_plan.md 2>/dev/null || echo "RUN /plan FIRST"

If directory doesn't exist, create it:

~/copywriting-ecosystem/create-offer.sh "[nicho]" "$ARGUMENTS"

Create Research Subdirectories

mkdir -p research/$ARGUMENTS/{voc,competitors,mechanism,avatar}/{raw,processed}

Parallel Execution (Fan-out)

Launch 4 research tasks SIMULTANEOUSLY:

---

Task 1: VOC Research

Use Task tool with subagent_type: general-purpose

PROMPT:
"Você é um specialist em VOC extraction para copywriting de Direct Response.

OFFER: $ARGUMENTS

FERRAMENTAS DISPONÍVEIS (USAR OBRIGATORIAMENTE):
- mcp__apify (YouTube, Instagram, TikTok comments)
- mcp__firecrawl (landing pages, reviews)
- mcp__playwright (Meta Ads Library, sites com login)

VOC QUALITY PROTOCOL:
1. Apify Actor específico PRIMEIRO
2. Playwright se Apify falha
3. Firecrawl se Playwright falha
4. WebSearch APENAS como ÚLTIMO RESORT

TAREFA: Extrair VOC autêntico de YouTube, Instagram, TikTok, Reclame Aqui, Mercado Livre
OUTPUT: research/$ARGUMENTS/voc/
FOCO: Pain points (viscerais), desires, objections, language patterns verbatim
LIMITE: 100 quotes por plataforma
ESTRUTURA:
- raw/ → dados brutos por fonte
- processed/ → pain-points.md, desires.md, objections.md, language-patterns.md
- summary.md → ≤500 tokens com key findings
"