synapos 2.5.0

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

@@ -0,0 +1,53 @@
+---
+id: 06b-checkpoint-requisitos
+name: "Aprovação dos Requisitos"
+execution: checkpoint
+---
+
+# Checkpoint — Aprovação dos Requisitos
+
+Os requisitos foram gerados. Antes de avançar para decisões de arquitetura, o usuário deve validar prioridades e completude.
+
+## Apresentar resumo dos requisitos
+
+Leia `docs/requirements.md` e apresente:
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+RESUMO DOS REQUISITOS
+
+Funcionais:
+  P0 (críticos): {N requisitos}
+  P1 (importantes): {N requisitos}
+  P2 (desejáveis): {N requisitos}
+
+Não-Funcionais:
+  Performance: {requisito principal}
+  Segurança: {requisito principal}
+  Escalabilidade: {requisito principal}
+
+Conflitos identificados: {N — lista breve}
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+## Decisão do usuário
+
+```
+As prioridades e requisitos estão corretos?
+
+[1] Aprovado — prosseguir para arquitetura
+[2] Ajustar prioridades — mover P0/P1/P2
+[3] Adicionar requisito — algo está faltando
+[4] Remover requisito — algo está além do escopo
+```
+
+**Se [2], [3] ou [4]:** Registre o ajuste em `_memory/memories.md`, retorne ao step 06-requisitos com o feedback.
+
+**Se [1]:** Registre em `_memory/memories.md`:
+```markdown
+## Requisitos aprovados — {YYYY-MM-DD}
+P0 confirmados: {lista breve}
+Ajustes feitos: {se houver}
+```
+
+Prossiga para o step 07-arquitetura.

package/.synapos/squad-templates/produto/pipelines/steps/06c-visual-spec.md

@@ -0,0 +1,59 @@
+# Step 06c — Especificação Visual e Design System
+
+## Agent: Úrsula UI (ursula-ui)
+
+## Objetivo
+Com base na spec funcional (spec.md) e nos requisitos (requirements.md), produzir a especificação visual completa dos componentes e fluxos da feature, garantindo design system, acessibilidade e rastreabilidade para o handoff de desenvolvimento.
+
+## Instrução
+
+Leia da session:
+- `context.md` — contexto e objetivos
+- `spec.md` — especificação funcional aprovada
+- `requirements.md` — requisitos e critérios de aceite
+
+Para cada componente e fluxo identificado, siga o framework de Visual-Spec do seu perfil de agent.
+
+## Output obrigatório: `visual-spec.md`
+
+Estrutura mínima:
+```markdown
+# Visual Spec — {feature-name}
+
+## Componentes
+
+### {NomeComponente}
+- **Propósito:** {o que faz}
+- **Estados:** default | hover | focus | disabled | loading | error
+  - default: {descrição}
+  - hover: {descrição}
+  - focus: {descrição — ex: outline 2px --color-focus}
+  - disabled: {descrição}
+  - loading: {skeleton ou spinner? descrição}
+  - error: {mensagem de erro + ação de recuperação}
+- **Contraste:** {ratio}:1 ({AA/AAA})
+- **Tokens usados:** {lista de tokens do design system}
+- **Mobile:** {comportamento em < 768px}
+
+## Fluxos
+
+### {NomeFluxo}
+- **Estado vazio:** {o que o usuário vê}
+- **Estado de erro:** {mensagem + ação}
+- **Responsividade:** {breakpoints}
+
+## Verificação GATE-DESIGN
+
+- [ ] Todos os estados de componente especificados
+- [ ] Contraste AA declarado
+- [ ] Estado vazio documentado
+- [ ] Estado de erro com ação de recuperação
+- [ ] Componentes novos verificados no design system
+- [ ] Tokens (sem hardcode)
+- [ ] Responsividade definida
+```
+
+## Veto Conditions
+- Output sem seção `## Verificação GATE-DESIGN`
+- Componente interativo sem estado `focus` e `error`
+- Nenhum valor de contraste declarado

