⚡ Dev Forge v1.0

Fork conceitual do Growth Forge v3.x, adaptado para desenvolvimento de software.

📑 Índice
  1. Objetivo
  2. Comparação AIOS vs Dev Forge
  3. Arquitetura
  4. Execution Profiles
  5. Recovery System
  6. Estrutura de Swarms
  7. Workflow Principal
  8. Sprints de Implementação

📊 Ver Organograma Visual →  |  🏗️ Arquitetura + State Machine →

🎯 Objetivo

Agente autônomo de desenvolvimento que:

  1. Recebe um goal (feature, bugfix, projeto)
  2. Decompõe em tasks com ICE scoring
  3. Executa com validação e confidence gating
  4. Aprende com erros e acertos

🔍 Comparação: AIOS vs Dev Forge

1. Recovery System

Aspecto AIOS Dev Forge Status
Estratégias de recovery 5 tipos (RETRY, ROLLBACK, SKIP, ESCALATE, TRIGGER_WORKFLOW) 4 níveis (retry → retry+ctx → alternativo → rollback+escalate) ✅ PORTADO
Stuck detection ✅ Detecta loops circulares ✅ Será implementado ✅ PORTADO
Rollback manager ✅ Restaura estado anterior ✅ Git stash + checkpoints ✅ PORTADO
Escalation to human ✅ Automático após max retries ✅ Após 3 retries ✅ PORTADO
Recovery tracker ✅ Log detalhado ✅ Via LanceDB learning ✅ PORTADO

2. Workflow Orchestrator

Aspecto AIOS Dev Forge Status
Framework base Custom JS LangGraph (Python) 🏆 MELHOR
Typed state ❌ Não ✅ TypedDict + reducers 🏆 MELHOR
Checkpointing ✅ Custom ✅ SQLite nativo LangGraph ≈ EMPATE
Parallel execution ✅ Sim ✅ Sim (Send nodes) ≈ EMPATE
Tech stack detection ✅ Detecta stack ✅ ContextAgent detecta ✅ PORTADO
Confidence gating ✅ Bloqueia se baixa ✅ 0-1 score → profile ✅ PORTADO
YAML workflows ✅ Workflows em YAML ❌ Python (mais flexível) NÃO PORTA
Execution profiles ✅ yolo/interactive/preflight ✅ Mesmo sistema ✅ PORTADO

3. Learning & Memory

Aspecto AIOS Dev Forge Status
Self-learning ❌ Não tem ✅ LanceDB completo 🏆 MELHOR
Hierarchical memory ⚠️ Fragmentado ✅ Core/Working/Archival 🏆 MELHOR
Reflection ❌ Não tem ✅ LLM insights 🏆 MELHOR
Experience recall ❌ Não tem ✅ Semantic search 🏆 MELHOR

📊 Resumo da Comparação

Componente Quem é Melhor Ação no Dev Forge
Recovery 🏆 AIOS (era) PORTADO stuck detection, rollback, escalation
Workflow base 🏆 NÓS MANTIDO LangGraph
Workflow features 🏆 AIOS (era) PORTADO confidence gating, profiles
Learning 🏆 NÓS MANTIDO nosso sistema completo
Memory 🏆 NÓS MANTIDO hierárquica funcional

🏗️ Arquitetura

Herança Growth Forge v3.x

  • ✅ LangGraph workflow
  • ✅ Hierarchical managers (CEO → Managers → Agents)
  • ✅ Validation loop (3x retry + escalate)
  • ✅ Self-learning (LanceDB)
  • ✅ Task decomposition + ICE scoring

Features do AIOS (portadas)

  • ✅ Confidence Gating (0-1)
  • ✅ Execution Profiles (yolo/interactive/preflight)
  • ✅ Tech Stack Detection
  • ✅ Recovery Robusto (4 níveis)
  • ✅ Stuck Detection

📊 Execution Profiles

