SINAPSE AI

English | Portugues

175 agentes de IA. 18 squads especializados. Uma CLI.

O SINAPSE AI e um framework open source que organiza agentes de IA em squads especializados para resolver problemas reais de negocios, marketing, desenvolvimento, copy, design e mais. Funciona direto no seu terminal com Claude Code, Codex CLI ou qualquer IDE compativel.

O que e o SINAPSE AI

O SINAPSE AI nao e mais um chatbot. E um sistema de orquestracao onde cada agente tem um papel claro, cada squad domina uma disciplina, e tudo funciona via CLI.

O que voce ganha ao instalar:

• 18 orquestradores de squad (orqx) prontos para ativar direto no terminal
• 175 agentes especializados com knowledge bases proprias
• Workflows completos de planejamento, desenvolvimento, QA e deploy
• Documentation-First Development com pipeline automatico de epics, stories e validacao
• Compatibilidade multi-IDE: Claude Code e Codex CLI

Arquitetura: CLI First

CLI First > Observability Second > UI Third

Toda inteligencia vive na CLI. Dashboards observam. A UI nunca e requisito.

Instalacao (2 minutos)

# Novo projeto
npx sinapse-ai init meu-projeto

# Projeto existente
cd seu-projeto && npx sinapse-ai install

# Atualizar instalacao existente
npx sinapse-ai@latest install

O wizard detecta seu ambiente, configura sua IDE, instala os squads e ativa o Chrome Brain (browser automation) automaticamente.

# Diagnostico
npx sinapse-ai doctor

# Informacoes do sistema
npx sinapse-ai info

Requisitos: Node.js 18+ (v20+ recomendado)

Squads Disponiveis

Cada squad e uma equipe de agentes especializados com knowledge base, workflows e tasks proprias. Todos os squads sao gratuitos e open source.

| Squad | Foco | Agentes | |-------|------|---------| | squad-brand | Estrategia de marca, arquetipos, auditoria | 15 | | squad-copy | Copywriting persuasivo, headlines, conversao | 14 | | squad-council | Advisors estrategicos (Munger, Dalio, Thiel) | 11 | | squad-storytelling | Narrativa, roteiros, frameworks de historia | 11 | | squad-commercial | Vendas, funil, revenue, pipeline | 11 | | squad-animations | Motion design, CSS, particulas, 3D | 9 | | squad-paidmedia | Meta Ads, Google Ads, campanhas, otimizacao | 10 | | squad-claude | Claude Code, MCP, integracao avancada | 10 | | squad-cloning | Clonagem cognitiva, mind synthesis | 9 | | squad-courses | Cursos, curriculos, assessments, launch | 8 | | squad-cybersecurity | Seguranca, threat intel, pentest | 9 | | squad-design | Design systems, componentes, tokens | 15 | | squad-content | Governanca editorial, estrategia de conteudo | 7 | | squad-product | Product discovery, estrategia, operacoes | 7 | | squad-research | Market analysis, inteligencia competitiva | 8 | | squad-growth | Analytics, CRO, SEO, growth hacking | 7 | | squad-finance | Budget, pricing, profitability analysis | 5 | | claude-code-mastery | Dominio avancado do Claude Code | 8 |

Total: 18 squads, 175 agentes especializados

Chrome Brain — Browser Automation

Todos os agentes do SINAPSE podem controlar o Chrome em tempo real: navegar sites, clonar paginas, preencher formularios, auditar performance e extrair dados.

Instalado automaticamente pelo wizard. Zero configuracao manual.

# Verificar status
sinapse chrome-brain status

# Reinstalar/atualizar
sinapse chrome-brain install

Como funciona:

1. Voce diz: "abre o site google.com"
2. Chrome Brain auto-ativa (sem comando manual)
3. Chrome inicia automaticamente na porta 9222
4. Agente usa 29 tools do Chrome DevTools MCP
5. Resultado entregue ao squad do dominio

Suporte: macOS, Linux, Windows (Git Bash/WSL)

Como Usar

No Claude Code

Ative qualquer orquestrador pelo nome:

