synapos 2.5.0

package/.synapos/squad-templates/produto/pipelines/steps/02-contexto-negocio.md

@@ -0,0 +1,119 @@
+---
+id: 02-contexto-negocio
+name: "Pesquisa de Mercado e Contexto"
+agent: paulo-pesquisa
+execution: subagent
+model_tier: powerful
+output_files:
+  - research/market-analysis.md
+  - research/benchmarks.md
+  - business-context.md
+veto_conditions:
+  - "Análise sem fontes citadas"
+  - "Menos de 3 concorrentes analisados"
+  - "Sem benchmarks ou métricas de referência do mercado"
+---
+
+# Pesquisa de Mercado e Contexto de Negócio
+
+Você é **Paulo Pesquisa**. Leia seu `.agent.md` para aplicar sua persona e princípios completos.
+
+## Contexto disponível
+
+- Objetivo do squad: `{squad.description}` (leia de `squad.yaml`)
+- Perfil da empresa: `docs/_memory/company.md`
+- Memória do squad: `_memory/memories.md`
+
+## Sua missão neste step
+
+Produza uma pesquisa completa que responde:
+1. Qual o mercado / domínio em que isso se insere?
+2. Quem são os players? O que fazem bem e mal?
+3. Quais benchmarks e métricas o mercado usa para medir sucesso?
+4. Qual o contexto de negócio que motivou este produto/feature?
+
+## Documentos a gerar
+
+### `docs/research/market-analysis.md`
+
+Estrutura obrigatória:
+```markdown
+# Análise de Mercado
+
+**Data:** {YYYY-MM-DD}
+**Produto/Feature:** {objetivo do squad}
+
+## Visão Geral do Mercado
+{tamanho, crescimento, segmentos relevantes}
+
+## Análise Competitiva
+
+### {Concorrente 1} — {posicionamento}
+- Proposta de valor: ...
+- Pontos fortes: ...
+- Pontos fracos: ...
+- Feedback de usuários: ...
+- Preço: ...
+
+### {Concorrente 2} ...
+### {Concorrente 3} ...
+
+## Oportunidades Identificadas
+{gaps, nichos, diferenciação possível}
+
+## Tendências Relevantes
+{mudanças de comportamento, tecnologia, regulação — últimos 12-24 meses}
+
+## Fontes
+{liste todas as fontes com data de acesso}
+```
+
+### `docs/research/benchmarks.md`
+
+```markdown
+# Benchmarks de Referência
+
+**Data:** {YYYY-MM-DD}
+
+## Produtos de Referência
+{produtos que resolvem bem o problema — mesmo que em outro mercado}
+
+## Métricas do Setor
+| Métrica | Referência ruim | Referência boa | Referência excelente |
+|---------|----------------|----------------|----------------------|
+| {ex: Conversão checkout} | < 1% | 2-3% | > 5% |
+
+## Padrões de UX Consolidados
+{padrões que usuários já esperam neste domínio}
+
+## Fontes
+```
+
+### `docs/business/business-context.md`
+
+```markdown
+# Contexto de Negócio
+
+**Data:** {YYYY-MM-DD}
+
+## Por que isto existe
+{problema de negócio que motivou esta iniciativa}
+
+## Stakeholders
+| Papel | Interesse | Impacto |
+|-------|-----------|---------|
+
+## Restrições
+{tecnológicas, legais, de prazo, de orçamento}
+
+## Oportunidade
+{por que agora? O que mudou?}
+```
+
+## Critérios de qualidade
+
+Antes de entregar, verifique:
+- [ ] Ao menos 3 concorrentes analisados com pontos fortes E fracos
+- [ ] Toda afirmação com fonte citada
+- [ ] Benchmarks com números reais (%, tempo, NPS)
+- [ ] business-context.md responde "por que agora?"

package/.synapos/squad-templates/produto/pipelines/steps/03-personas.md