Profile Confidence Quando Usar Comportamento
yolo ≥ 0.85 Mudanças triviais, alta certeza Executa direto, sem confirmação
interactive 0.5 - 0.85 Mudanças médias (padrão) Pede confirmação antes de aplicar
preflight < 0.5 Mudanças críticas, baixa certeza Mostra diff, simula, só aplica com OK explícito

Override: Arquivos críticos (config, db, auth) forçam preflight independente da confidence.

🛡️ Recovery System (do AIOS)

4 Níveis de Fallback

  1. Retry simples — Tenta novamente com mesmo approach
  2. Retry com contexto — Adiciona erro anterior como contexto
  3. Approach alternativo — Busca solução diferente no learning
  4. Rollback + escalate — Desfaz mudanças, pede ajuda humana

Stuck Detection

Detecta loops circulares: se o agent repetir a mesma ação 3x sem progresso, escala automaticamente.

Checkpoints

🧠 Estrutura de Swarms

DevForge (CEO)
├── AnalysisManager
│   ├── ContextAgent      # Entende codebase, detecta stack
│   ├── PlannerAgent      # Decompõe goal em tasks com ICE
│   └── ReviewerAgent     # Code review, detecta issues
├── ExecutionManager
│   ├── CoderAgent        # Escreve/edita código
│   ├── TestAgent         # Cria/roda testes
│   └── RefactorAgent     # Refatoração, cleanup
└── OpsManager
    ├── GitAgent          # Commits, branches, PRs
    ├── DeployAgent       # Build, deploy, rollback
    └── DebugAgent        # Análise de erros, logs

🔄 Workflow Principal

┌─────────────────────────────────────────────────────────────┐ │ 1. GOAL INPUT │ │ "Implement user authentication with JWT" │ └─────────────────┬───────────────────────────────────────────┘ ▼ ┌─────────────────────────────────────────────────────────────┐ │ 2. CONTEXT ANALYSIS (ContextAgent) │ │ • Detecta stack: Node.js + Express + PostgreSQL │ │ • Mapeia estrutura existente │ │ • Identifica padrões do projeto │ └─────────────────┬───────────────────────────────────────────┘ ▼ ┌─────────────────────────────────────────────────────────────┐ │ 3. TASK DECOMPOSITION (PlannerAgent) │ │ • T1: Create User model (ICE: 8.0) │ │ • T2: Implement JWT utils (ICE: 7.5) │ │ • T3: Add auth middleware (ICE: 7.0) │ │ • T4: Create routes (ICE: 6.5) │ │ • T5: Write tests (ICE: 6.0) │ └─────────────────┬───────────────────────────────────────────┘ ▼ ┌─────────────────────────────────────────────────────────────┐ │ 4. EXECUTION LOOP (por task, ordem ICE) │ │ │ │ ┌──────────────────────────────────────────────────────┐ │ │ │ CoderAgent executa │ │ │ │ ↓ │ │ │ │ Confidence check (0.85+ = yolo, 0.5+ = ask, else sim) │ │ │ │ ↓ │ │ │ │ TestAgent valida (testes passam?) │ │ │ │ ↓ │ │ │ │ ReviewerAgent aprova? │ │ │ │ ✅ → next task │ │ │ │ ❌ → retry (max 3x) → approach alt → escalate │ │ │ └──────────────────────────────────────────────────────┘ │ └─────────────────┬───────────────────────────────────────────┘ ▼ ┌─────────────────────────────────────────────────────────────┐ │ 5. COMMIT & LEARN │ │ • GitAgent: commit atômico por task │ │ • Learning: salva experiência (success/failure) │ │ • Recall: próximas tasks similares usam contexto │ └─────────────────────────────────────────────────────────────┘

📅 Sprints de Implementação

Sprint 1: Core

2-3 dias

Sprint 2: Execution

2-3 dias

Sprint 3: Learning + Recovery

2 dias

Sprint 4: Integration

1-2 dias

Total estimado: ~8-10 dias

Criado: 2026-02-17 | Baseado em: Growth Forge v3.4 + AIOS Analysis | Por: ArcosBot ⚡