/sinapse            # Orquestrador principal
@brand-orqx         # Squad de brand
@copy-orqx          # Squad de copy
@research-orqx      # Squad de research

Ou use os agentes de desenvolvimento:

@developer           # Implementacao de codigo
@quality-gate        # Testes e qualidade
@architect           # Arquitetura e design
@sprint-lead         # Criacao de stories
@product-lead        # Validacao de stories
@project-lead        # Product management
@analyst             # Pesquisa e analise
@data-engineer       # Database design
@devops              # CI/CD e git push (exclusivo)

No Codex CLI

/skills              # Lista todos os agentes disponiveis
sinapse-dev          # Ativa o developer
sinapse-architect    # Ativa o architect

Comandos dos Agentes

Dentro de qualquer agente, use * para comandos:

*help                # Comandos disponiveis
*create-story        # Criar story de desenvolvimento
*task <nome>         # Executar task especifica
*exit                # Sair do agente

Agentes de Desenvolvimento

O SINAPSE vem com 12 agentes core para o ciclo completo de desenvolvimento:

| Agente | Persona | Escopo | |--------|---------|--------| | sinapse-orqx | Imperator | Orquestrador principal de todos os squads | | developer | Dex | Implementacao de codigo | | quality-gate | Quinn | Testes, QA e quality gates | | architect | Aria | Arquitetura e design tecnico | | project-lead | Morgan | Product management e epics | | product-lead | Pax | Validacao de stories e backlog | | sprint-lead | River | Criacao de stories e sprints | | analyst | Alex | Pesquisa e analise de negocios | | data-engineer | Dara | Database design e migrations | | ux-design-expert | Uma | UX/UI design e experiencia | | devops | Gage | CI/CD, git push (exclusivo) | | squad-creator | - | Criacao de novos squads |

Workflow de Desenvolvimento

@sprint-lead cria story > @product-lead valida > @developer implementa > @quality-gate testa > @devops push

Documentation-First Development

Todo desenvolvimento no SINAPSE segue o pipeline de documentacao automatico (NON-NEGOTIABLE):

1. Epic definida para cada iniciativa
2. Stories em docs/stories/ com acceptance criteria claros
3. Validacao por @product-lead antes de qualquer codigo
4. Progresso rastreado via checkboxes [ ] > [x]
5. File List mantida atualizada na story
6. Quality gates automaticos antes de merge

Criando Seu Proprio Squad

Qualquer pessoa pode criar um squad para qualquer dominio:

squads/meu-squad/
  squad.yaml            # Manifesto do squad
  agents/               # Agentes especializados
  knowledge-base/       # Base de conhecimento
  tasks/                # Tasks executaveis
  workflows/            # Workflows do squad

Use @squad-creator ou veja o Guia de Squads.

Claude Code vs Codex CLI — Comparativo Completo

O SINAPSE funciona em ambas as IDEs. Ambas suportam a maioria das funcionalidades com abordagens diferentes.

Funcionalidades

| Funcionalidade | Claude Code | Codex CLI | Notas | |---------------|:-----------:|:---------:|-------| | 18 squads com 175 agentes | SIM | SIM | Identico em ambas | | Knowledge bases por squad | SIM | SIM | Identico em ambas | | Tasks e workflows | SIM | SIM | Identico em ambas | | Documentation-First Development | SIM | SIM | Identico em ambas | | Agent commands (*help, *task) | SIM | SIM | Identico em ambas | | Squad awareness auto-routing | SIM | SIM | Identico em ambas | | NSN Mode (Never Say Never) | SIM | SIM | Regra global em ambas | | Chrome Brain (browser automation) | SIM | SIM | Claude: hooks auto-launch. Codex: via MCP ou chrome-cdp-skill | | MCP servers | SIM | SIM | Claude: ~/.claude.json. Codex: config.toml ou codex mcp add | | Hooks (PreToolUse / PostToolUse) | SIM | PARCIAL | Codex: so Bash tool, desabilitado no Windows | | Agent handoff protocol | SIM | SIM | Via instructions + skills em ambas | | SYNAPSE context engine | SIM | PARCIAL | Codex: via instructions.md + skills (sem regras dinamicas) | | Skills system nativo | NAO | SIM | Codex tem $skill-name com progressive disclosure | | Multi-model (Claude + outros) | NAO | SIM | Codex suporta qualquer modelo OpenAI | | Subagents paralelos | SIM | SIM | Codex: max 6 threads configuraveis | | CI/CD non-interactive | NAO | SIM | Codex: codex exec com --json |