package/.synapos/squad-templates/produto/pipelines/steps/07-arquitetura.md

@@ -0,0 +1,160 @@
+---
+id: 07-arquitetura
+name: "Arquitetura e Decisões Técnicas"
+agent: tania-tecnica
+execution: subagent
+model_tier: powerful
+output_files:
+  - architecture.md
+  - roadmap.md
+  - success-metrics.md
+  - risks.md
+veto_conditions:
+  - "Decisão arquitetural sem ADR correspondente"
+  - "ADR sem alternativas rejeitadas documentadas"
+  - "Roadmap sem métricas de validação por fase"
+  - "Sem análise de riscos com ao menos 3 riscos"
+on_reject: 07-arquitetura
+---
+
+# Arquitetura, Decisões e Planejamento
+
+Você é **Tânia Técnica**. Leia seu `.agent.md` para aplicar sua persona e princípios completos.
+
+## Contexto disponível
+
+Leia todos antes de escrever:
+- `docs/spec.md`
+- `docs/requirements.md`
+- `docs/business/business-context.md`
+- `docs/product-vision.md`
+
+## Documentos a gerar
+
+### `docs/architecture.md`
+
+```markdown
+# Arquitetura
+
+**Data:** {YYYY-MM-DD}
+**Versão:** 1.0
+
+## Visão de Alto Nível
+{como as partes se encaixam — diagrama de texto se necessário}
+
+## Componentes Principais
+| Componente | Responsabilidade | Tecnologia sugerida |
+|-----------|-----------------|---------------------|
+
+## Decisões Arquiteturais
+
+### ADR-001: {título da decisão}
+**Data:** {YYYY-MM-DD}
+**Status:** proposto | aceito
+
+**Contexto:**
+{por que esta decisão foi necessária}
+
+**Decisão:**
+{o que foi decidido}
+
+**Consequências:**
+✅ {positivo}
+✅ {positivo}
+⚠ {trade-off ou risco}
+
+**Alternativas Rejeitadas:**
+- {opção A}: rejeitada porque {motivo}
+- {opção B}: rejeitada porque {motivo}
+
+### ADR-002: ...
+
+## Integrações Externas
+{APIs, serviços, sistemas com que o produto se integra}
+
+## Restrições Técnicas
+{limites conhecidos: performance, segurança, compatibilidade}
+```
+
+### `docs/roadmap.md`
+
+```markdown
+# Roadmap
+
+**Data:** {YYYY-MM-DD}
+
+## Agora — {período ou sprint atual}
+**Tema:** {foco estratégico}
+**Iniciativas:**
+- {feature/épico} → métrica de validação: {como saber se deu certo}
+
+## Depois — {próximo período}
+**Tema:** {foco estratégico}
+**Iniciativas:**
+- {feature/épico} → hipótese: {o que esperamos que aconteça}
+
+## Mais tarde — {futuro}
+**Tema:** {foco estratégico}
+**Hipóteses:**
+- {item em exploração}
+
+## Dependências entre Fases
+{o que precisa estar pronto na fase anterior para a próxima começar}
+```
+
+### `docs/success-metrics.md`
+
+```markdown
+# Métricas de Sucesso
+
+**Data:** {YYYY-MM-DD}
+
+## North Star Metric
+**Métrica:** {nome}
+**Definição:** {como é calculada}
+**Baseline:** {valor atual, se conhecido}
+**Meta:** {valor alvo} até {data}
+
+## Supporting Metrics
+| Métrica | Definição | Baseline | Meta | Prazo |
+|---------|-----------|---------|------|-------|
+
+## Counter Metrics (o que não deve piorar)
+| Métrica | Threshold máximo aceitável |
+|---------|--------------------------|
+
+## Como Medir
+{ferramentas, eventos, queries de analytics}
+```
+
+### `docs/risks.md`
+
+```markdown
+# Análise de Riscos
+
+**Data:** {YYYY-MM-DD}
+
+## Riscos Identificados
+
+### RISCO-001: {título}
+**Probabilidade:** Alta | Média | Baixa
+**Impacto:** Alto | Médio | Baixo
+**Descrição:** {o que pode acontecer}
+**Mitigação:** {ação preventiva}
+**Contingência:** {plano se o risco se materializar}
+**Responsável:** {quem monitora}
+
+### RISCO-002: ...
+
+## Resumo por Prioridade
+| Risco | Prob | Impacto | Score | Status |
+|-------|------|---------|-------|--------|
+```
+
+## Critérios de qualidade
+
+- [ ] Toda decisão arquitetural não óbvia tem ADR
+- [ ] Todo ADR tem ao menos 2 alternativas rejeitadas com motivo
+- [ ] Roadmap tem 3 horizontes com tema e métrica de validação
+- [ ] North Star Metric definida com baseline e meta
+- [ ] Ao menos 3 riscos com probabilidade, impacto e mitigação

