AIOX Autonomous Development Engine (ADE) - Guia Completo

Versão: 1.0.0 Data: 2026-01-29 Status: Production Ready ✅

O que é o ADE?

O AIOX Autonomous Development Engine (ADE) é um sistema de desenvolvimento autônomo que transforma requisitos vagos em código funcional através de pipelines estruturados e agentes especializados.

Características Principais

Spec Pipeline - Transforma ideias em especificações executáveis
Execution Engine - Executa subtasks com self-critique obrigatório
Recovery System - Recupera de falhas automaticamente
QA Evolution - Review estruturado em 10 fases
Memory Layer - Aprende e documenta padrões

Arquitetura

┌─────────────────────────────────────────────────────────────────────────────┐
│                           ADE Architecture                                   │
│                                                                              │
│  User Request ──► Spec Pipeline ──► Execution Engine ──► Working Code       │
│                                            │                                 │
│                                            ▼                                 │
│                                    Recovery System                           │
│                                            │                                 │
│                                            ▼                                 │
│                                    QA Evolution                              │
│                                            │                                 │
│                                            ▼                                 │
│                                    Memory Layer                              │
└─────────────────────────────────────────────────────────────────────────────┘

Os 7 Epics

Epic 1: Worktree Manager

Propósito: Isolamento de branches via Git worktrees

Comandos (@devops):

*create-worktree {story} - Criar worktree isolado
*list-worktrees - Listar worktrees ativos
*merge-worktree {story} - Fazer merge do worktree
*cleanup-worktrees - Remover worktrees antigos

Documentação: ADE-EPIC1-HANDOFF.md

Epic 2: Migration V2→V3

Propósito: Migração para formato autoClaude V3

Comandos (@devops):

*inventory-assets - Inventário de assets V2
*analyze-paths - Analisar dependências
*migrate-agent - Migrar agente individual
*migrate-batch - Migrar todos em batch

Documentação: ADE-EPIC2-HANDOFF.md

Epic 3: Spec Pipeline

Propósito: Transformar requisitos em specs executáveis

Fluxo:

User Request → Gather → Assess → Research → Write → Critique → Spec Ready

Comandos por Agente:

| Agent | Command | Fase | | ---------- | ---------------------- | ---------------------- | | @pm | *gather-requirements | Coletar requisitos | | @architect | *assess-complexity | Avaliar complexidade | | @analyst | *research-deps | Pesquisar dependências | | @pm | *write-spec | Escrever spec | | @qa | *critique-spec | Criticar e aprovar |

Documentação: ADE-EPIC3-HANDOFF.md

Epic 4: Execution Engine

Propósito: Executar specs em código funcional

13 Steps do Coder:

Load Context
Read Implementation Plan
Understand Current Subtask
Plan Approach
Write Code
- 5.5 SELF-CRITIQUE (obrigatório)
Run Tests
- 6.5 SELF-CRITIQUE (obrigatório)
Fix Issues
Run Linter
Fix Lint Issues
Verify Manually
Update Plan Status
Commit Changes
Signal Completion

Comandos (@architect):

*create-plan - Criar plano de implementação
*create-context - Gerar contexto do projeto

Comandos (@dev):

*execute-subtask - Executar subtask

Documentação: ADE-EPIC4-HANDOFF.md

Epic 5: Recovery System

Propósito: Recuperar de falhas em subtasks

Fluxo:

Subtask Fails → Track Attempt → Retry (<3) → Stuck Detection → Rollback → Escalate

Comandos (@dev):

*track-attempt - Registrar tentativa
*rollback - Voltar para estado anterior

Documentação: ADE-EPIC5-HANDOFF.md

Epic 6: QA Evolution

Propósito: Review estruturado em 10 fases

10 Fases:

Setup & Context Loading
Code Quality Analysis
Test Coverage Review
Security Scan
Performance Check
Documentation Audit
Accessibility Review
Integration Points Check
Edge Cases & Error Handling
Final Summary & Decision

Comandos (@qa):

*review-build {story} - Review completo
*request-fix {issue} - Solicitar correção
*verify-fix {issue} - Verificar correção

Comandos (@dev):

*apply-qa-fix - Aplicar correção do QA

Documentação: ADE-EPIC6-HANDOFF.md

Epic 7: Memory Layer

Propósito: Memória persistente de padrões e insights

Tipos de Memória:

Insights - Descobertas durante desenvolvimento
Patterns - Padrões de código extraídos
Gotchas - Armadilhas conhecidas
Decisions - Decisões arquiteturais

Comandos (@dev):

*capture-insights - Capturar insights da sessão
*list-gotchas - Listar gotchas conhecidas

Comandos (@architect):

*map-codebase - Gerar mapa do codebase

Comandos (@analyst):

*extract-patterns - Extrair padrões do código

Documentação: ADE-EPIC7-HANDOFF.md

Quick Start

1. Criar Spec a partir de Requisito

# Ativar PM e coletar requisitos
@pm *gather-requirements

