synapos 2.5.0

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

@@ -0,0 +1,49 @@
+---
+id: qs-05-handoff
+name: "Handoff Essencial"
+agent: tania-tecnica
+execution: subagent
+model_tier: powerful
+gate: GATE-2
+output_files:
+  - decisions-log.md
+  - handoff-checklist.md
+---
+
+# Handoff Essencial (Quick Spec)
+
+Você é **Tânia Técnica**. Leia seu `.agent.md`.
+
+## Contexto disponível
+
+- `docs/business/business-context.md`
+- `docs/spec.md`
+- `docs/requirements.md`
+
+## Documentos a gerar
+
+### `docs/decisions-log.md`
+
+```markdown
+# Decisions Log
+
+| Data | Decisão | Contexto | Responsável |
+|------|---------|---------|-------------|
+```
+
+### `docs/handoff-checklist.md`
+
+```markdown
+# Handoff Checklist (Quick Spec)
+
+**Data:** {YYYY-MM-DD}
+
+- [ ] Problema claramente definido
+- [ ] Usuário afetado identificado
+- [ ] Escopo IN/OUT explícito
+- [ ] Todas as features têm critérios de aceite
+- [ ] RF com prioridades
+- [ ] RNF com métricas numéricas
+- [ ] Dependências identificadas
+- [ ] Métricas de sucesso definidas
+```

package/.synapos/squad-templates/produto/pipelines/steps/rf-02-selecionar.md

@@ -0,0 +1,66 @@
+---
+id: rf-02-selecionar
+name: "Selecionar Doc e Escopo da Mudança"
+execution: checkpoint
+---
+
+# Selecionar Doc e Escopo da Mudança
+
+## Listar docs disponíveis
+
+Escaneie `docs/business/` e liste todos os arquivos `.md` encontrados, agrupados por subpasta.
+
+Apresente ao usuário:
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+REFINAR DOCS — Qual documento você quer atualizar?
+
+docs/business/
+  📄 business-context.md
+  📄 product-vision.md
+  📄 product-strategy.md
+  📄 competitive_landscape.md
+  📄 customer_communication.md
+  personas/
+    📄 user-personas.md
+    📄 customer-journey.md
+  research/
+    📄 market-analysis.md
+    📄 benchmarks.md
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+Aguarde o usuário selecionar o documento.
+
+---
+
+## Escopo da mudança
+
+Após a seleção, pergunte:
+
+```
+O que precisa mudar neste documento?
+
+Exemplos:
+- "Adicionar novo concorrente ao competitive_landscape"
+- "Atualizar persona principal com novo segmento"
+- "Revisar visão de produto para refletir pivô de estratégia"
+
+Descreva a mudança:
+```
+
+Aguarde a resposta.
+
+---
+
+## Registrar contexto
+
+Salve em `_memory/memories.md`:
+```markdown
+## Refinamento selecionado — {YYYY-MM-DD}
+Doc: {caminho do arquivo selecionado}
+Mudança: {descrição da mudança}
+```
+
+Prossiga para análise do delta.

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