package/.synapos/squad-templates/produto/pipelines/steps/08-handoff.md

@@ -0,0 +1,130 @@
+---
+id: 08-handoff
+name: "Handoff para Desenvolvimento"
+agent: tania-tecnica
+execution: subagent
+model_tier: powerful
+gate: GATE-4
+output_files:
+  - decisions-log.md
+  - open-questions.md
+  - handoff-checklist.md
+veto_conditions:
+  - "Handoff checklist com item em branco ou N/A sem justificativa"
+  - "Decisão sem data ou responsável"
+  - "Open question sem responsável definido"
+---
+
+# Handoff para Desenvolvimento
+
+Você é **Tânia Técnica**. Leia seu `.agent.md` para aplicar sua persona e princípios completos.
+
+## Contexto disponível
+
+Leia todos os documentos gerados antes de escrever:
+- `docs/product-vision.md`
+- `docs/spec.md`
+- `docs/requirements.md`
+- `docs/architecture.md`
+- `docs/roadmap.md`
+- `docs/success-metrics.md`
+- `docs/risks.md`
+
+## Documentos a gerar
+
+### `docs/decisions-log.md`
+
+Registre TODAS as decisões tomadas ao longo do processo:
+
+```markdown
+# Decisions Log
+
+**Projeto:** {nome do squad}
+**Data de fechamento:** {YYYY-MM-DD}
+
+| Data | Decisão | Contexto | Alternativas | Responsável |
+|------|---------|---------|--------------|-------------|
+| {data} | {o que foi decidido} | {por que} | {o que foi rejeitado} | {nome} |
+
+## Decisões Pendentes de Validação
+{decisões que precisam de confirmação antes do início do desenvolvimento}
+```
+
+### `docs/open-questions.md`
+
+```markdown
+# Perguntas em Aberto
+
+**Data:** {YYYY-MM-DD}
+
+| # | Pergunta | Impacto | Responsável | Prazo |
+|---|----------|---------|-------------|-------|
+| 1 | {pergunta específica} | {o que bloqueia se não for respondida} | {nome} | {data} |
+
+## Perguntas Respondidas Durante o Processo
+{log de perguntas que surgiram e foram resolvidas}
+```
+
+### `docs/handoff-checklist.md`
+
+```markdown
+# Handoff Checklist
+
+**Squad:** {slug}
+**Data:** {YYYY-MM-DD}
+**Status:** {pronto para dev | pendente: {o que falta}}
+
+---
+
+## Contexto de Produto
+- [ ] Product vision documentada com North Star Metric
+- [ ] Problema e personas claramente definidos
+- [ ] Escopo IN/OUT explícito na spec
+
+## Especificação
+- [ ] Todas as features têm critérios de aceite no formato Dado/Quando/Então
+- [ ] Casos de borda documentados para fluxos críticos
+- [ ] Dependências identificadas
+
+## Requisitos
+- [ ] Todos os RF com prioridade P0/P1/P2
+- [ ] RNF com métricas numéricas (tempo, %, quantidade)
+- [ ] Conflitos resolvidos ou documentados com responsável
+
+## Decisões Técnicas
+- [ ] ADRs para todas as decisões arquiteturais relevantes
+- [ ] Alternativas rejeitadas documentadas
+- [ ] Integrações externas identificadas
+
+## Planejamento
+- [ ] Roadmap com 3 horizontes
+- [ ] Métricas de sucesso com baseline e meta
+- [ ] Riscos principais com mitigação
+
+## Pendências
+- [ ] Perguntas em aberto têm responsável e prazo
+- [ ] Decisões pendentes estão no decisions-log
+
+---
+
+## Nota de Entrega
+
+{Breve mensagem de Tânia Técnica para o time de desenvolvimento
+resumindo os pontos mais importantes e o que precisa de atenção especial}
+```
+
+## Verificação GATE-4
+
+Antes de entregar, confirme que todos os arquivos existem:
+- [ ] `docs/product-vision.md` ✓
+- [ ] `docs/spec.md` ✓
+- [ ] `docs/requirements.md` ✓
+- [ ] `docs/architecture.md` ✓
+- [ ] `docs/roadmap.md` ✓
+- [ ] `docs/success-metrics.md` ✓
+- [ ] `docs/risks.md` ✓
+- [ ] `docs/decisions-log.md` ✓
+- [ ] `docs/open-questions.md` ✓
+- [ ] `docs/handoff-checklist.md` ✓
+
+Se qualquer arquivo estiver ausente → GATE-4 FALHA. Informe e não conclua o pipeline.

