synapos 2.5.0

package/.synapos/squad-templates/produto/pipelines/steps/nf-05-checkpoint-aprovacao.md

@@ -0,0 +1,50 @@
+---
+id: nf-05-checkpoint-aprovacao
+name: "Aprovação da Spec"
+execution: checkpoint
+---
+
+# Aprovação da Spec
+
+Apresente a spec gerada ao usuário para revisão e aprovação formal.
+
+## Revisão
+
+Apresente um resumo da spec:
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+SPEC PARA APROVAÇÃO: {Nome da Feature}
+
+📋 Problema: {1 linha}
+✅ IN de escopo: {N itens}
+❌ OUT de escopo: {N itens}
+📐 Requisitos funcionais: {N RFs — P0: X / P1: Y / P2: Z}
+⚙️  Requisitos não-funcionais: {N RNFs}
+❓ Perguntas em aberto: {N itens}
+
+Arquivo: docs/specs/{feature-slug}-v1.md
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+O que você quer fazer?
+
+▶️  Aprovar e versionar
+✏️  Revisar algum ponto
+❌  Cancelar
+```
+
+## Se revisar
+
+Identifique o que muda, atualize a spec e retorne a este checkpoint.
+
+## Se aprovar
+
+Registre em `_memory/memories.md`:
+```markdown
+## Spec aprovada — {YYYY-MM-DD}
+Feature: {nome}
+Arquivo: docs/specs/{feature-slug}-v1.md
+Status: aprovado para versionar
+```
+
+Prossiga para o step de versionamento.

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

@@ -0,0 +1,71 @@
+---
+id: nf-06-versionar
+name: "Versionar e Registrar"
+agent: tania-tecnica
+execution: subagent
+model_tier: fast
+---
+
+# Versionar e Registrar
+
+Você é **Tânia Técnica**. Registre a nova spec nos índices do projeto.
+
+## REGRA FUNDAMENTAL
+
+**Nunca sobrescreva arquivos existentes em `docs/business/`.**
+Apenas crie novos arquivos e faça appends em arquivos de índice.
+
+## Contexto disponível
+
+- `_memory/memories.md` — spec aprovada e seu caminho
+- `docs/business/index.md` — índice atual (se existir)
+- `docs/CHANGELOG.md` — changelog atual (se existir)
+
+## Tarefas
+
+### 1. Verificar versão
+
+Verifique se `docs/specs/{feature-slug}-v1.md` já existe.
+- Se não existe: o arquivo já foi criado no step anterior. ✅
+- Se já existe uma v1: o step anterior deveria ter criado `-v2.md`. Verifique e corrija o nome se necessário.
+
+### 2. Atualizar `docs/business/index.md`
+
+Se o arquivo não existe, crie-o. Se existe, **apenas adicione** a nova entrada — nunca remova ou modifique entradas existentes.
+
+Adicione ao final da seção de specs (ou crie a seção se não existir):
+
+```markdown
+## Specs de Features
+
+| Feature | Versão | Data | Status |
+|---|---|---|---|
+| [{Nome da Feature}](../specs/{feature-slug}-v1.md) | v1 | {YYYY-MM-DD} | aprovado |
+```
+
+### 3. Atualizar `docs/CHANGELOG.md`
+
+Se o arquivo não existe, crie-o. Se existe, **apenas adicione** no topo — nunca modifique entradas existentes.
+
+```markdown
+## [{YYYY-MM-DD}] — {Nome da Feature}
+
+### Adicionado
+- `docs/specs/{feature-slug}-v1.md` — Spec completa: {1 linha descrevendo a feature}
+
+---
+```
+
+## Confirmação
+
+Ao finalizar, informe:
+
+```
+✅ Spec versionada com sucesso!
+
+📄 Spec: docs/specs/{feature-slug}-v1.md
+📋 Index: docs/business/index.md — entrada adicionada
+📝 Changelog: docs/CHANGELOG.md — entrada adicionada
+
+Próximo passo: handoff para squad de desenvolvimento
+```

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

@@ -0,0 +1,99 @@
+---
+id: nf-07-handoff
+name: "Handoff para Dev"
+agent: tania-tecnica
+execution: subagent
+model_tier: powerful
+output_files:
+  - handoff.md
+gate: GATE-2
+veto_conditions:
+  - "Handoff sem link para a spec aprovada"
+  - "Critério de aceite ausente no checklist"
+  - "Dependência técnica não documentada"
+---
+
+# Handoff para Desenvolvimento
+
+Você é **Tânia Técnica**. Leia seu `.agent.md` para aplicar sua persona completa.
+
+## Contexto disponível
+
+- `docs/specs/{feature-slug}-v1.md` ← spec aprovada
+- `docs/tech-context/briefing/critical-rules.md` ← regras que o dev deve seguir
+- `docs/tech-context/briefing/tech-stack.md` ← stack do projeto
+- `_memory/memories.md` ← contexto da sessão
+
+## Documento a gerar
+
+Salve em `docs/specs/{feature-slug}-handoff.md`:
+
+```markdown
+# Handoff: {Nome da Feature}
+
+**Data:** {YYYY-MM-DD}
+**Spec:** [docs/specs/{feature-slug}-v1.md](../specs/{feature-slug}-v1.md)
+**Squad recomendado:** {backend | frontend | fullstack | mobile}
+
+---
+
+## Resumo Executivo
+
+{2-3 frases: o que é, por que importa, o que o dev precisa entregar}
+
+---
+
+## Checklist de Entrega
+
+### Requisitos obrigatórios (P0)
+- [ ] RF-01: {critério de aceite exato da spec}
+- [ ] RF-02: {critério de aceite exato da spec}
+
+### Requisitos importantes (P1)
+- [ ] RF-0X: {critério de aceite}
+
+### Requisitos não-funcionais
+- [ ] RNF-01: {valor numérico exato}
+- [ ] RNF-02: {valor numérico exato}
+
+---
+
+## Regras Técnicas Obrigatórias
+
+> Extraídas de `docs/tech-context/briefing/critical-rules.md`
+
+- {regra 1 aplicável a esta feature}
+- {regra 2 aplicável a esta feature}
+
+---
+
+## Dependências
+
+| O quê | Onde | Status |
+|---|---|---|
+| {API / componente / dado} | {localização no codebase} | {pronto / a fazer} |
+
+---
+
+## Perguntas em Aberto
+
+| # | Pergunta | Decisor | Prazo |
+|---|---|---|---|
+| 1 | {questão da spec} | {PM / Tech Lead} | {data} |
+
+---
+
+## Para começar
+
+```
+/init → selecione o squad {backend|frontend|fullstack|mobile}
+→ informe: "implementar {feature-slug} conforme docs/specs/{feature-slug}-v1.md"
+```
+```
+
+## Critérios de qualidade
+
+- [ ] Link para spec aprovada presente
+- [ ] Todos os critérios de aceite P0 no checklist
+- [ ] Regras técnicas aplicáveis listadas
+- [ ] Comando de início claro para o dev squad

package/.synapos/squad-templates/produto/pipelines/steps/nf-08-criar-tarefas.md

@@ -0,0 +1,232 @@
+---
+id: nf-08-criar-tarefas
+name: "Criar Tarefas"
+execution: checkpoint
+---
+
+# Criar Tarefas
+
+A spec está aprovada. Agora vamos transformar os requisitos em tarefas acionáveis.
+
+## Plataforma
+
+Pergunte ao usuário onde criar as tarefas:
+
+```
+Onde você quer criar as tarefas desta feature?
+
+📁 Local       — arquivo docs/specs/{feature-slug}-tasks.md
+🐙 GitHub      — issues no repositório atual (usa gh CLI)
+📐 Linear      — issues no workspace Linear
+🔲 Jira        — issues no projeto Jira
+📋 Outro       — gero as tarefas formatadas e você cola onde quiser
+```
+
+Aguarde a seleção antes de continuar.
+
+---
+
+## Preparar tarefas
+
+Leia `docs/specs/{feature-slug}-v1.md` e extraia:
+
+Para cada **RF** (Requisito Funcional):
+- Título: `[{feature-slug}] RF-{N}: {descrição curta}`
+- Descrição: critério de aceite + contexto
+- Prioridade: P0 → alta / P1 → média / P2 → baixa
+- Labels: `feature`, domínio técnico (ex: `backend`, `frontend`)
+- Referência: link para a spec
+
+Inclua também:
+- 1 tarefa de setup/configuração se houver dependências técnicas a preparar
+- 1 tarefa de testes de aceitação (validar todos os critérios de aceite P0)
+
+---
+
+## Execução por plataforma
+
+### 📁 Local — `docs/specs/{feature-slug}-tasks.md`
+
+Crie o arquivo:
+
+```markdown
+# Tarefas: {Nome da Feature}
+
+**Spec:** [docs/specs/{feature-slug}-v1.md](../specs/{feature-slug}-v1.md)
+**Criado em:** {YYYY-MM-DD}
+**Total:** {N} tarefas
+
+---
+
+## 🔴 Alta Prioridade (P0)
+
+- [ ] **[{feature-slug}] RF-01: {descrição}**
+  Critério: {critério de aceite exato da spec}
+  Labels: feature, {domínio}
+
+- [ ] **[{feature-slug}] RF-0X: ...**
+
+## 🟡 Média Prioridade (P1)
+
+- [ ] **[{feature-slug}] RF-0X: {descrição}**
+  Critério: {critério de aceite}
+
+## 🟢 Baixa Prioridade (P2)
+
+- [ ] **[{feature-slug}] RF-0X: {descrição}**
+
+## ✅ Validação
+
+- [ ] **[{feature-slug}] Testes de aceitação**
+  Validar todos os critérios P0 conforme a spec aprovada.
+  Referência: docs/specs/{feature-slug}-v1.md
+```
+
+---
+
+### 🐙 GitHub Issues
+
+Verifique se o `gh` CLI está disponível:
+```bash
+gh --version
+```
+
+Se disponível, crie uma issue por RF usando o template abaixo. Execute cada comando separadamente e aguarde confirmação entre eles:
+
+```bash
+gh issue create \
+  --title "[{feature-slug}] RF-{N}: {descrição curta}" \
+  --body "## Descrição
+{descrição do RF}
+
+## Critério de Aceite
+{critério de aceite exato}
+
+## Referência
+Spec: docs/specs/{feature-slug}-v1.md
+
+## Prioridade
+{P0 | P1 | P2}" \
+  --label "feature" \
+  --label "{prioridade: high | medium | low}"
+```
+
+Ao final, liste todas as issues criadas com seus números e links.
+
+Se `gh` não estiver disponível: informe o usuário e ofereça a opção **Local** como fallback.
+
+---
+
+### 📐 Linear
+
+Gere um bloco de tarefas formatado para importação manual ou API:
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+TAREFAS PARA LINEAR — {Nome da Feature}
+
+[RF-01] {título}
+Priority: {Urgent | High | Medium | Low}
+Description:
+  {critério de aceite}
+  Spec: docs/specs/{feature-slug}-v1.md
+Labels: feature
+
+[RF-02] ...
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+Se o usuário tiver o Linear MCP configurado (`linear` disponível como ferramenta), pergunte:
+```
+Detectei Linear disponível. Quer que eu crie as issues diretamente?
+→ Informe o team ID ou nome do projeto Linear.
+```
+
+---
+
+### 🔲 Jira
+
+Gere bloco formatado para importação:
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+TAREFAS PARA JIRA — {Nome da Feature}
+
+Summary: [{feature-slug}] RF-{N}: {título}
+Issue Type: Story
+Priority: {Highest | High | Medium | Low}
+Description:
+  h3. Critério de Aceite
+  {critério}
+
+  h3. Referência
+  Spec: docs/specs/{feature-slug}-v1.md
+Labels: feature
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+---
+
+### 📋 Outro
+
+Gere lista universal copiável:
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+TAREFAS — {Nome da Feature}
+Spec: docs/specs/{feature-slug}-v1.md
+
+{N} tarefas | P0: {X} | P1: {Y} | P2: {Z}
+
+ALTA PRIORIDADE (P0):
+□ {título} — {critério de aceite}
+□ {título} — {critério de aceite}
+
+MÉDIA PRIORIDADE (P1):
+□ {título} — {critério de aceite}
+
+BAIXA PRIORIDADE (P2):
+□ {título} — {critério de aceite}
+
+VALIDAÇÃO:
+□ Testes de aceitação — todos os critérios P0
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+---
+
+## Atualizar CHANGELOG
+
+Adicione ao `docs/CHANGELOG.md` (append no topo):
+
+```markdown
+## [{YYYY-MM-DD}] — Tarefas: {Nome da Feature}
+
+### Adicionado
+- {N} tarefas criadas em {plataforma} para `docs/specs/{feature-slug}-v1.md`
+  {P0: X alta / P1: Y média / P2: Z baixa}
+
+---
+```
+
+---
+
+## Confirmação final
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+✅ Feature {Nome da Feature} pronta para desenvolvimento!
+
+📄 Spec:    docs/specs/{feature-slug}-v1.md
+🤝 Handoff: docs/specs/{feature-slug}-handoff.md
+{SE LOCAL:}
+✅ Tarefas: docs/specs/{feature-slug}-tasks.md
+{SE GITHUB:}
+✅ Issues:  {N} issues criadas — {repo}/issues
+{SE LINEAR/JIRA/OUTRO:}
+✅ Tarefas: {N} tarefas formatadas acima
+
+Para iniciar o desenvolvimento:
+  /init → selecione o squad → informe: "implementar {feature-slug}"
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```

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

