Arquitetura ADE - Motor de Desenvolvimento Autônomo

┌─────────────────────────────────────────────────────────────────────────────┐
│                           Framework AIOS                                     │
├─────────────────────────────────────────────────────────────────────────────┤
│                                                                              │
│  ┌────────────────────────────────────────────────────────────────────────┐ │
│  │                    ADE - Motor de Desenvolvimento Autônomo             │ │
│  ├────────────────────────────────────────────────────────────────────────┤ │
│  │                                                                        │ │
│  │  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐   │ │
│  │  │   Épica 1   │  │   Épica 2   │  │   Épica 3   │  │   Épica 4   │   │ │
│  │  │  Worktree   │→│   Status    │→│    Spec     │→│    Plano    │   │ │
│  │  │  Manager    │  │   Loader    │  │  Pipeline   │  │   Tracker   │   │ │
│  │  └─────────────┘  └─────────────┘  └─────────────┘  └─────────────┘   │ │
│  │         │                │                │                │          │ │
│  │         ▼                ▼                ▼                ▼          │ │
│  │  ┌─────────────────────────────────────────────────────────────────┐  │ │
│  │  │                     Estado Runtime .aios/                       │  │ │
│  │  └─────────────────────────────────────────────────────────────────┘  │ │
│  │         │                │                │                │          │ │
│  │         ▼                ▼                ▼                ▼          │ │
│  │  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐   │ │
│  │  │   Épica 5   │  │   Épica 6   │  │   Épica 7   │  │     WIS     │   │ │
│  │  │ Auto-Cure  │←│   Loop QA   │←│   Memória   │←│  Mecanismo  │   │ │
│  │  │   Loop      │  │ Orchestrate │  │   Layer     │  │   Learning   │   │ │
│  │  └─────────────┘  └─────────────┘  └─────────────┘  └─────────────┘   │ │
│  │                                                                        │ │
│  └────────────────────────────────────────────────────────────────────────┘ │
│                                                                              │
└─────────────────────────────────────────────────────────────────────────────┘

Prioridade:
  1. Scripts determinísticos      # Sempre preferir
  2. Queries SQL/JSON             # Previsível, auditável
  3. Regex/pattern matching       # Reproduzível
  4. LLM como último recurso      # Apenas quando criatividade é necessária

Componente: worktree-manager.js
Localização: .aios-core/infrastructure/scripts/

Fluxo:
  1. Story iniciada → Criar worktree
  2. Desenvolvimento → Trabalhar em isolamento
  3. Story completa → Merge e limpeza

Componente: project-status-loader.js
Localização: .aios-core/infrastructure/scripts/

Arquivo de Estado: .aios/project-status.yaml

projeto:
  nome: 'nome-projeto'
  storyAtual: 'STORY-001'
 
stories:
  STORY-001:
    status: em_progresso
    branch: feat/story-001
    specStatus: aprovada
    qaStatus: pendente

Componentes:
  - Workflow: spec-pipeline.yaml
  - Tarefas: spec-gather-requirements.md
             spec-assess-complexity.md
             spec-research-dependencies.md
             spec-write-spec.md
             spec-critique.md

SIMPLES: Coletar → Escrever → Criticar
PADRÃO: Coletar → Avaliar → Pesquisar → Escrever → Criticar → Planejar
COMPLEXO: Coletar → Avaliar → Pesquisar → Escrever → Criticar → Revisar → Criticar2 → Planejar

Componentes:
  - Scripts: plan-tracker.js
             subtask-verifier.js
  - Tarefas: plan-create-context.md
             plan-create-implementation.md
             plan-execute-subtask.md
             verify-subtask.md
  - Checklist: self-critique-checklist.md

{
  "storyId": "STORY-001",
  "subtarefas": [
    { "id": 1, "status": "completa", "verificada": true },
    { "id": 2, "status": "em_progresso", "verificada": false },
    { "id": 3, "status": "pendente", "verificada": false }
  ],
  "progresso": { "completas": 1, "total": 3, "percentual": 33 }
}

Componentes:
  - Scripts: stuck-detector.js
             recovery-tracker.js
             rollback-manager.js
             approach-manager.js
  - Template: current-approach-tmpl.md

Travamento Detectado → Registrar Abordagem → Tentar Alternativa → Sucesso?
                                                      ↓ Não
                                              Rollback → Escalar