package/.synapos/squad-templates/produto/pipelines/steps/nf-02-validar-requisito.md

@@ -0,0 +1,73 @@
+---
+id: nf-02-validar-requisito
+name: "Validar Requisito"
+execution: checkpoint
+---
+
+# Validar Requisito
+
+Antes de qualquer spec, o requisito precisa estar sólido. Não assuma nada — pergunte.
+
+## Entrada
+
+O requisito foi passado como argumento ou descrito pelo usuário:
+
+```
+<requirement>
+#$ARGUMENTS
+</requirement>
+```
+
+Se nenhum argumento foi passado, pergunte:
+
+```
+Descreva o requisito ou feature que vamos especificar.
+Inclua: o que é, por que existe, para quem é.
+```
+
+---
+
+## Validação obrigatória
+
+Verifique se o requisito contém as três dimensões:
+
+| Dimensão | Pergunta | Presente? |
+|---|---|---|
+| **POR QUÊ** | Qual problema de negócio isto resolve? | ✅ / ❓ |
+| **O QUÊ** | O que exatamente está sendo construído? | ✅ / ❓ |
+| **COMO** | Há alguma diretriz técnica ou de produto? (opcional) | ✅ / — |
+
+Se qualquer dimensão obrigatória estiver ausente ou vaga, faça perguntas diretas:
+
+```
+Preciso esclarecer alguns pontos antes de continuar:
+
+[Para POR QUÊ ausente]
+- Qual problema de negócio ou dor do usuário motivou esse requisito?
+- O que acontece se não fizermos isso?
+
+[Para O QUÊ vago]
+- Pode descrever o comportamento esperado em 2-3 frases?
+- O que está dentro do escopo desta entrega? O que está fora?
+```
+
+Iterate até ter clareza completa. Não prossiga com requisito incompleto.
+
+---
+
+## Output
+
+Ao validar, apresente resumo confirmando o entendimento:
+
+```
+✅ Requisito validado
+
+POR QUÊ: {resumo do problema/motivação}
+O QUÊ: {resumo do que será construído}
+PARA QUEM: {persona ou usuário alvo}
+FORA DE ESCOPO: {o que não será feito}
+
+Posso prosseguir para verificação dos docs?
+```
+
+Aguarde confirmação do usuário antes de avançar.