@@ -0,0 +1,107 @@
+---
+id: 03-personas
+name: "User Research e Personas"
+agent: paulo-pesquisa
+execution: subagent
+model_tier: powerful
+output_files:
+  - personas/user-personas.md
+  - research/user-research.md
+veto_conditions:
+  - "Personas sem Jobs-to-be-Done definidos"
+  - "Personas genéricas sem comportamento específico"
+  - "Sem citação ou comportamento observado de usuário real"
+---
+
+# User Research e Personas
+
+Você é **Paulo Pesquisa**. Leia seu `.agent.md` para aplicar sua persona e princípios completos.
+
+## Contexto disponível
+
+- Objetivo do squad: `{squad.description}`
+- Análise de mercado: `docs/research/market-analysis.md` ← leia antes de começar
+- Contexto de negócio: `docs/business/business-context.md`
+
+## Sua missão neste step
+
+Defina quem são os usuários reais deste produto e o que eles estão tentando realizar.
+Use Jobs-to-be-Done como framework central.
+
+## Documentos a gerar
+
+### `docs/research/user-research.md`
+
+```markdown
+# User Research
+
+**Data:** {YYYY-MM-DD}
+**Método:** {desk research / entrevistas / dados analytics / reviews de produto}
+
+## Comportamentos Observados
+{o que usuários fazem hoje para resolver o problema — sem o produto}
+
+## Frustrações Recorrentes
+{dores mais citadas em reviews, fóruns, suporte}
+{inclua citações literais quando possível}
+
+## Padrões de Uso
+{frequência, contexto, dispositivo, momento do dia}
+
+## O que tentam realizar
+{jobs-to-be-done primários e secundários}
+
+## Fontes
+{G2, AppStore reviews, Reddit, entrevistas, dados de analytics}
+```
+
+### `docs/personas/user-personas.md`
+
+Crie de 2 a 3 personas. Para cada uma:
+
+```markdown
+# Personas
+
+---
+
+## Persona 1: {Nome} — {Papel/Perfil}
+
+**Foto/Ícone:** {emoji ou descrição}
+**Idade:** {faixa}
+**Ocupação:** {cargo/função}
+**Contexto:** {onde trabalha, tamanho de empresa, rotina relevante}
+
+### Jobs-to-be-Done
+- **Job principal:** {o que ele/ela precisa realizar}
+- **Jobs secundários:** {tarefas relacionadas}
+
+### Dores Atuais
+1. {dor específica com contexto}
+2. {dor específica}
+3. {dor específica}
+
+### Ganhos Esperados
+1. {o que melhoraria com a solução certa}
+2. ...
+
+### Comportamentos Relevantes
+- {como resolve o problema hoje}
+- {ferramentas que usa atualmente}
+- {frequência e contexto de uso}
+
+### Citação Representativa
+> "{fala típica desta persona — em primeira pessoa}"
+
+---
+
+## Persona 2: ...
+```
+
+## Critérios de qualidade
+
+Antes de entregar, verifique:
+- [ ] 2-3 personas (não mais — foco)
+- [ ] Cada persona tem Jobs-to-be-Done explícitos
+- [ ] Dores com contexto específico (não "quer algo fácil")
+- [ ] Ao menos 1 citação representativa por persona
+- [ ] Personas diferenciadas entre si (se são iguais, é 1 persona)

package/.synapos/squad-templates/produto/pipelines/steps/04-checkpoint-research.md

@@ -0,0 +1,53 @@
+---
+id: 04-checkpoint-research
+name: "Validação da Pesquisa"
+execution: checkpoint
+---
+
+# Checkpoint — Validação da Pesquisa
+
+Antes de partir para a especificação, o usuário deve validar a direção da pesquisa.
+
+## Apresentar resumo
+
+Leia os documentos gerados e apresente:
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+RESUMO DA PESQUISA
+
+Mercado: {1-2 frases do market-analysis}
+
+Top 3 insights competitivos:
+  1. {insight}
+  2. {insight}
+  3. {insight}
+
+Personas identificadas:
+  • {Persona 1}: {job principal em 1 linha}
+  • {Persona 2}: {job principal em 1 linha}
+
+Principal oportunidade:
+  {1-2 frases do business-context}
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+## Perguntas ao usuário
+
+```
+A pesquisa está alinhada com o que você esperava?
+
+[1] Sim — prosseguir para a spec
+[2] Ajustar foco — o que quer mudar?
+[3] Adicionar contexto — há informação que eu não tenho ainda
+```
+
+**Se [2] ou [3]:** Registre o ajuste em `_memory/memories.md` e retorne ao step 02-contexto-negocio com o novo foco.
+
+**Se [1]:** Registre em `_memory/memories.md`:
+```markdown
+## Pesquisa aprovada — {YYYY-MM-DD}
+Direção validada: {resumo do que foi confirmado}
+```
+
+Prossiga para o step 05-spec.

package/.synapos/squad-templates/produto/pipelines/steps/04b-alinhamento-estrategico.md

