🚀 Synkra AIOS-Core

Framework Universal de Agentes IA para Desenvolvimento Auto-Modificável

v4.2+ MIT License 321k+ LOC Node.js ≥18

📖 Visão Geral

O Synkra AIOS é um framework de desenvolvimento auto-modificável alimentado por IA. Originalmente derivado do BMad Method, evoluiu para uma arquitetura própria (v4.x+) com foco em desenvolvimento ágil dirigido por agentes.

Duas Inovações Chave

1. Planejamento Agêntico

Agentes dedicados (analyst, pm, architect) colaboram para criar PRDs e documentos de arquitetura detalhados através de refinamento human-in-the-loop.

2. Desenvolvimento Contextualizado

O agente SM transforma planos em histórias hiperdetalhadas contendo contexto completo, detalhes de implementação e orientação arquitetural.

Premissa Arquitetural: CLI First

Camada Prioridade Foco
CLI Máxima Toda execução, decisões e automação
Observability Secundária Dashboard SSE, logs, métricas, timeline
UI Terciária Gestão pontual e visualizações

📊 Estatísticas do Projeto

321k+
Linhas de Código
11+
Agentes Especializados
8
Camadas Synapse
7
ADE Epics
3
Quality Gate Layers
5
Recovery Strategies

Compatibilidade de IDEs

IDE/CLI Paridade de Hooks Impacto
Claude Code Completa (referência) Automação máxima
Gemini CLI Alta Cobertura forte
Codex CLI Parcial Via AGENTS.md e /skills
Cursor Sem hooks Foco em regras e MCP
GitHub Copilot Sem hooks Instruções de repositório

🏗️ Arquitetura

Estrutura Principal

.aios-core/ ├── cli/ # Interface de linha de comando ├── core/ # Coração do sistema │ ├── orchestration/ # Agent Invoker, Recovery Handler, Gate Evaluator │ ├── synapse/ # Engine de 8 camadas de contexto │ ├── memory/ # Gotchas, Session Digest │ ├── quality-gates/ # 3 layers de validação │ ├── execution/ # Build Loop Autônomo │ └── ids/ # Entity Registry ├── development/ # Agentes e tasks ├── infrastructure/ # Scripts de suporte ├── hooks/ # Lifecycle hooks (Claude, Gemini) └── workflow-intelligence/ # Análise de workflows

ADE - Autonomous Development Engine

Sistema de 7 Epics para desenvolvimento autônomo:

Epic Nome Funçã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

🧠 Synapse Engine - 8 Camadas de Contexto

O SynapseEngine é o orquestrador do pipeline de injeção de contexto em 8 camadas. Executa L0-L7 sequencialmente, aplica filtragem bracket-aware e formata a saída final em XML.

L0
Constitution

Regras fundamentais e limites do sistema

L1
Global

Configurações globais do projeto

L2
Agent

Persona, capabilities e comandos do agente ativo

L3
Workflow

Contexto do workflow atual

L4
Task

Detalhes da task em execução

L5
Squad

Configuração do squad (se aplicável)

L6
Keyword

Contexto baseado em keywords detectadas

L7
Star Command

Comandos especiais (*help, *status, etc.)

Context Tracker

Gerencia o orçamento de tokens e decide quais camadas ativar baseado no contexto:

  • estimateContextPercent() - Estima uso de contexto
  • calculateBracket() - Define bracket atual
  • getActiveLayers() - Retorna camadas ativas
  • getTokenBudget() - Orçamento de tokens
  • needsMemoryHints() - Se precisa hints de memória
  • needsHandoffWarning() - Se precisa aviso de handoff

🤖 Sistema de Agentes

Agentes Meta

👑

Orion (@aios-master)

Master Orchestrator & Framework Developer. Orquestra todos os domínios e cria/modifica componentes do framework.

Comandos: *create, *modify, *validate-component, *workflow, *ids

Agentes de Planejamento (Web UI)

🔍

Atlas (@analyst)

Business Analyst. Market research, análise competitiva, brainstorming, feasibility studies.

*create-project-brief, *perform-market-research, *brainstorm

📋

Morgan (@pm)

Product Manager. PRD, epics, product strategy, prioritização MoSCoW/RICE, roadmap.

*create-prd, *create-epic, *gather-requirements, *write-spec

🏛️

Aria (@architect)

System Architect. Arquitetura fullstack/backend/frontend, tech stack, API design, security.

*create-full-stack-architecture, *assess-complexity, *create-plan

🎨

UX Expert

Design de experiência do usuário e usabilidade.

Agentes de Desenvolvimento (IDE)

📝

SM (@sm)

