内容摘录
Synkra AIOS: Framework Universal de Agentes IA 🚀
🌍 English | **Português**
Versão NPM
Licença: MIT
Versão Node.js
CI
codecov
Documentação
Open Source
Contributions Welcome
Code of Conduct
Framework de Desenvolvimento Auto-Modificável Alimentado por IA. Fundado em Desenvolvimento Ágil Dirigido por Agentes, oferecendo capacidades revolucionárias para desenvolvimento dirigido por IA e muito mais. Transforme qualquer domínio com expertise especializada de IA: desenvolvimento de software, entretenimento, escrita criativa, estratégia de negócios, bem-estar pessoal e muito mais.
Comece Aqui (10 Min)
Se é sua primeira vez no AIOS, siga este caminho linear:
Instale em um projeto novo ou existente:
Escolha sua IDE/CLI e o caminho de ativação:
Claude Code: /agent-name
Gemini CLI: /aios-menu → /aios-<agent>
Codex CLI: /skills → aios-<agent-id>
Cursor/Copilot/AntiGravity: siga os limites e workarounds em docs/ide-integration.md
Ative 1 agente e confirme o greeting.
Rode 1 comando inicial (*help ou equivalente) para validar first-value.
Definição de first-value (binária): ativação de agente + greeting válido + comando inicial com output útil em <= 10 minutos.
Compatibilidade de Hooks por IDE (Realidade AIOS 4.2)
Muitos recursos avançados do AIOS dependem de eventos de ciclo de vida (hooks). A tabela abaixo mostra a paridade real entre IDEs/plataformas:
| IDE/CLI | Paridade de Hooks vs Claude | Impacto Prático |
| --- | --- | --- |
| Claude Code | Completa (referência) | Automação máxima de contexto, guardrails e auditoria |
| Gemini CLI | Alta (eventos nativos) | Cobertura forte de automações pre/post tool e sessão |
| Codex CLI | Parcial/limitada | Parte das automações depende de AGENTS.md, /skills, MCP e fluxo operacional |
| Cursor | Sem lifecycle hooks equivalentes | Menor automação de pre/post tool; foco em regras, MCP e fluxo do agente |
| GitHub Copilot | Sem lifecycle hooks equivalentes | Menor automação de sessão/tooling; foco em instruções de repositório + MCP no VS Code |
| AntiGravity | Workflow-based (não hook-based) | Integração por workflows, não por eventos de hook equivalentes ao Claude |
Impactos e mitigação detalhados: docs/ide-integration.md.
Acknowledgments & Attribution
Synkra AIOS was originally derived from the BMad Method, created by Brian Madison (BMad Code, LLC). We gratefully acknowledge the BMad Method for providing the foundation from which this project began.
**Important:** This project is **NOT affiliated with, endorsed by, or sanctioned by** the BMad Method or BMad Code, LLC. Contributors appearing in the git history from the original BMad Method repository do not imply active participation in or endorsement of Synkra AIOS.
Since its origin, AIOS has evolved significantly with its own architecture, terminology, and features (v4.x+), and does not depend on BMad for current operation. The BMad Method remains an excellent framework in its own right — please visit the official BMad Method repository to learn more.
BMad, BMad Method, and BMad Core are trademarks of BMad Code, LLC. See TRADEMARK.md for usage guidelines.
Visão Geral
Premissa Arquitetural: CLI First
O Synkra AIOS segue uma hierarquia clara de prioridades:
| Camada | Prioridade | Foco | Exemplos |
| ----------------- | ---------- | ----------------------------------------------------------------------------- | -------------------------------------------- |
| **CLI** | Máxima | Onde a inteligência vive. Toda execução, decisões e automação acontecem aqui. | Agentes (@dev, @qa), workflows, comandos |
| **Observability** | Secundária | Observar e monitorar o que acontece no CLI em tempo real. | Dashboard SSE, logs, métricas, timeline |
| **UI** | Terciária | Gestão pontual e visualizações quando necessário. | Kanban, settings, story management |
**Princípios derivados:**
A CLI é a fonte da verdade - dashboards apenas observam
Funcionalidades novas devem funcionar 100% via CLI antes de ter UI
A UI nunca deve ser requisito para operação do sistema
Observabilidade serve para entender o que o CLI está fazendo, não para controlá-lo
---
**As Duas Inovações Chave do Synkra AIOS:**
**1. Planejamento Agêntico:** Agentes dedicados (analyst, pm, architect) colaboram com você para criar documentos de PRD e Arquitetura detalhados e consistentes. Através de engenharia avançada de prompts e refinamento com human-in-the-loop, estes agentes de planejamento produzem especificações abrangentes que vão muito além da geração genérica de tarefas de IA.
**2. Desenvolvimento Contextualizado por Engenharia:** O agente sm (Scrum Master) então transforma estes planos detalhados em histórias de desenvolvimento hiperdetalhadas que contêm tudo que o agente dev precisa - contexto completo, detalhes de implementação e orientação arquitetural incorporada diretamente nos arquivos de histórias.
Esta abordagem de duas fases elimina tanto a **inconsistência de planejamento** quanto a **perda de contexto** - os maiores problemas no desenvolvimento assistido por IA. Seu agente dev abre um arquivo de história com compreensão completa do que construir, como construir e por quê.
**📖 Veja o fluxo de trabalho completo no Guia do Usuário** - Fase de planejamento, ciclo de desenvolvimento e todos os papéis dos agentes
Pré-requisitos
Node.js >=18.0.0 (v20+ recomendado)
npm >=9.0.0
GitHub CLI (opcional, necessário para colaboração em equipe)
**Problemas de instalação?** Consulte o Guia de Troubleshooting
**Guias específicos por plataforma:**
📖 Guia de Instalação para macOS
📖 Guia de Instalação para Windows
📖 Guia de Instalação para Linux
**Documentação multilíngue disponível:** Português | Español
Navegação Rápida
Entendendo o Fluxo de Trabalho AIOS
**Antes de mergulhar, revise estes diagramas críticos de fluxo de trabalho que explicam como o AIOS funciona:**
**Fluxo de Planejamento (Interface Web)** - Como criar documentos de PRD e Arquitetura
**Ciclo Principal de Desenvolvimento (IDE)** - Como os agentes sm, dev e qa colaboram através d…