![\"Versão](\"https://img.shields.io/npm/v/sinapse-ai?color=00B894&label=npm\")
\n ![\"CI\"](\"https://github.com/caioimori/sinapse-ai/actions/workflows/ci.yml/badge.svg\"){kind=icon}
\n ![\"Licença](\"https://img.shields.io/badge/license-MIT-0EA5E9.svg\"){kind=icon}
\n ![\"Node](\"https://img.shields.io/badge/node-%3E%3D18-22C55E.svg\"){kind=icon}
\n\n \n \n \n
Uma equipe de IA governada para Claude Code e Codex.
\n\n\n 17 squads · 172 agentes · 1.412 task files · 1.348 ponteiros resolvíveis\n
\n\nEnglish · Documentação · npm · Issues
\n\n---\n\n```text\n S I N A P S E\n specialized work, one governed system\n```\n\nSINAPSE organiza trabalho de produto, engenharia, design, growth, segurança e\noperação em especialistas coordenados. Ele não troca sua LLM: instala a camada\nde agentes, skills, regras e quality gates que torna Claude Code e Codex\nconsistentes dentro do projeto.\n\n## Comece com um comando\n\nNo diretório do projeto, execute:\n\n```bash\nnpx sinapse-ai@latest install\n```\n\nEsse é o caminho canônico para instalações novas ou sem provider salvo. Sem\nflags, ele configura **Claude Code e Codex**; repetições preservam o provider\nsalvo e o conteúdo do projeto. Para limitar conscientemente a um provider, use\n`--llm=claude-code` ou `--llm=codex`; use `--reconfigure` para mudar uma seleção existente.\n\n```text\ninstall -> agentes e skills nativos -> regras e hooks -> projeto pronto\n```\n\n| Depois da instalação | Claude Code | Codex |\n|---|---|---|\n| Orquestrador | `@sinapse-orqx` | `$snps` |\n| Especialista | `@developer` | `$sinapse-agent developer` |\n| Reconfigurar providers | `npx sinapse-ai@latest install --reconfigure` | mesmo comando |\n\n## O que entra no seu projeto\n\n| Superfície | Claude Code | Codex |\n|---|:---:|:---:|\n| Agentes canônicos | 172 | 172 |\n| Skills instaladas | 37 | 37 |\n| Hooks registrados | 20 registros | 9 eventos |\n| React Bits | Skill + corpus de 9 arquivos | Skill + corpus de 9 arquivos |\n\nO catálogo tem 17 squads e 172 agentes especializados. O runtime mede 1.201\nsquad tasks, 211 development tasks, 1.412 task files e 1.348 ponteiros\nresolvíveis. React Bits está incluído como capacidade de frontend, com um\nsnapshot pesquisável de 139 componentes e regras de desempenho, acessibilidade\ne movimento reduzido.\n\n## Como o trabalho flui\n\n```mermaid\nflowchart LR\n A[Briefing] --> B[Orquestrador]\n B --> C[Especialista]\n C --> D[Story Ready]\n D --> E[Implementação]\n E --> F[QA e gates]\n F --> G[Entrega]\n```\n\nO framework aplica uma Constitution com 11 artigos: documentação antes de\ncódigo, autoridade clara por agente, segurança, qualidade e colaboração segura.\nO orquestrador roteia; especialistas executam; o processo deixa evidências.\n\n## Comandos essenciais\n\n```bash\n# Instalar ou sincronizar os dois providers no projeto atual\nnpx sinapse-ai@latest install\n\n# Atualizar uma instalação sem perder customizações de projeto\nnpx sinapse-ai@latest update\n\n# Diagnosticar e corrigir o ambiente\nnpx sinapse-ai@latest doctor --fix\n\n# Ver a superficie instalada\nnpx sinapse-ai@latest status\n```\n\n`install --force` reinstala a superfície gerenciada. `install --reconfigure`\nabre a escolha de provider somente em terminais interativos; em modo não\ninterativo, ele usa ambos. `install --global-only` configura apenas os adapters\nglobais, sem alterar o projeto atual.\n\n## Arquitetura que respeita o projeto\n\n| Camada | Responsabilidade | Política |\n|---|---|---|\n| L1 | Core do framework | Imutável |\n| L2 | Templates e workflows | Extend-only |\n| L3 | Configuração | Mutável com guardrails |\n| L4 | Stories, packages, squads e testes | Sempre do projeto |\n\nAtualizações renovam o que é gerenciado e preservam trabalho local. Os gates\ntambém evitam push indevido, escrita sem story validada, SQL perigoso e drift\nentre Claude Code e Codex.\n\n## Para quem é\n\n- Times que querem IA especializada sem perder rastreabilidade.\n- Projetos que precisam do mesmo contrato em Claude Code e Codex.\n- Produtos que valorizam story-first, QA, segurança e entrega incremental.\n- Pessoas que preferem comandos claros a um conjunto de prompts improvisados.\n\n## Documentação\n\n| Tema | Link |\n|---|---|\n| Primeiros passos | [docs/getting-started.md](docs/getting-started.md) |\n| Integracao Claude Code e Codex | [docs/guides/ide-integration.md](docs/guides/ide-integration.md) |\n| Workflows de engenharia | [docs/framework/software-engineering-applicability.md](docs/framework/software-engineering-applicability.md) |\n| Referência de agentes | [docs/agent-reference-guide.md](docs/agent-reference-guide.md) |\n| React Bits | [docs/framework/react-bits/index.md](docs/framework/react-bits/index.md) |\n| Segurança | [SECURITY.md](SECURITY.md) |\n| Contribuir | [CONTRIBUTING.md](CONTRIBUTING.md) |\n\n## Contribuição\n\n```bash\ngit clone https://github.com/caioimori/sinapse-ai.git\ncd sinapse-ai\nnpm install\nnpm test\n```\n\nAbra uma branch, mantenha a story e os gates atualizados, e envie uma PR. Veja\n[CONTRIBUTING.md](CONTRIBUTING.md) para o fluxo completo.\n\n## Licença\n\nMIT. Veja [LICENSE](LICENSE).\n","readmeFilename":"README.md"}