@@ -0,0 +1,34 @@
+---
+id: qf-02-contexto
+name: "Contexto Rápido"
+execution: inline
+model_tier: fast
+---
+
+# Contexto Rápido — Quick Fix
+
+Colete o contexto mínimo necessário antes de executar.
+
+Pergunte ao usuário:
+
+```
+O que precisa ser feito?
+(seja específico — isso vai direto para o agent executor)
+```
+
+Com a resposta, apresente um resumo de validação e aguarde confirmação:
+
+```
+CONTEXTO
+
+Objetivo: {o que foi descrito}
+Escopo: {o que está incluído}
+Fora do escopo: {o que NÃO deve ser tocado}
+Risco identificado: {se houver — senão "nenhum"}
+
+Prosseguir com este escopo?
+```
+
+Se confirmado → salve em `docs/quick-fix-contexto.md` e prossiga imediatamente.
+
+Se ajuste → colete o novo escopo e salve.

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

@@ -0,0 +1,49 @@
+---
+id: qf-03-executar
+name: "Decidir e Documentar"
+agent: priscila-produto
+execution: subagent
+model_tier: powerful
+output_files:
+  - quick-fix-output.md
+veto_conditions:
+  - "Decisão sem justificativa ou sem critérios de aceite mínimos"
+  - "Output vazio ou sem documento concreto"
+---
+
+# Execução Quick Fix — Produto
+
+Você é **Priscila Produto**, Product Manager. Tome a decisão ou ajuste descrito no contexto coletado e documente-a.
+
+## Regras do quick-fix
+
+- Foque **apenas** no que foi solicitado — sem expandir escopo
+- Toda decisão de produto precisa de: contexto, decisão, justificativa e critério de aceite mínimo
+- Se a decisão impactar outros times, registre no output quem precisa ser notificado
+- Se perceber conflito com decisões anteriores, registre mas não bloqueie — anote como risco
+
+## Output obrigatório
+
+Salve em `docs/quick-fix-output.md`:
+
+```markdown
+# Quick Fix Output — Produto
+Data: {YYYY-MM-DD}
+Objetivo: {o que foi decidido em 1 linha}
+
+## Decisão
+{a decisão tomada}
+
+## Justificativa
+{por que esta decisão}
+
+## Critérios de aceite
+- {CA mínimo 1}
+- {CA mínimo 2}
+
+## Impacto e dependências
+{outros times / componentes afetados — se houver}
+
+## Riscos identificados
+{conflitos com decisões anteriores ou incertezas — se houver}
+```