package/.synapos/squad-templates/produto/pipelines/steps/nf-03-verificar-docs.md

@@ -0,0 +1,69 @@
+---
+id: nf-03-verificar-docs
+name: "Verificar Docs e Restrições"
+agent: ana-analise
+execution: subagent
+model_tier: powerful
+---
+
+# Verificar Docs e Restrições
+
+Você é **Ana Análise**. Leia seu `.agent.md` para aplicar sua persona completa.
+
+## Contexto disponível
+
+Leia todos antes de analisar:
+- `docs/business/business-context.md` — modelo de negócio, stakeholders, restrições
+- `docs/business/product-vision.md` — visão, missão, princípios, IN/OUT de escopo
+- `docs/business/personas/user-personas.md` — personas ativas
+- `docs/business/competitive_landscape.md` — posicionamento competitivo
+- `docs/tech-context/briefing/critical-rules.md` — regras técnicas não-negociáveis
+- `docs/tech-context/briefing/adrs-summary.md` — decisões arquiteturais registradas
+- `_memory/memories.md` — requisito validado no step anterior
+
+## Sua missão
+
+Cruzar o requisito com a base de produto existente. Identificar:
+
+1. **Alinhamento com visão** — o requisito está dentro do escopo definido em `product-vision.md`?
+2. **Persona correta** — o requisito serve uma persona real do produto?
+3. **Conflitos com decisões** — o requisito viola alguma ADR ou critical-rule?
+4. **Restrições aplicáveis** — quais constraints de negócio ou técnicas se aplicam?
+5. **Lacunas nos docs** — algo relevante ainda não está documentado?
+
+## Output
+
+Apresente análise estruturada:
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+VERIFICAÇÃO DE DOCS
+
+✅ Alinhamento com visão: {alinhado | parcial | conflito}
+   {justificativa em 1-2 linhas}
+
+✅ Persona: {persona identificada} — {fit: alto | médio | baixo}
+
+{SE CONFLITO COM RESTRIÇÕES}
+⚠️  Conflito identificado:
+   ADR-{N}: {título} — {o que conflita}
+   → Recomendação: {o que fazer}
+
+✅ Restrições aplicáveis:
+   - {restrição 1}
+   - {restrição 2}
+
+✅ Contexto adicional dos docs:
+   - {insight relevante 1}
+   - {insight relevante 2}
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+Se houver conflito crítico com docs existentes, pause e apresente ao usuário antes de prosseguir. Só continue se o usuário pedir explicitamente.
+
+Salve contexto em `_memory/memories.md`:
+```markdown
+## Verificação de docs — {YYYY-MM-DD}
+Restrições aplicáveis: {lista}
+Conflitos: {nenhum | lista}
+```

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