Como Ativar Agentes

| Acao | Claude Code | Codex CLI | |------|-------------|-----------| | Orquestrador principal | /SINAPSE:agents:sinapse-orqx | @sinapse-orqx ou $sinapse-orqx | | Squad de brand | @brand-orqx | @brand-orqx ou $sinapse-brand | | Squad de copy | @copy-orqx | @copy-orqx ou $sinapse-copy | | Developer | @developer | @developer ou $sinapse-dev | | Listar agentes | @sinapse-orqx *help | /skills | | Chrome Brain | Auto-ativa por prompt | codex mcp add chrome-devtools |

Onde Cada IDE Brilha

Claude Code — Experiencia mais integrada:

• Chrome Brain auto-ativa por hooks (zero configuracao manual)
• Context engine injeta regras automaticamente por dominio e arquivo
• Deny/allow rules protegem arquivos deterministicamente
• Maior ecossistema de MCP servers (Figma, Supabase, Notion, etc.)

Codex CLI — Mais flexivel e extensivel:

• Skills nativas com $skill-name e progressive disclosure
• Suporta qualquer modelo OpenAI (nao apenas Claude)
• codex exec para automacao CI/CD sem interacao
• Pode rodar como MCP server (outros agentes invocam Codex)
• Profiles para alternar configuracoes rapidamente
• Subagents com max 6 threads paralelos

Setup Chrome Brain no Codex CLI

# Adicionar Chrome DevTools MCP ao Codex
codex mcp add chrome-devtools -- npx chrome-devtools-mcp@latest

# OU instalar a skill chrome-cdp (conexao direta, sem Puppeteer)
# pi install git:github.com/pasky/[email protected]

Recomendacao

Claude Code para quem quer a experiencia mais integrada e automatizada — Chrome Brain auto-ativa, hooks rodam sozinhos, context engine injeta regras.

Codex CLI para quem quer flexibilidade de modelo, skills nativas, e automacao CI/CD — com setup manual minimo para Chrome Brain.

CLI

npx sinapse-ai init <projeto>      # Criar projeto
npx sinapse-ai install             # Instalar no projeto atual
npx sinapse-ai update              # Atualizar
npx sinapse-ai doctor              # Diagnostico
npx sinapse-ai doctor --fix        # Corrigir problemas
npx sinapse-ai info                # Info do sistema
npx sinapse-ai uninstall           # Remover
sinapse chrome-brain install       # Instalar Chrome Brain
sinapse chrome-brain status        # Status do Chrome Brain

Qualidade e Validacao

npm run lint           # ESLint
npm run typecheck      # TypeScript
npm test               # Testes
npm run test:coverage  # Cobertura

Pre-commit e pre-push hooks validam automaticamente.

Documentacao

| Recurso | Link | |---------|------| | Guia do Usuario | docs/guides/user-guide.md | | Arquitetura | docs/pt/architecture/ | | Guia de Squads | docs/guides/squads-guide.md | | Primeiros Passos | docs/getting-started.md | | Troubleshooting | docs/troubleshooting.md | | Principios | docs/GUIDING-PRINCIPLES.md |

Contribuindo

git clone https://github.com/SinapseAI/sinapse-ai.git
cd sinapse-ai && npm install

1. Fork o repositorio
2. Crie sua branch (git checkout -b feat/minha-feature)
3. Commit (git commit -m 'feat: descricao')
4. Push (git push origin feat/minha-feature)
5. Abra um Pull Request

Veja CONTRIBUTING.md para detalhes.

Legal

| Doc | Link | |-----|------| | Licenca | MIT | | Privacidade | Privacy | | Termos | Terms | | Conduta | Code of Conduct | | Seguranca | Security |

Contribuidores

Construido para quem constroi.

Voltar ao topo