Scrum Master. Sprint management, criação de histórias detalhadas.

💻

Dex (@dev)

Full Stack Developer. Implementação, debugging, refactoring.

*develop, *execute-subtask, *build-autonomous, *worktree-create

✅

Quinn (@qa)

Test Architect & Quality Advisor. Review, quality gates, security check.

*code-review, *review-build, *gate, *security-check

🎯

Pax (@po)

Product Owner. Backlog, story refinement, acceptance criteria.

*backlog-add, *validate-story-draft, *close-story

⚡

Gage (@devops)

GitHub Repository Manager & DevOps. CI/CD, quality gates, push operations.

*push, *create-pr, *release, *setup-github

📊

Dara (@data-engineer)

Database Architect. Schema design, RLS policies, migrations, Supabase.

*create-schema, *create-rls-policies, *apply-migration

🎭 Sistema de Orquestração

Componentes Principais

Módulo Função LOC
master-orchestrator.js Orquestrador principal do pipeline ADE 54k
bob-orchestrator.js Decision tree entry point para PM agent 36k
workflow-orchestrator.js Execução de workflows 31k
workflow-executor.js Executor de workflows com callbacks 36k
agent-invoker.js Interface para invocar agentes 17k
gate-evaluator.js Avaliação de quality gates 16k
recovery-handler.js Recuperação automática de erros 25k
terminal-spawner.js Spawn de terminais para agentes 31k

Project States (Decision Tree)

NO_CONFIG

Projeto sem configuração AIOS

EXISTING_NO_DOCS

Projeto existente sem documentação

EXISTING_WITH_DOCS

Brownfield com PRD/Arquitetura

GREENFIELD

Projeto novo do zero

🔄 Recovery System

5 Estratégias de Recuperação

1
RETRY_SAME_APPROACH

Retry com a mesma abordagem

2
ROLLBACK_AND_RETRY

Rollback do estado e retry com abordagem diferente

3
SKIP_PHASE

Pula a fase e continua

4
ESCALATE_TO_HUMAN

Escala para intervenção manual

5
TRIGGER_RECOVERY_WORKFLOW

Dispara workflow de recuperação (Epic 5)

Integrações

  • StuckDetector - Detecta loops circulares e stuck states
  • RollbackManager - Restaura estado anterior
  • RecoveryTracker - Tracking de tentativas e logs

Configuração

maxRetries: 3          // Máximo de tentativas por epic
autoEscalate: true     // Auto-escala após max retries
circularDetection: true // Detecção de loops

🛡️ Quality Gates - 3 Camadas

Defense in Depth

Layer 1: Pre-commit (Local)

  • ✅ ESLint - Qualidade de código
  • ✅ TypeScript - Verificação de tipos
  • ⚡ Performance: <5s
  • 💾 Cache habilitado

Layer 2: Pre-push (Local)

  • ✅ Validação de checkboxes de stories
  • ✅ Consistência de status
  • ✅ Seções obrigatórias

Layer 3: CI/CD (Cloud)

  • ✅ Todos os testes
  • ✅ Cobertura 80% mínimo
  • ✅ Validações completas
  • ✅ GitHub Actions

Componentes

Módulo Função
quality-gate-manager.js Gerenciador principal (17k LOC)
human-review-orchestrator.js Orquestra reviews humanos
checklist-generator.js Gera checklists estratégicos
focus-area-recommender.js Recomenda áreas de foco
notification-manager.js Gerencia notificações

⚖️ Comparação: AIOS vs Growth Forge

Onde AIOS é Melhor

Feature AIOS Growth Forge
Recovery Strategies 5 estratégias completas 1 (retry básico)
Stuck Detection Detecta loops circulares Não tem
Rollback Manager Restaura estado anterior Só checkpoint LangGraph
Tech Stack Detection Auto-detecta linguagem/framework Não tem
Confidence Gating Bloqueia se confiança baixa Não tem
Execution Profiles yolo/interactive/preflight Não tem

Onde Growth Forge é Melhor

Feature AIOS Growth Forge
Workflow Base Custom JS LangGraph (industry standard)
Typed State Não tipado TypedDict + reducers
Self-Learning Gotchas apenas LanceDB + 148 experiências
Memory Hierárquica Fragmentado Core/Working/Archival

Decisão: Portar Features do AIOS para Growth Forge

  • ✅ Recovery Handler robusto (5 estratégias)
  • ✅ Confidence Gating
  • ✅ Execution Profiles
  • ✅ Tech Stack Detection
  • ✅ Stuck Detection

Já incorporado no DEV FORGE v1.0

📚 Links Úteis