@@ -0,0 +1,160 @@
+---
+id: nf-04-spec
+name: "Spec da Feature"
+agent: priscila-produto
+execution: subagent
+model_tier: powerful
+output_files:
+  - spec.md
+veto_conditions:
+  - "Spec sem critérios de aceite mensuráveis"
+  - "Sem seção IN/OUT de escopo"
+  - "Requisito funcional sem critério de aceite"
+  - "Critério de aceite vago sem condição verificável (ex: 'deve funcionar corretamente')"
+  - "Decisão técnica que viola uma ADR sem justificativa explícita"
+on_reject: nf-04-spec
+---
+
+# Spec da Feature
+
+Você é **Priscila Produto**. Leia seu `.agent.md` para aplicar sua persona completa.
+
+## Contexto disponível
+
+Leia todos antes de escrever:
+- `_memory/memories.md` — requisito validado + restrições identificadas
+- `docs/business/product-vision.md` — princípios e métricas de sucesso
+- `docs/business/personas/user-personas.md` — personas ativas
+- `docs/business/business-context.md` — contexto de negócio
+- `docs/tech-context/briefing/critical-rules.md` — regras críticas
+
+## Sua missão
+
+Construir a spec completa da feature. Não invente contexto — use o que está nos docs. Onde há lacunas, marque como **A DEFINIR** e liste as perguntas no final.
+
+Iterate com o usuário até ter clareza total antes de gerar o documento final.
+
+---
+
+## Documento a gerar
+
+Salve em `docs/specs/{feature-slug}-v1.md`:
+
+```markdown
+# Spec: {Nome da Feature}
+
+**Versão:** v1
+**Data:** {YYYY-MM-DD}
+**Agent:** Priscila Produto
+**Status:** draft → aprovado
+
+---
+
+## Visão Geral
+
+### Problema
+{O problema específico que esta feature resolve — 2-3 frases}
+
+### Solução Proposta
+{O que será construído — 2-3 frases. Não o como, o quê.}
+
+### Persona Principal
+{Nome da persona} — {por que esta feature é para ela}
+
+### Métricas de Sucesso
+| Métrica | Baseline | Target | Prazo |
+|---|---|---|---|
+| {métrica} | {valor atual} | {valor esperado} | {quando} |
+
+---
+
+## Escopo
+
+### IN — O que está incluído nesta entrega
+- {item 1}
+- {item 2}
+
+### OUT — O que está explicitamente fora
+- {item 1}
+- {item 2}
+
+---
+
+## Requisitos Funcionais
+
+| ID | Descrição | Critério de Aceite | Prioridade |
+|---|---|---|---|
+| RF-01 | {descrição clara} | {condição verificável e mensurável} | P0 / P1 / P2 |
+| RF-02 | ... | ... | ... |
+
+> P0 = bloqueante para lançamento / P1 = importante / P2 = desejável
+
+---
+
+## Requisitos Não-Funcionais
+
+| ID | Categoria | Requisito | Valor |
+|---|---|---|---|
+| RNF-01 | Performance | {ex: tempo de resposta do endpoint} | < 200ms p99 |
+| RNF-02 | Segurança | {ex: autenticação obrigatória} | JWT Bearer |
+| RNF-03 | Acessibilidade | {ex: WCAG} | 2.1 AA |
+
+---
+
+## Fluxo Principal
+
+{Descrever o fluxo feliz em passos numerados}
+
+1. Usuário {ação}
+2. Sistema {resposta}
+3. ...
+
+### Fluxos Alternativos
+
+**{Cenário de erro ou exceção}:**
+1. ...
+
+---
+
+## Considerações Técnicas
+
+{Restrições, dependências, integrações relevantes identificadas nos docs}
+
+- Stack: conforme `docs/tech-context/briefing/tech-stack.md`
+- Regras aplicáveis: {listar critical-rules relevantes}
+- ADRs que se aplicam: {ADR-N: título}
+
+---
+
+## Dependências
+
+| Dependência | Tipo | Status |
+|---|---|---|
+| {feature/sistema} | técnica / negócio | existente / a desenvolver |
+
+---
+
+## Perguntas em Aberto
+
+| # | Pergunta | Responsável | Prazo |
+|---|---|---|---|
+| 1 | {questão não resolvida} | {quem decide} | {quando} |
+
+---
+
+## Referências
+
+- Requisito original: `_memory/memories.md`
+- Contexto de negócio: `docs/business/business-context.md`
+- Persona: `docs/business/personas/user-personas.md`
+```
+
+---
+
+## Critérios de qualidade
+
+- [ ] Todos os RFs com critério de aceite mensurável
+- [ ] RNFs com valores numéricos (não "deve ser rápido")
+- [ ] IN/OUT de escopo explícito
+- [ ] Nenhuma decisão técnica que viola ADRs (ou justificativa explícita)
+- [ ] Perguntas em aberto documentadas com responsável