$ cat synapos/README.md

Synapos — Estruturação de fluxo de desenvolvimento com IA

Uma única IA que trabalha por meio de roles especializadas. O valor está na mudança estruturada de perspectiva — produto, arquitetura, desenvolvimento, revisão — cada uma com o contexto, a memória e as skills certas.

4.1.0
versão: 8
domínios de role: 3
tracks de execução: 5
skills instaladas

github ↗

$ cat problem.md

Problema

Uso de IA sem contexto gera:

inconsistência
retrabalho
perda de continuidade

$ cat solution.md

Solução

Sistema para organizar:

Contexto: Contexto mínimo suficiente: cada etapa recebe só o que a decisão exige, e todo arquivo carregado precisa de um motivo.
Memória: Decisões, regras e aprendizados que o código não mostra, guardados em camadas: global, role e feature.
Execução: Pipelines por domínio, com handoff entre roles: cada uma deixa um artefato que a próxima lê, sem reconstruir o trabalho.
Revisão: Gates de qualidade em pontos críticos e ADRs tratadas como contrato arquitetural.

$ synapos flow

Como funciona

Uma feature passa por papéis diferentes, na ordem em que a decisão amadurece:

Produto: Brainstorm, requisitos e spec com critérios de aceite.
Arquitetura: Investigação, padrões do projeto, arquitetura e plano em fases.
Desenvolvimento: Implementação fase a fase, com validação ao fim de cada uma.
Review: Revisão em camadas, começando pela consistência com o projeto.

$ synapos triage

Profundidade adaptativa

A triagem define o track pela tarefa, não pelo squad:

quick: mudança localizada, sem decisão nova: texto, estilo, fix óbvio.
standard: feature ou bug em território conhecido.
complex: ideia vaga, nova capacidade, vários domínios ou impacto em ADR; começa pelo Produto.

$ synapos gates

Gates de qualidade

Cada gate faz uma verificação concreta sobre um artefato. Falha é sempre explícita; depois de 2 reexecuções automáticas, quem decide é o usuário.

integridade do framework
estrutura do output
qualidade e vetos
critérios de sucesso
decisões pendentes
conformidade com ADRs
completude do handoff

$ synapos memory

Memória em camadas

Aprender o projeto uma vez, recuperar só o que a decisão atual precisa:

Global: identidade, stack, decisões e regras do projeto inteiro.
Role: padrões, catálogo de reuso e convenções de cada domínio.
Feature: contexto, spec, arquitetura, plano e revisão de uma feature.
Tarefa: o contexto do passo atual, que não é persistido.

$ ls squad-templates

Roles disponíveis

Templates de squad para cada domínio:

Produto
Frontend
Backend
Fullstack
Mobile
DevOps / Infra
IA / Dados
Engineer

$ ls skills

Skills

Ferramentas que o Synapos descobre e carrega por etapa:

brave-search
fetch-url
filesystem
github
playwright-browser

$ cat role.md

Meu papel

Meu papel:

concepção
arquitetura
validação
evolução

$ git log --synapos

Na prática

Este portfólio foi evoluído pelo próprio Synapos: brainstorm, requisitos, spec e visual-spec pelo squad de Produto; investigação, arquitetura, plano, implementação em 6 fases e review pelo squad de Frontend. Cada etapa deixou um artefato no repositório.

$ cat result.md

Resultado esperado

Resultado esperado:

consistência
menos retrabalho
continuidade entre sessões