package/.synapos/squad-templates/produto/pipelines/steps/qf-04-registrar.md

@@ -0,0 +1,35 @@
+---
+id: qf-04-registrar
+name: "Registrar Decisão"
+execution: inline
+model_tier: fast
+output_files:
+  - quick-fix-log.md
+gate: GATE-5
+---
+
+# Registrar Decisão
+
+Consolide o quick fix para memória futura.
+
+Crie `docs/quick-fix-log.md`:
+
+```markdown
+# Quick Fix Log
+Data: {YYYY-MM-DD}
+Objetivo: {resumo em 1 linha}
+
+O que foi feito: {2-3 frases}
+Decisão técnica: {por que esta abordagem}
+Impacto: {o que isso afeta no sistema}
+```
+
+Adicione entrada em `docs/.squads/{slug}/_memory/memories.md`:
+
+```markdown
+## Quick Fix — {YYYY-MM-DD}
+{objetivo em 1 linha}
+Abordagem: {decisão técnica em 1 frase}
+```
+
+Pipeline concluído.

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

@@ -0,0 +1,59 @@
+---
+id: qs-02-contexto
+name: "Contexto e Problema"
+agent: priscila-produto
+execution: checkpoint
+output_files:
+  - business-context.md
+---
+
+# Contexto e Problema (Quick Spec)
+
+Colete o contexto necessário para a spec de forma direta.
+
+## Perguntas ao usuário
+
+```
+Vamos capturar o contexto rapidamente:
+
+1. Qual o problema que esta feature/produto resolve?
+   (seja específico: quem tem o problema, em que situação)
+
+2. Quem é o usuário principal afetado?
+
+3. Qual a solução proposta em 2-3 frases?
+
+4. O que está IN desta entrega (obrigatório)?
+
+5. O que está OUT (explicitamente fora)?
+
+6. Como vamos medir que deu certo?
+```
+
+## Gerar `docs/business/business-context.md`
+
+Com base nas respostas, crie:
+
+```markdown
+# Contexto de Negócio
+
+**Data:** {YYYY-MM-DD}
+
+## Problema
+{resposta da pergunta 1}
+
+## Usuário Afetado
+{resposta da pergunta 2}
+
+## Solução Proposta
+{resposta da pergunta 3}
+
+## Escopo
+**IN:** {resposta 4}
+**OUT:** {resposta 5}
+
+## Métricas de Sucesso
+{resposta 6}
+```
+
+Prossiga para a spec.

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

