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.
O Synkra AIOS segue uma hierarquia clara de prioridades:
CLI First → Observability Second → UI Third
| 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
- 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:
Documentação multilíngue disponível: Português | Español
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 de arquivos de histórias
⚠️ Estes diagramas explicam 90% da confusão sobre o fluxo Synkra AIOS Agentic Agile - Entender a criação de PRD+Arquitetura e o fluxo de trabalho sm/dev/qa e como os agentes passam notas através de arquivos de histórias é essencial - e também explica por que isto NÃO é taskmaster ou apenas um simples executor de tarefas!
- Instalar e Construir software com Equipe Ágil Full Stack de IA → Instruções de Início Rápido
- Aprender como usar o AIOS → Guia completo do usuário e passo a passo
- Ver agentes IA disponíveis → Papéis especializados para sua equipe
- Explorar usos não técnicos → Escrita criativa, negócios, bem-estar, educação
- Criar meus próprios agentes IA → Construir agentes para seu domínio
- Navegar Squads prontos → Veja como criar e usar equipes de agentes IA
- Entender a arquitetura → Mergulho técnico profundo
- Juntar-se à comunidade → Obter ajuda e compartilhar ideias
Mantenha-se atualizado sem esforço! Para atualizar sua instalação AIOS existente:
npx github:SynkraAI/aios-core installIsto vai:
- ✅ Detectar automaticamente sua instalação existente
- ✅ Atualizar apenas os arquivos que mudaram
- ✅ Criar arquivos de backup
.bakpara quaisquer modificações customizadas - ✅ Preservar suas configurações específicas do projeto
Isto facilita beneficiar-se das últimas melhorias, correções de bugs e novos agentes sem perder suas customizações!
Instale o Synkra AIOS com um único comando:
# Criar um novo projeto com assistente interativo moderno
npx aios-core init meu-projeto
# Ou instalar em projeto existente
cd seu-projeto
npx aios-core install
# Ou usar uma versão específica
npx aios-core@latest init meu-projetoO Synkra AIOS agora inclui uma experiência de instalação interativa de última geração, inspirada em ferramentas modernas como Vite e Next.js:
Recursos do Instalador Interativo:
- 🎨 Interface Moderna: Prompts coloridos e visuais com @clack/prompts
- ✅ Validação em Tempo Real: Feedback instantâneo sobre entradas inválidas
- 🔄 Indicadores de Progresso: Spinners para operações longas (cópia de arquivos, instalação de deps)
- 📦 Seleção Multi-Componente: Escolha quais componentes instalar com interface intuitiva
- ⚙️ Escolha de Gerenciador de Pacotes: Selecione entre npm, yarn ou pnpm
- ⌨️ Suporte a Cancelamento: Ctrl+C ou ESC para sair graciosamente a qualquer momento
- 📊 Resumo de Instalação: Visualize todas as configurações antes de prosseguir
- ⏱️ Rastreamento de Duração: Veja quanto tempo levou a instalação
O instalador oferece:
- ✅ Download da versão mais recente do NPM
- ✅ Assistente de instalação interativo moderno
- ✅ Configuração automática do IDE (Windsurf, Cursor ou Claude Code)
- ✅ Configuração de todos os agentes e fluxos de trabalho AIOS
- ✅ Criação dos arquivos de configuração necessários
- ✅ Inicialização do sistema de meta-agentes
- ✅ Verificações de saúde do sistema
- ✅ Suporte Cross-Platform: Testado em Windows, macOS e Linux
É isso! Sem clonar, sem configuração manual - apenas um comando e você está pronto para começar com uma experiência de instalação moderna e profissional.
Pré-requisitos: Node.js v18+ necessário (v20+ recomendado) | Troubleshooting
Se você já tem o AIOS instalado:
npx github:SynkraAI/aios-core install
# O instalador detectará sua instalação existente e a atualizaráO Synkra AIOS inclui regras pré-configuradas para IDE para melhorar sua experiência de desenvolvimento:
- Abra as configurações do seu IDE
- Navegue até Global Rules (Windsurf) ou User Rules (Cursor)
- Copie o conteúdo de
.windsurf/global-rules.mdou.cursor/global-rules.md - Cole na seção de regras e salve
- ✅ Já configurado! O arquivo
.claude/CLAUDE.mdé carregado automaticamente
Estas regras fornecem:
- 🤖 Reconhecimento e integração de comandos de agentes
- 📋 Fluxo de trabalho de desenvolvimento dirigido por histórias
- ✅ Rastreamento automático de checkboxes
- 🧪 Padrões de teste e validação
- 📝 Padrões de código específicos do AIOS
- Instale o AIOS: Execute
npx aios-core init meu-projeto - Configure seu IDE: Siga as instruções de configuração para Windsurf, Cursor ou Claude Code
- Comece a Planejar: Ative um agente como
@analystpara começar a criar seu briefing - Use comandos AIOS: Digite
*helppara ver comandos disponíveis - Siga o fluxo: Veja o Guia do usuário para mais detalhes
O Synkra AIOS oferece uma CLI moderna e cross-platform com comandos intuitivos:
# Gerenciamento de Projeto (com assistente interativo)
npx aios-core init <nome-projeto> [opções]
--force Forçar criação em diretório não vazio
--skip-install Pular instalação de dependências npm
--template <nome> Usar template específico (default, minimal, enterprise)
# Instalação e Configuração (com prompts modernos)
npx aios-core install [opções]
--force Sobrescrever configuração existente
--quiet Saída mínima durante instalação
--dry-run Simular instalação sem modificar arquivos
# Comandos do Sistema
npx aios-core --version Exibir versão instalada
npx aios-core --help Exibir ajuda detalhada
npx aios-core info Exibir informações do sistema
npx aios-core doctor Executar diagnósticos do sistema
npx aios-core doctor --fix Corrigir problemas detectados automaticamente
# Manutenção
npx aios-core update Atualizar para versão mais recente
npx aios-core uninstall Remover Synkra AIOSRecursos da CLI:
- ✅ Help System Abrangente:
--helpem qualquer comando mostra documentação detalhada - ✅ Validação de Entrada: Feedback imediato sobre parâmetros inválidos
- ✅ Mensagens Coloridas: Erros em vermelho, sucessos em verde, avisos em amarelo
- ✅ Cross-Platform: Funciona perfeitamente em Windows, macOS e Linux
- ✅ Suporte a Dry-Run: Teste instalações sem modificar arquivos
$ npx aios-core install
🚀 Synkra AIOS Installation
◆ What is your project name?
│ my-awesome-project
│
◇ Which directory should we use?
│ ./my-awesome-project
│
◆ Choose components to install:
│ ● Core Framework (Required)
│ ● Agent System (Required)
│ ● Squads (optional)
│ ○ Example Projects (optional)
│
◇ Select package manager:
│ ● npm
│ ○ yarn
│ ○ pnpm
│
◆ Initialize Git repository?
│ Yes
│
◆ Install dependencies?
│ Yes
│
▸ Creating project directory...
▸ Copying framework files...
▸ Initializing Git repository...
▸ Installing dependencies (this may take a minute)...
▸ Configuring environment...
▸ Running post-installation setup...
✔ Installation completed successfully! (34.2s)
Next steps:
cd my-awesome-project
aios-core doctor # Verify installation
aios-core --help # See available commands# Instalação automatizada sem prompts
$ npx aios-core install --quiet --force
✔ Synkra AIOS installed successfully# Testar instalação sem modificar arquivos
$ npx aios-core install --dry-run
[DRY RUN] Would create: ./my-project/
[DRY RUN] Would copy: .aios-core/ (45 files)
[DRY RUN] Would initialize: Git repository
[DRY RUN] Would install: npm dependencies
✔ Dry run completed - no files were modified$ npx aios-core doctor
🏥 AIOS System Diagnostics
✔ Node.js version: v20.10.0 (meets requirement: >=18.0.0)
✔ npm version: 10.2.3
✔ Git installed: version 2.43.0
✔ GitHub CLI: gh 2.40.1
✔ Synkra AIOS: v1.0.0
Configuration:
✔ .aios-core/ directory exists
✔ Agent files: 11 found
✔ Workflow files: 8 found
✔ Templates: 15 found
Dependencies:
✔ @clack/prompts: ^0.7.0
✔ commander: ^12.0.0
✔ execa: ^9.0.0
✔ fs-extra: ^11.0.0
✔ picocolors: ^1.0.0
✅ All checks passed! Your installation is healthy.$ npx aios-core --help
Usage: aios-core [options] [command]
Synkra AIOS: AI-Orchestrated System for Full Stack Development
Options:
-V, --version output the version number
-h, --help display help for command
Commands:
init <project-name> Create new AIOS project with interactive wizard
install [options] Install AIOS in current directory
info Display system information
doctor [options] Run system diagnostics and health checks
help [command] display help for command
Run 'aios-core <command> --help' for detailed information about each command.Para contribuidores ou usuários avançados que queiram modificar o código fonte:
# Clonar o repositório
git clone https://github.com/SynkraAI/aios-core.git
cd aios-core
# Instalar dependências
npm install
# Executar o instalador
npm run install:aiosPara membros da equipe ingressando no projeto:
# Instalar AIOS com configuração GitHub
npx github:SynkraAI/aios-core setup
# Isto vai:
# 1. Verificar/instalar GitHub CLI
# 2. Autenticar com GitHub
# 3. Executar o instalador AIOSO framework de linguagem natural do AIOS funciona em QUALQUER domínio. Os Squads fornecem agentes IA especializados para escrita criativa, estratégia de negócios, saúde e bem-estar, educação e muito mais. Além disso, os Squads podem expandir o núcleo do Synkra AIOS com funcionalidade específica que não é genérica para todos os casos. Veja o Guia de Squads e aprenda a criar os seus próprios!
O Synkra AIOS vem com 11 agentes especializados:
- aios-master - Agente mestre de orquestração (inclui capacidades de desenvolvimento de framework)
- aios-orchestrator - Orquestrador de fluxo de trabalho e coordenação de equipe
- analyst - Especialista em análise de negócios e criação de PRD
- pm (Product Manager) - Gerente de produto e priorização
- architect - Arquiteto de sistema e design técnico
- ux-expert - Design de experiência do usuário e usabilidade
- sm (Scrum Master) - Gerenciamento de sprint e criação de histórias
- dev - Desenvolvedor e implementação
- qa - Garantia de qualidade e testes
- po (Product Owner) - Gerenciamento de backlog e histórias
- 📖 Guia do Usuário - Passo a passo completo desde a concepção até a conclusão do projeto
- 🏗️ Arquitetura Principal - Mergulho técnico profundo e design do sistema
- 🚀 Guia de Squads - Estenda o AIOS para qualquer domínio além do desenvolvimento de software
- 🤖 Guia de Squads - Crie e publique equipes de agentes IA
- 📋 Primeiros Passos - Tutorial passo a passo para iniciantes
- 🔧 Solução de Problemas - Soluções para problemas comuns
- 🎯 Princípios Orientadores - Filosofia e melhores práticas do AIOS
- 🏛️ Visão Geral da Arquitetura - Visão detalhada da arquitetura do sistema
- ⚙️ Guia de Ajuste de Performance - Otimize seu fluxo de trabalho AIOS
- 🔒 Melhores Práticas de Segurança - Segurança e proteção de dados
- 🔄 Guia de Migração - Migração de versões anteriores
- 📦 Versionamento e Releases - Política de versões
O Synkra AIOS v1.0.0 introduz o Autonomous Development Engine (ADE) - um sistema completo para desenvolvimento autônomo que transforma requisitos em código funcional.
O ADE é um conjunto de 7 Epics que habilitam execução autônoma de desenvolvimento:
| Epic | Nome | Descrição |
|---|---|---|
| 1 | Worktree Manager | Isolamento de branches via Git worktrees |
| 2 | Migration V2→V3 | Migração para formato autoClaude V3 |
| 3 | Spec Pipeline | Transforma requisitos em specs executáveis |
| 4 | Execution Engine | Executa specs com 13 steps + self-critique |
| 5 | Recovery System | Recuperação automática de falhas |
| 6 | QA Evolution | Review estruturado em 10 fases |
| 7 | Memory Layer | Memória persistente de padrões e insights |
User Request → Spec Pipeline → Execution Engine → QA Review → Working Code
↓
Recovery System
↓
Memory Layer
# 1. Criar spec a partir de requisito
@pm *gather-requirements
@architect *assess-complexity
@analyst *research-deps
@pm *write-spec
@qa *critique-spec
# 2. Executar spec aprovada
@architect *create-plan
@architect *create-context
@dev *execute-subtask 1.1
# 3. QA Review
@qa *review-build STORY-42- Guia Completo do ADE - Tutorial passo a passo
- Alterações nos Agentes - Comandos e capabilities por agente
- Epic 1 - Worktree Manager
- Epic 2 - Migration V2→V3
- Epic 3 - Spec Pipeline
- Epic 4 - Execution Engine
- Epic 5 - Recovery System
- Epic 6 - QA Evolution
- Epic 7 - Memory Layer
@devops:
*create-worktree,*list-worktrees,*merge-worktree,*cleanup-worktrees*inventory-assets,*analyze-paths,*migrate-agent,*migrate-batch
@pm:
*gather-requirements,*write-spec
@architect:
*assess-complexity,*create-plan,*create-context,*map-codebase
@analyst:
*research-deps,*extract-patterns
@qa:
*critique-spec,*review-build,*request-fix,*verify-fix
@dev:
*execute-subtask,*track-attempt,*rollback,*capture-insights,*list-gotchas,*apply-qa-fix
Expansion packs permitem estender o AIOS para qualquer domínio. Estrutura básica:
squads/seu-pack/
├── config.yaml # Configuração do pack
├── agents/ # Agentes especializados
├── tasks/ # Fluxos de trabalho de tarefas
├── templates/ # Templates de documentos
├── checklists/ # Checklists de validação
├── data/ # Base de conhecimento
├── README.md # Documentação do pack
└── user-guide.md # Guia do usuário
Veja o Guia de Squads para instruções detalhadas.
Squads são equipes modulares de agentes IA. Veja a Visão Geral de Squads para mais informações.
- hybrid-ops - Operações híbridas humano-agente (repositório separado)
- 📖 Guia da Comunidade - Como participar e contribuir
- 💬 Discussões GitHub - Hub central da comunidade
- 💡 Processo de Features - Como propor novas funcionalidades
- 🐛 Rastreador de Issues
- 📋 Como Contribuir
- 🗺️ Roadmap - Veja o que estamos construindo
- 🤖 Guia de Squads - Crie equipes de agentes IA
O Synkra AIOS implementa um sistema de validação de múltiplas camadas para garantir qualidade do código e consistência:
Camada 1: Pre-commit (Local - Rápida)
- ✅ ESLint - Qualidade de código
- ✅ TypeScript - Verificação de tipos
- ⚡ Performance: <5s
- 💾 Cache habilitado
Camada 2: Pre-push (Local - Validação de Stories)
- ✅ Validação de checkboxes de histórias
- ✅ Consistência de status
- ✅ Seções obrigatórias
Camada 3: CI/CD (Cloud - Obrigatório para merge)
- ✅ Todos os testes
- ✅ Cobertura de testes (80% mínimo)
- ✅ Validações completas
- ✅ GitHub Actions
- 📋 Guia Completo de Git Workflow - Guia detalhado do fluxo de trabalho
- 📋 CONTRIBUTING.md - Guia de contribuição
# Validações locais
npm run lint # ESLint
npm run typecheck # TypeScript
npm test # Testes
npm run test:coverage # Testes com cobertura
# Validador AIOS
node .aios-core/utils/aios-validator.js pre-commit # Validação pre-commit
node .aios-core/utils/aios-validator.js pre-push # Validação pre-push
node .aios-core/utils/aios-validator.js stories # Validar todas storiesConfigure proteção da branch master com:
node scripts/setup-branch-protection.jsRequer:
- GitHub CLI (gh) instalado e autenticado
- Acesso de admin ao repositório
Estamos empolgados com contribuições e acolhemos suas ideias, melhorias e Squads! 🎉
Para contribuir:
- Fork o repositório
- Crie uma branch para sua feature (
git checkout -b feature/MinhaNovaFeature) - Commit suas mudanças (
git commit -m 'feat: Adicionar nova feature') - Push para a branch (
git push origin feature/MinhaNovaFeature) - Abra um Pull Request
Veja também:
| Documento | English | Português |
|---|---|---|
| Licença | MIT License | - |
| Privacidade | Privacy Policy | - |
| Termos de Uso | Terms of Use | - |
| Código de Conduta | Code of Conduct | PT-BR |
| Contribuição | Contributing | PT-BR |
| Segurança | Security | PT-BR |
| Comunidade | Community | PT-BR |
| Roadmap | Roadmap | PT-BR |
| Changelog | Version History | - |
Construído com ❤️ para a comunidade de desenvolvimento assistido por IA