Componentes:
  - Workflow: qa-loop.yaml
  - Scripts: qa-loop-orchestrator.js
             qa-report-generator.js
  - Tarefas: qa-review-build.md (10 fases)
             qa-create-fix-request.md
             qa-fix-issues.md
  - Template: qa-report-tmpl.md

┌─────────────────────────────────────────────────────────────┐
│                      Loop QA                                 │
├─────────────────────────────────────────────────────────────┤
│                                                              │
│  ┌─────────┐    ┌─────────┐    ┌─────────┐    ┌─────────┐  │
│  │ Review  │ → │ Gerar   │ → │ Verificar│ → │  Corrigir?  │
│  │ Build   │    │ Report  │    │ Veredicto│    │         │  │
│  └─────────┘    └─────────┘    └─────────┘    └────┬────┘  │
│                                                     │       │
│                 ┌───────────────────────────────────┘       │
│                 │                                           │
│          ┌──────▼──────┐                                    │
│          │  APROVADA   │ → Concluído                        │
│          └─────────────┘                                    │
│          ┌──────▼──────┐                                    │
│          │PRECISA_REVISAR│ → Criar Requisição Correção → @dev Corrigir │
│          └─────────────┘    └────────────────────────┘     │
│                                      │                      │
│                 ┌────────────────────┘                      │
│                 │ (máx 5 iterações)                         │
│                 └──────→ Voltar para Review                 │
│                                                              │
│          ┌──────▼──────┐                                    │
│          │   BLOQUEADA │ → Escalar para @architect          │
│          └─────────────┘                                    │
│                                                              │
└─────────────────────────────────────────────────────────────┘

Componentes:
  - Scripts: codebase-mapper.js
             pattern-extractor.js
             gotchas-documenter.js
  - Tarefas: capture-session-insights.md
             extract-patterns.md
             document-gotchas.md

autoClaude:
  specPipeline:
    phase: spec-gather
    role: primário
 
  qaLoop:
    phase: review
    role: revisor

{
  "storyAtual": "STORY-001",
  "specPipeline": {
    "phase": "critique",
    "iteration": 1
  },
  "qaLoop": {
    "iteration": 2,
    "verdict": "PRECISA_REVISAR"
  }
}

.aios/
├── project-status.yaml        # Status do projeto
├── status.json                # Status de runtime
├── patterns/                  # Padrões aprendidos (Épica 7)
│   ├── code-patterns.json
│   └── gotchas.json
├── worktrees/                 # Estado de worktree (Épica 1)
│   └── story-{id}.json
├── sessions/                  # Insights de sessão (Épica 7)
│   └── session-{timestamp}.json
└── qa-loops/                  # Estado de loop QA (Épica 6)
    └── {story-id}/
        ├── iteration-1.json
        ├── iteration-2.json
        └── qa-report.md

Início de Sessão → Carregar Estado → Executar → Atualizar Estado → Fim de Sessão
                       │                                 │
                       └── Recuperação se necessário ──┘

ade:
  enabled: true
 
  worktrees:
    enabled: true
    baseDir: .worktrees
    autoCleanup: true
 
  specPipeline:
    enabled: true
    maxIterations: 3
    strictGate: true
 
  qaLoop:
    enabled: true
    maxIterations: 5
    autoFix: true
 
  memoryLayer:
    enabled: true
    patternStore: .aios/patterns/
    sessionCapture: true
 
  selfHealing:
    enabled: true
    stuckThreshold: 3
    autoRollback: false

.aios-core/workflow-intelligence/
├── engine/
│   ├── confidence-scorer.js   # Pontuação de confiança de padrão
│   ├── output-formatter.js    # Formatação de saída
│   ├── suggestion-engine.js   # Sugestões inteligentes
│   └── wave-analyzer.js       # Análise de padrão wave
├── learning/
│   ├── capture-hook.js        # Hooks de captura de padrão
│   ├── pattern-capture.js     # Mecanismo de captura de padrão
│   ├── pattern-store.js       # Persistência de padrão
│   └── pattern-validator.js   # Validação de padrão
└── registry/
    └── workflow-registry.js   # Registro de workflow

estratégias:
  retry:
    maxTentativas: 3
    delay: exponencial
 
  alternativa:
    trigger: mesmo_erro_3x
    action: sugerir_abordagem
 
  rollback:
    trigger: corrupção_detectada
    action: restaurar_checkpoint
 
  escalar:
    trigger: max_iterações
    action: notificar_arquiteto