# Avaliar complexidade
@architect *assess-complexity

# Pesquisar dependências
@analyst *research-deps

# Escrever spec
@pm *write-spec

# Criticar e aprovar
@qa *critique-spec

2. Executar Spec Aprovada

# Criar plano de implementação
@architect *create-plan

# Criar contexto do projeto
@architect *create-context

# Executar subtasks (loop)
@dev *execute-subtask 1.1
@dev *execute-subtask 1.2
...

3. QA Review

# Review estruturado
@qa *review-build STORY-42

# Se há issues:
@qa *request-fix "Missing error handling"
@dev *apply-qa-fix
@qa *verify-fix

4. Capturar Aprendizado

# Capturar insights da sessão
@dev *capture-insights

# Documentar gotchas
@dev *list-gotchas

Estrutura de Arquivos

.aiox-core/
├── development/
│   ├── agents/              # Definições de agentes V3
│   ├── tasks/               # Tasks executáveis
│   │   ├── spec-*.md        # Spec Pipeline tasks
│   │   ├── plan-*.md        # Execution Engine tasks
│   │   ├── qa-*.md          # QA Evolution tasks
│   │   └── capture-*.md     # Memory Layer tasks
│   └── workflows/
│       ├── spec-pipeline.yaml
│       ├── qa-loop.yaml
│       └── auto-worktree.yaml
│
├── infrastructure/
│   ├── scripts/
│   │   ├── worktree-manager.js     # Epic 1
│   │   ├── asset-inventory.js      # Epic 2
│   │   ├── migrate-agent.js        # Epic 2
│   │   ├── subtask-verifier.js     # Epic 4
│   │   ├── plan-tracker.js         # Epic 4
│   │   ├── recovery-tracker.js     # Epic 5
│   │   ├── rollback-manager.js     # Epic 5
│   │   ├── qa-loop-orchestrator.js # Epic 6
│   │   ├── codebase-mapper.js      # Epic 7
│   │   └── pattern-extractor.js    # Epic 7
│   └── schemas/
│       ├── agent-v3-schema.json
│       └── task-v3-schema.json
│
└── product/
    ├── templates/
    │   ├── spec-tmpl.md
    │   └── qa-report-tmpl.yaml
    └── checklists/
        └── self-critique-checklist.md

autoClaude V3 Format

Agent Definition

autoClaude:
  version: '3.0'
  migratedAt: '2026-01-29T02:24:10.724Z'

  specPipeline:
    canGather: boolean # @pm
    canAssess: boolean # @architect
    canResearch: boolean # @analyst
    canWrite: boolean # @pm
    canCritique: boolean # @qa

  execution:
    canCreatePlan: boolean # @architect
    canCreateContext: boolean # @architect
    canExecute: boolean # @dev
    canVerify: boolean # @dev

  recovery:
    canTrackAttempts: boolean # @dev
    canRollback: boolean # @dev

  qa:
    canReview: boolean # @qa
    canRequestFix: boolean # @qa

  memory:
    canCaptureInsights: boolean # @dev
    canExtractPatterns: boolean # @analyst
    canDocumentGotchas: boolean # @dev

Task Definition

autoClaude:
  version: '3.0'
  pipelinePhase: spec-gather|spec-assess|exec-plan|exec-subtask|etc
  deterministic: boolean
  elicit: boolean
  composable: boolean

  verification:
    type: none|command|manual
    command: 'npm test'

  selfCritique:
    required: boolean
    checklistRef: 'self-critique-checklist.md'

QA Gates

Cada Epic tem um QA Gate que deve passar antes de prosseguir:

@qa *gate epic-{N}-{name}

Decisões:

PASS - Próximo epic liberado
CONCERNS - Aprovado com follow-ups
FAIL - Retorna para correções
WAIVED - Bypass autorizado por @po

Troubleshooting

Subtask Falha Repetidamente

# Verificar histórico de tentativas
@dev *track-attempt --status

# Rollback para último estado bom
@dev *rollback --hard

# Tentar abordagem diferente
@dev *execute-subtask 2.1 --approach alternative

Spec não Aprovada

# Ver feedback do critique
cat docs/stories/STORY-42/spec-critique.json

# Refinar spec
@pm *write-spec --iterate

# Re-submeter para critique
@qa *critique-spec

Worktree Conflita

# Listar worktrees
@devops *list-worktrees

# Resolver conflitos
@devops *merge-worktree STORY-42 --resolve

# Cleanup
@devops *cleanup-worktrees

AIOX Autonomous Development Engine (ADE) - Guia Completo

O que é o ADE?

Características Principais

Arquitetura

Os 7 Epics

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

Quick Start

1. Criar Spec a partir de Requisito

2. Executar Spec Aprovada

3. QA Review

4. Capturar Aprendizado

Estrutura de Arquivos

autoClaude V3 Format

Agent Definition

Task Definition

QA Gates

Troubleshooting

Subtask Falha Repetidamente

Spec não Aprovada

Worktree Conflita

Related Documentation