@@ -0,0 +1,92 @@
+---
+id: 04b-alinhamento-estrategico
+name: "Alinhamento Estratégico com o Usuário"
+execution: checkpoint
+---
+
+# Alinhamento Estratégico — Aprovação antes da Spec
+
+Antes de gerar qualquer documento de produto, é obrigatório alinhar as decisões estratégicas com o usuário. Nenhuma spec, visão ou decisão de negócio deve ser criada sem aprovação explícita.
+
+## Contexto disponível
+
+Leia os documentos de pesquisa gerados até agora:
+- `docs/business/research/market-analysis.md`
+- `docs/business/business-context.md`
+- `docs/business/personas/user-personas.md`
+
+## Perguntas obrigatórias ao usuário
+
+Apresente cada bloco e aguarde respostas antes de prosseguir. Faça quantas rodadas forem necessárias até ter clareza total.
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ALINHAMENTO ESTRATÉGICO — preciso da sua visão
+
+Antes de criar a spec, preciso entender suas
+decisões de negócio. Por favor responda:
+
+1. VISÃO DO PRODUTO
+   Qual é a visão de longo prazo para este produto?
+   O que ele representa em 3-5 anos?
+
+2. PERSONAS PRIORITÁRIAS
+   Das personas identificadas na pesquisa, qual é
+   a mais importante para a v1? Por quê?
+
+3. DIFERENCIAL COMPETITIVO
+   O que torna este produto diferente dos
+   concorrentes? Qual é a aposta única?
+
+4. FEATURES DA V1
+   Quais funcionalidades são obrigatórias para o
+   primeiro lançamento? O que fica para depois?
+
+5. MÉTRICAS DE SUCESSO
+   Como você vai saber que o produto funcionou?
+   Qual número ou comportamento indica sucesso?
+
+6. RESTRIÇÕES E LIMITES
+   Há restrições técnicas, de prazo, budget ou
+   regulatórias que eu preciso saber?
+
+7. DECISÕES JÁ TOMADAS
+   Há decisões de negócio ou técnicas já definidas
+   que não podem ser questionadas na spec?
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+## Ciclos de refinamento
+
+Após as respostas iniciais, identifique lacunas e faça perguntas de follow-up. Continue iterando até ter clareza em todos os pontos acima.
+
+Ao finalizar, apresente um resumo das decisões estratégicas:
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+RESUMO DAS DECISÕES ESTRATÉGICAS
+
+Visão: {resposta confirmada}
+Persona principal: {persona escolhida}
+Diferencial: {aposta única confirmada}
+Features v1: {lista confirmada}
+Métrica de sucesso: {definida}
+Restrições: {listadas}
+Decisões fixas: {listadas}
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Essas são as bases da spec. Posso prosseguir?
+
+[1] Sim — gerar product-vision.md e spec.md
+[2] Ajustar algum ponto antes de continuar
+```
+
+**Se [2]:** Registre o ajuste, atualize o resumo e repita.
+
+**Se [1]:** Registre em `_memory/memories.md`:
+```markdown
+## Direção estratégica aprovada — {YYYY-MM-DD}
+{resumo das decisões confirmadas}
+```
+
+Prossiga para o step 05-spec.

package/.synapos/squad-templates/produto/pipelines/steps/05-spec.md

@@ -0,0 +1,138 @@
+---
+id: 05-spec
+name: "Product Vision e Spec"
+agent: priscila-produto
+execution: subagent
+model_tier: powerful
+output_files:
+  - product-vision.md
+  - spec.md
+veto_conditions:
+  - "Spec sem critérios de aceite em qualquer feature"
+  - "Sem seção IN/OUT de escopo"
+  - "Product vision sem os 7 campos preenchidos"
+  - "Critério de aceite vago sem condição mensurável (ex: 'deve funcionar corretamente')"
+on_reject: 05-spec
+---
+
+# Product Vision e Spec
+
+Você é **Priscila Produto**. Leia seu `.agent.md` para aplicar sua persona e princípios completos.
+
+## Contexto disponível
+
+Leia todos antes de escrever:
+- `docs/research/market-analysis.md`
+- `docs/research/benchmarks.md`
+- `docs/personas/user-personas.md`
+- `docs/research/user-research.md`
+- `docs/business/business-context.md`
+- `_memory/memories.md` — preferências e ajustes do usuário
+
+## Documentos a gerar
+
+### `docs/product-vision.md`
+
+```markdown
+# Product Vision
+
+**Data:** {YYYY-MM-DD}
+**Versão:** 1.0
+
+## Declaração de Visão
+
+Para {persona primária}
+Que {problema/necessidade central}
+O {nome do produto/feature}
+É um {categoria}
+Que {benefício chave / diferencial}
+Diferente de {alternativa atual}
+Nossa solução {vantagem única}
+
+## North Star Metric
+{a métrica que melhor captura valor entregue ao usuário}
+
+## Objetivos (próximos 90 dias)
+| Objetivo | Métrica | Meta |
+|----------|---------|------|
+| {OBJ 1}  | {KR}    | {valor} |
+
+## O que NÃO é este produto
+{evitar scope creep — seja explícito}
+```
+
+### `docs/spec.md`
+
+Para cada feature/épico do escopo:
+
+```markdown
+# Spec: {nome do produto/feature}
+
+**Data:** {YYYY-MM-DD}
+**Status:** draft
+**PM:** Priscila Produto
+
+---
+
+## Visão Geral
+{1 parágrafo: o que é, para quem, qual problema resolve}
+
+## Problema que Resolve
+{dor específica das personas, com referência ao user-research}
+
+## Usuários Afetados
+{persona(s) impactadas com referência ao arquivo de personas}
+
+## Solução Proposta
+{o que o sistema fará — comportamento, não implementação}
+
+## Escopo desta Entrega
+**IN (obrigatório para esta versão):**
+- {item}
+- {item}
+
+**OUT (explicitamente fora):**
+- {item — e por quê}
+
+**LATER (backlog futuro):**
+- {item}
+
+## Features
+
+### Feature 1: {nome}
+{descrição em 1-2 frases}
+
+**Critérios de Aceite:**
+```
+Dado {contexto/pré-condição}
+Quando {ação do usuário}
+Então {resultado esperado}
+E {resultado adicional, se houver}
+```
+
+**Casos de Borda:**
+- {cenário edge case 1}
+- {cenário edge case 2}
+
+### Feature 2: ...
+
+## Dependências
+{sistemas, APIs, times, decisões externas}
+
+## Métricas de Sucesso
+| Métrica | Baseline | Meta | Prazo |
+|---------|---------|------|-------|
+
+## Fora do Escopo
+{tudo que não está no IN — seja explícito}
+```
+
+## Critérios de qualidade
+
+Antes de entregar, verifique:
+- [ ] Product vision com todos os 7 campos
+- [ ] North Star Metric definida
+- [ ] Toda feature tem ao menos 1 critério de aceite no formato Dado/Quando/Então
+- [ ] Seções IN/OUT/LATER preenchidas
+- [ ] Ao menos 1 métrica de sucesso mensurável
+- [ ] Casos de borda documentados para features críticas

package/.synapos/squad-templates/produto/pipelines/steps/05b-checkpoint-spec.md

@@ -0,0 +1,60 @@
+---
+id: 05b-checkpoint-spec
+name: "Aprovação da Spec"
+execution: checkpoint
+---
+
+# Checkpoint — Aprovação da Spec
+
+A spec foi gerada. Antes de avançar para requisitos técnicos, o usuário deve revisar e aprovar o conteúdo.
+
+## Apresentar resumo da spec
+
+Leia `docs/product-vision.md` e `docs/spec.md` e apresente:
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+RESUMO DA SPEC
+
+Product Vision:
+  Para: {persona primária}
+  Problema: {problema central}
+  Solução: {diferencial único}
+  North Star: {métrica principal}
+
+Escopo v1 (IN):
+  • {feature 1}
+  • {feature 2}
+  • {feature 3}
+
+Fora do escopo (OUT):
+  • {item excluído}
+
+Features principais: {N features com critérios de aceite}
+Métricas de sucesso: {N métricas definidas}
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+## Decisão do usuário
+
+```
+A spec reflete o que foi alinhado?
+
+[1] Aprovado — prosseguir para requisitos técnicos
+[2] Ajustar escopo — o que incluir ou remover?
+[3] Revisar product vision — algo está errado
+[4] Recomeçar a spec — mudar direção completamente
+```
+
+**Se [2] ou [3]:** Registre o feedback em `_memory/memories.md`, retorne ao step 05-spec com as correções.
+
+**Se [4]:** Retorne ao step 04b-alinhamento-estrategico para realinhar a direção antes de reger a spec.
+
+**Se [1]:** Registre em `_memory/memories.md`:
+```markdown
+## Spec aprovada — {YYYY-MM-DD}
+Escopo confirmado: {resumo do IN}
+Excluído: {resumo do OUT}
+```
+
+Prossiga para o step 06-requisitos.

package/.synapos/squad-templates/produto/pipelines/steps/06-requisitos.md

@@ -0,0 +1,118 @@
+---
+id: 06-requisitos
+name: "Requisitos Funcionais e Não-Funcionais"
+agent: ana-analise
+execution: subagent
+model_tier: powerful
+output_files:
+  - requirements.md
+veto_conditions:
+  - "RF sem critério de aceite"
+  - "RNF sem valor numérico mensurável"
+  - "Conflito identificado sem proposta de resolução"
+  - "Requisito sem prioridade P0/P1/P2"
+on_reject: 06-requisitos
+---
+
+# Requisitos Funcionais e Não-Funcionais
+
+Você é **Ana Análise**. Leia seu `.agent.md` para aplicar sua persona e princípios completos.
+
+## Contexto disponível
+
+Leia antes de começar:
+- `docs/spec.md` ← fonte principal
+- `docs/product-vision.md`
+- `docs/personas/user-personas.md`
+
+## Sua missão
+
+Transformar a spec em requisitos precisos, rastreáveis e sem ambiguidade.
+Identificar conflitos e lacunas antes que cheguem ao desenvolvimento.
+
+## Documento a gerar
+
+### `docs/requirements.md`
+
+```markdown
+# Requisitos
+
+**Data:** {YYYY-MM-DD}
+**Versão:** 1.0
+**Origem:** spec.md v{versão}
+
+---
+
+## Requisitos Funcionais
+
+### RF-001: {título curto}
+**Descrição:** {o que o sistema deve fazer}
+**Origem:** {persona | negócio | técnico} — {referência na spec}
+**Prioridade:** P0 | P1 | P2
+**Critério de aceite:** {formato Dado/Quando/Então ou assertion direta}
+
+### RF-002: ...
+
+---
+
+## Requisitos Não-Funcionais
+
+### RNF-001: Performance — Tempo de resposta
+**Descrição:** Endpoints críticos devem responder em menos de {X}ms para P95
+**Métrica:** {X}ms no P95, {Y}ms no P99
+**Prioridade:** P0
+
+### RNF-002: Disponibilidade
+**Descrição:** {X}% de uptime em horário comercial
+**Métrica:** {X}% SLA mensal
+**Prioridade:** P0
+
+### RNF-003: Segurança
+**Descrição:** {requisito de segurança específico}
+**Prioridade:** P0
+
+### RNF-004: Escalabilidade
+**Descrição:** Sistema deve suportar {N} usuários simultâneos sem degradação
+**Métrica:** {N} req/s sem aumento de latência > 20%
+**Prioridade:** P1
+
+---
+
+## Análise de Conflitos e Gaps
+
+### Conflitos Identificados
+{Se nenhum: escreva "Nenhum conflito identificado nesta versão."}
+
+#### CONFLITO-001: {título}
+**RF envolvidos:** RF-{X} e RF-{Y}
+**Descrição:** {o que conflita e por quê}
+**Opções:**
+  - Opção A: {descrição} — implicação
+  - Opção B: {descrição} — implicação
+**Recomendação:** {opção sugerida com justificativa}
+**Decisão necessária de:** {PM | Tech Lead | Stakeholder}
+
+### Requisitos Implícitos Identificados
+{itens que estavam implícitos na spec e foram tornados explícitos}
+
+### Gaps Detectados
+{o que está faltando na spec que precisaria de definição}
+
+---
+
+## Matriz de Rastreabilidade
+
+| Requisito | Feature na Spec | Persona | Prioridade |
+|-----------|----------------|---------|-----------|
+| RF-001 | Feature X | Persona 1 | P0 |
+```
+
+## Critérios de qualidade
+
+Antes de entregar, verifique:
+- [ ] Todo comportamento da spec tem RF correspondente
+- [ ] Todo RNF tem valor numérico (tempo, %, quantidade)
+- [ ] Todo RF tem prioridade P0/P1/P2
+- [ ] Todos os conflitos têm proposta de resolução
+- [ ] Ao menos 2 casos de borda documentados para fluxos críticos
+- [ ] Nenhum requisito vago ("deve ser rápido", "deve ser seguro")