@@ -0,0 +1,67 @@
+---
+id: qs-03-spec
+name: "Spec e Critérios de Aceite"
+agent: priscila-produto
+execution: subagent
+model_tier: powerful
+output_files:
+  - spec.md
+veto_conditions:
+  - "Spec sem critérios de aceite"
+  - "Sem seção IN/OUT de escopo"
+on_reject: qs-03-spec
+---
+
+# Spec Rápida
+
+Você é **Priscila Produto**. Leia seu `.agent.md`.
+
+## Contexto disponível
+
+- `docs/business/business-context.md` ← leia antes de escrever
+
+## Documento a gerar
+
+### `docs/spec.md`
+
+```markdown
+# Spec: {nome da feature/produto}
+
+**Data:** {YYYY-MM-DD}
+**Status:** draft
+
+## Visão Geral
+{o que é, para quem, qual problema resolve — 1 parágrafo}
+
+## Escopo
+**IN:** {obrigatório para esta entrega}
+**OUT:** {explicitamente fora}
+
+## Features
+
+### {Feature 1}
+{descrição}
+
+**Critérios de Aceite:**
+```
+Dado {contexto}
+Quando {ação}
+Então {resultado}
+```
+
+**Casos de Borda:**
+- {edge case}
+
+### {Feature 2} ...
+
+## Dependências
+{o que precisa existir antes}
+
+## Métricas de Sucesso
+{como medir sucesso desta entrega}
+```
+
+## Critérios de qualidade
+- [ ] Toda feature tem ao menos 1 critério de aceite Dado/Quando/Então
+- [ ] Seções IN/OUT preenchidas
+- [ ] Nenhum critério de aceite vago