@@ -0,0 +1,73 @@
+---
+id: rf-03-delta
+name: "Analisar Delta e Propor Mudança"
+agent: ana-analise
+execution: subagent
+model_tier: powerful
+---
+
+# Analisar Delta e Propor Mudança
+
+Você é **Ana Análise**. Leia seu `.agent.md` para aplicar sua persona completa.
+
+## REGRA FUNDAMENTAL
+
+**Nunca proponha reescrever o documento inteiro.**
+O objetivo é um delta cirúrgico — apenas o que mudou, com justificativa clara.
+
+## Contexto disponível
+
+- `_memory/memories.md` — doc selecionado e descrição da mudança
+- O arquivo selecionado (leia seu conteúdo completo)
+- `docs/business/product-vision.md` — para verificar consistência
+
+## Sua missão
+
+1. Leia o documento atual na íntegra
+2. Entenda o que existe hoje
+3. Analise o que precisa mudar com base na solicitação
+4. Verifique se a mudança é consistente com os outros docs de produto
+5. Proponha o delta de forma explícita
+
+## Apresentar proposta ao usuário (checkpoint)
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+PROPOSTA DE MUDANÇA: {nome do doc}
+
+📄 Documento: {caminho}
+✏️  Mudança solicitada: {resumo}
+
+O QUE MUDA:
+{seção afetada}
+
+ANTES:
+{trecho atual relevante}
+
+DEPOIS:
+{trecho proposto}
+
+{SE MAIS DE UMA MUDANÇA, repita o bloco acima}
+
+⚠️  Impacto em outros docs:
+{se a mudança implica atualizar outros docs, liste aqui}
+{se não há impacto: "Nenhum"}
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+Aprovar este delta?
+
+✅ Aprovar e criar versão
+✏️  Ajustar a proposta
+❌ Cancelar
+```
+
+Aguarde aprovação antes de prosseguir.
+
+Se o usuário ajustar, refine a proposta e reapresente. Não crie nenhum arquivo antes da aprovação.
+
+Salve delta aprovado em `_memory/memories.md`:
+```markdown
+## Delta aprovado — {YYYY-MM-DD}
+Doc: {caminho}
+Delta: {resumo do que muda}
+```

package/.synapos/squad-templates/produto/pipelines/steps/rf-04-criar-versao.md

@@ -0,0 +1,86 @@
+---
+id: rf-04-criar-versao
+name: "Criar Versão e Registrar"
+agent: tania-tecnica
+execution: subagent
+model_tier: fast
+---
+
+# Criar Versão e Registrar
+
+Você é **Tânia Técnica**.
+
+## REGRA FUNDAMENTAL
+
+**Nunca sobrescreva o arquivo original.**
+Crie sempre uma nova versão numerada. O original permanece intacto como histórico.
+
+## Contexto disponível
+
+- `_memory/memories.md` — doc original e delta aprovado
+
+## Tarefas
+
+### 1. Determinar versão
+
+Leia o arquivo original: `docs/business/{nome-do-doc}.md`
+
+Verifique se já existem versões anteriores (ex: `{nome-do-doc}-v2.md`, `{nome-do-doc}-v3.md`).
+
+A nova versão será: `{nome-do-doc}-v{N+1}.md`
+- Se o arquivo original é a v1 implícita e não há outras: criar `-v2.md`
+- Se já existe `-v2.md`: criar `-v3.md`
+- E assim por diante
+
+### 2. Criar o arquivo versionado
+
+Crie `docs/business/{nome-do-doc}-v{N}.md` com:
+- Todo o conteúdo do documento original
+- Delta aplicado nas seções correspondentes
+- Cabeçalho de versão no topo:
+
+```markdown
+> **Versão {N}** — {YYYY-MM-DD}
+> Substituiu: [{nome-do-doc}-v{N-1}.md](./{nome-do-doc}-v{N-1}.md) | Alteração: {resumo do delta em 1 linha}
+
+---
+
+{conteúdo completo com delta aplicado}
+```
+
+### 3. Atualizar `docs/business/index.md`
+
+Apenas adicione ao final da seção correspondente — nunca modifique entradas existentes:
+
+```markdown
+| [{nome-do-doc}](/{nome-do-doc}-v{N}.md) | v{N} | {YYYY-MM-DD} | {resumo do delta} |
+```
+
+### 4. Atualizar `docs/CHANGELOG.md`
+
+Adicione no topo — nunca modifique entradas existentes:
+
+```markdown
+## [{YYYY-MM-DD}] — Refinamento: {nome-do-doc}
+
+### Modificado
+- `docs/business/{nome-do-doc}-v{N}.md` — {resumo do delta}
+- Original preservado em: `docs/business/{nome-do-doc}.md` (v1) ou `v{N-1}.md`
+
+---
+```
+
+## Confirmação
+
+```
+✅ Versão criada com sucesso!
+
+📄 Nova versão: docs/business/{nome-do-doc}-v{N}.md
+📄 Original preservado: docs/business/{nome-do-doc}.md
+📋 Index atualizado: docs/business/index.md
+📝 Changelog: docs/CHANGELOG.md
+
+{SE HOUVER IMPACTO EM OUTROS DOCS}
+⚠️  Verificar manualmente:
+  - {doc que pode precisar de atualização}
+```

package/.synapos/squad-templates/produto/template.yaml

@@ -0,0 +1,91 @@
+name: produto
+displayName: "Squad de Produto"
+icon: "📋"
+version: "2.0.0"
+description: "Refina e versiona a documentação de produto. Requer docs/business/ criada pelo /setup:build-business. Nunca sobrescreve — apenas versiona."
+
+agents:
+  base:
+    - id: priscila-produto
+      file: agents/priscila-produto.agent.md
+      displayName: "Priscila Produto"
+      icon: "📋"
+      role: "Product Manager"
+    - id: ana-analise
+      file: agents/ana-analise.agent.md
+      displayName: "Ana Análise"
+      icon: "📊"
+      role: "Analista de Negócio"
+    - id: tania-tecnica
+      file: agents/tania-tecnica.agent.md
+      displayName: "Tânia Técnica"
+      icon: "✍️"
+      role: "Tech Writer"
+  optional:
+    - id: leo-engenheiro
+      file: ../engineer/agents/leo-engenheiro.agent.md
+      displayName: "Leo Engenheiro"
+      icon: "🧠"
+      role: "Lead Engineer — Investigação e Arquitetura"
+    - id: paulo-pesquisa
+      file: agents/paulo-pesquisa.agent.md
+      displayName: "Paulo Pesquisa"
+      icon: "🔍"
+      role: "Pesquisador"
+    - id: eduardo-estrategia
+      file: agents/eduardo-estrategia.agent.md
+      displayName: "Eduardo Estratégia"
+      icon: "🎯"
+      role: "Estrategista"
+    - id: ursula-ux
+      file: agents/ursula-ux.agent.md
+      displayName: "Úrsula UX"
+      icon: "🎨"
+      role: "UX Researcher"
+
+pre_pipeline:
+  available: true
+  file: ../../core/pipelines/pre-execution.yaml
+  agent: priscila-produto
+
+pipelines:
+  default: nova-feature
+  available:
+    - id: nova-feature
+      name: "Nova Feature"
+      description: "Valida requisito → verifica docs → gera spec versionada → handoff para dev"
+      file: pipelines/nova-feature.yaml
+    - id: refinar-docs
+      name: "Refinar Docs"
+      description: "Versiona um doc existente em docs/business/ preservando o original"
+      file: pipelines/refinar-docs.yaml
+    - id: discovery-spec-handoff
+      name: "Discovery → Spec → Handoff"
+      description: "Fluxo completo de discovery: pesquisa de mercado, personas, spec completa e handoff para dev"
+      file: pipelines/discovery-spec-handoff.yaml
+    - id: quick-spec
+      name: "Spec Rápida"
+      description: "Fluxo direto para features bem definidas: contexto → spec → requisitos → handoff"
+      file: pipelines/quick-spec.yaml
+    - id: quick-fix
+      name: "Quick Fix"
+      description: "Decisão ou ajuste pontual de produto — contexto → decisão → registro"
+      file: pipelines/quick-fix.yaml
+
+performance_modes:
+  alta:
+    description: "Verificação aprofundada de restrições, spec completa com todos os campos, handoff detalhado"
+    docs:
+      - docs/specs/{feature-slug}-v1.md
+      - docs/specs/{feature-slug}-handoff.md
+      - docs/business/index.md        # append
+      - docs/CHANGELOG.md             # append
+  economico:
+    description: "Spec essencial com RFs, critérios de aceite e handoff mínimo"
+    docs:
+      - docs/specs/{feature-slug}-v1.md
+      - docs/CHANGELOG.md             # append
+  solo:
+    description: "Para dev solo — sem checkpoints de aprovação, decisões diretas documentadas"
+    docs:
+      - docs/specs/{feature-slug}-v1.md

package/README.md

@@ -0,0 +1,285 @@
+# Synapos
+
+> AI Agent Orchestration Framework for Software Development
+
+Instale squads de agentes de IA no seu projeto com um comando.
+Eles planejam, executam, validam e documentam features completas — com gates de qualidade e memória persistente.
+
+```bash
+npx synapos
+```
+
+---
+
+## ⚡ Teste em 2 minutos
+
+```bash
+npx synapos front
+```
+
+Depois, na sua IDE:
+
+```
+/init → escolha "quick-fix"
+```
+
+✅ Um squad de IA começa a trabalhar no seu código
+✅ Com contexto real do projeto
+✅ Seguindo padrões e validações
+
+---
+
+## 🤯 O que é isso?
+
+Synapos não é só um “agent”.
+
+É um **runtime de squads de IA** que trabalham como um time de engenharia:
+
+* 🧠 Pensam (arquitetura, decisões)
+* ⚙️ Implementam (código real)
+* 🔍 Validam (gates, testes, review)
+* 📝 Documentam (automaticamente)
+
+---
+
+## 🧩 Como funciona
+
+```
+Você → /init
+      ↓
+Orquestrador cria um squad
+      ↓
+Pipeline executa steps
+      ↓
+Agents + Gates + Memória + Checkpoints
+```
+
+---
+
+## 🔥 Por que isso é diferente?
+
+### ❌ Antes (IA comum)
+
+* Respostas isoladas
+* Sem memória real
+* Sem processo
+* Sem validação
+
+### ✅ Com Synapos
+
+* Squads especializados por domínio
+* Pipelines estruturados
+* Gates que bloqueiam código ruim
+* Memória persistente por feature
+* Execução contínua (não só chat)
+
+---
+
+## 🧠 Squads prontos
+
+Instale times completos com um comando:
+
+```bash
+npx synapos front
+npx synapos back
+npx synapos full
+npx synapos produto
+```
+
+Cada squad inclui:
+
+* Arquiteto
+* Dev
+* Reviewer
+* (opcional) UX, testes, segurança, etc.
+
+---
+
+## ⚙️ Multi-IDE (onde você já trabalha)
+
+Funciona direto na sua stack:
+
+* Claude Code
+* Cursor
+* Trae
+* OpenCode
+* Antigravity
+
+---
+
+## 🧠 Memória persistente (game changer)
+
+Cada feature cria uma session:
+
+```
+docs/.squads/sessions/{feature}/
+```
+
+Com:
+
+* contexto
+* arquitetura
+* plano
+* decisões
+* aprendizados
+
+👉 Seus agents **não esquecem o que fizeram**
+
+---
+
+## 📚 Fluxo de documentação (o diferencial invisível)
+
+A maioria das ferramentas de IA ignora documentação.
+
+O Synapos trata documentação como **parte do processo**, não como algo opcional.
+
+Cada execução:
+
+* gera contexto estruturado
+* registra decisões arquiteturais
+* mantém histórico da feature
+* acumula aprendizados automaticamente
+
+Isso cria um efeito poderoso:
+
+👉 o projeto fica **cada vez mais inteligente com o tempo**
+
+---
+
+### ❌ Sem Synapos
+
+* documentação desatualizada
+* decisões perdidas
+* contexto fragmentado
+
+### ✅ Com Synapos
+
+* documentação viva e versionada
+* contexto compartilhado entre squads
+* onboarding muito mais rápido
+
+👉 Não é só sobre gerar código.
+👉 É sobre **construir conhecimento do projeto continuamente**.
+
+---
+
+## 🚧 Gates (qualidade obrigatória)
+
+Nada passa sem validação:
+
+* GATE-0 → integridade do projeto
+* GATE-ADR → respeita arquitetura
+* GATE-DESIGN → qualidade visual
+* GATE-DECISION → evita decisões ocultas
+
+👉 "Fail loud. Never silent."
+
+---
+
+## ⚡ Modos de execução
+
+* **Alta Performance** → completo + checkpoints
+* **Econômico** → rápido e direto
+* **Solo** → sem interrupções
+
+---
+
+## 🧪 Casos reais
+
+### Criar feature completa
+
+```
+/init → frontend → feature-development
+```
+
+### Corrigir bug
+
+```
+/init → backend → bug-fix
+```
+
+### Ajuste rápido
+
+```
+/init → quick-fix
+```
+
+---
+
+## 🧠 Configuração de modelo
+
+Compatível com qualquer modelo:
+
+* Claude
+* GPT
+* Gemini
+* modelos locais
+
+Com otimização automática de contexto:
+
+* high → máximo contexto
+* standard → balanceado
+* lite → até -70% de tokens
+
+---
+
+## 🔌 Skills (integrações)
+
+* GitHub (PRs, issues)
+* Browser (testes E2E)
+* Web search
+* Filesystem
+
+---
+
+## 🏗️ Estrutura gerada
+
+```
+.synapos/   → core do framework
+docs/       → memória + contexto
+.squads/    → execução por feature
+```
+
+---
+
+## 💡 Visão
+
+Synapos é um passo na direção de:
+
+> desenvolvimento de software onde humanos definem o problema
+> e squads de IA executam com qualidade e contexto
+
+---
+
+## 🚀 Roadmap
+
+* [ ] Dashboard visual de pipelines
+* [ ] Synapos Cloud
+* [ ] Marketplace de agents
+* [ ] Observabilidade de execução
+
+---
+
+## ⭐ Contribua
+
+Esse projeto é open source e está evoluindo rápido.
+
+Se você acredita no futuro de AI-native development:
+👉 dê uma estrela
+👉 abra uma issue
+👉 contribua
+
+---
+
+## 📦 Instalação
+
+```bash
+npx synapos
+```
+
+---
+
+## 🧠 TL;DR
+
+Você não usa mais um agent.
+Você roda um **time inteiro de IA no seu projeto**.