sinapse-ai

Orquestre trabalho especializado. Preserve o controle da engenharia.

17 squads · 172 agentes · Claude Code + Codex · 11 artigos de governança

English · Primeiros passos · npm · Discussões

SINAPSE AI é um framework de orquestração que instala agentes, skills, regras e
quality gates diretamente no seu projeto. Claude Code e Codex passam a trabalhar
com o mesmo catálogo, o mesmo processo de engenharia e autoridades explícitas.

Ele não substitui sua CLI ou sua LLM. Ele transforma uma sessão de IA em um
sistema de trabalho auditável: briefing, roteamento, story, implementação, QA e
entrega.

Instale com um comando

No diretório do projeto:

npx sinapse-ai@latest install

Sem flags, uma instalação nova configura Claude Code e Codex. Uma nova
execução preserva a seleção salva e o conteúdo que pertence ao projeto.

Depois, ative o orquestrador:

Ou chame um especialista diretamente:

Requisitos: Node.js 18+, npm 9+ e pelo menos uma das CLIs suportadas.

Do pedido a entrega

flowchart LR
  A[Briefing] --> B[Orquestrador]
  B --> C[Especialista]
  C --> D[Story validada]
  D --> E[Implementação]
  E --> F[QA e gates]
  F --> G[PR e entrega]

Você: "Audite este fluxo de checkout e corrija os riscos encontrados."

SINAPSE
  -> classifica projeto, superfície e risco
  -> roteia arquitetura, produto, desenvolvimento e QA
  -> exige uma story pronta antes da implementação
  -> valida testes, segurança e paridade entre providers
  -> entrega evidências, não apenas uma resposta

Por que SINAPSE

Governança executável

A Constituição de 11 artigos define story-first, autoridade por papel,
qualidade, segurança, colaboração e defaults conservadores. Hooks e validadores
transformam essas regras em gates reais.

Paridade Claude Code + Codex

O catálogo canônico gera superfícies nativas para as duas CLIs. Os adapters são
validados contra drift; o provider muda, o contrato de trabalho permanece.

Especialização coordenada

Os 17 squads cobrem engenharia, produto, design, segurança, growth, conteúdo,
finanças e operações. Orquestradores roteiam; especialistas executam dentro de
limites claros.

O que é instalado

O inventário atual contém 1.201 squad tasks, 211 development tasks,
1.412 task files e 1.348 ponteiros resolvíveis em runtime.

Esses números são medidos a partir do repositório. Verifique o estado atual com:

node .codex/scripts/resolve-codex-agent.js --stats
npm run validate:parity

Casos de uso

• Produto novo: discovery, arquitetura, stories, implementação e gate de QA.
• Brownfield: diagnóstico de dívida, risco e plano incremental antes de editar.
• Frontend: design system, acessibilidade, React Bits e motion com reduced motion.
• Segurança: threat modeling, validação de secrets, RLS e revisão pre-deploy.
• Operação: GitHub Flow, CI, releases, documentação e rastreabilidade.

Operação segura

# Instalar ou atualizar preservando customizações do projeto
npx sinapse-ai@latest install

# Diagnosticar o ambiente
npx sinapse-ai@latest doctor

# Aplicar correções seguras encontradas pelo diagnóstico
npx sinapse-ai@latest doctor --fix

# Ver a superfície instalada
npx sinapse-ai@latest status

Use install --llm=claude-code ou install --llm=codex somente para uma
instalação deliberadamente restrita. Use install --reconfigure para trocar a
seleção existente e install --force para renovar superfícies gerenciadas.

Modelo de propriedade e responsabilidades

Reexecuções renovam superfícies gerenciadas sem tratar o código do projeto
como descartável. Consulte a política de instalação.

Documentação

Produto e comunidade

• Roadmap: direção pública, sem promessas artificiais de prazo.
• Governança: decisões, papéis e política de mudança.
• Discussões: dúvidas e propostas abertas.
• Issues: bugs reproduzíveis e trabalho rastreável.
• Changelog: histórico de releases.

Contribuições passam por branch curta, PR, story quando aplicável e gates
automatizados. Veja CONTRIBUTING.md.

Licença

Distribuído sob a licença MIT. Atribuições de trabalhos derivados e
avisos de marcas estão em NOTICE.md.