Version: 1.0.0 Fecha: 2026-01-29 Estado: Production Ready
El AIOX Autonomous Development Engine (ADE) es un sistema de desarrollo autonomo que transforma requisitos vagos en codigo funcional a traves de pipelines estructurados y agentes especializados.
- Spec Pipeline - Transforma ideas en especificaciones ejecutables
- Execution Engine - Ejecuta subtasks con self-critique obligatorio
- Recovery System - Recupera de fallos automaticamente
- QA Evolution - Review estructurado en 10 fases
- Memory Layer - Aprende y documenta patrones
┌─────────────────────────────────────────────────────────────────────────────┐
│ ADE Architecture │
│ │
│ User Request ──► Spec Pipeline ──► Execution Engine ──► Working Code │
│ │ │
│ ▼ │
│ Recovery System │
│ │ │
│ ▼ │
│ QA Evolution │
│ │ │
│ ▼ │
│ Memory Layer │
└─────────────────────────────────────────────────────────────────────────────┘
Proposito: Aislamiento de branches via Git worktrees
Comandos (@devops):
*create-worktree {story}- Crear worktree aislado*list-worktrees- Listar worktrees activos*merge-worktree {story}- Hacer merge del worktree*cleanup-worktrees- Eliminar worktrees antiguos
Documentacion: ADE-EPIC1-HANDOFF.md
Proposito: Migracion al formato autoClaude V3
Comandos (@devops):
*inventory-assets- Inventario de assets V2*analyze-paths- Analizar dependencias*migrate-agent- Migrar agente individual*migrate-batch- Migrar todos en batch
Documentacion: ADE-EPIC2-HANDOFF.md
Proposito: Transformar requisitos en specs ejecutables
Flujo:
User Request → Gather → Assess → Research → Write → Critique → Spec Ready
Comandos por Agente:
| Agente | Comando | Fase |
|---|---|---|
| @pm | *gather-requirements |
Recopilar requisitos |
| @architect | *assess-complexity |
Evaluar complejidad |
| @analyst | *research-deps |
Investigar dependencias |
| @pm | *write-spec |
Escribir spec |
| @qa | *critique-spec |
Criticar y aprobar |
Documentacion: ADE-EPIC3-HANDOFF.md
Proposito: Ejecutar specs en codigo funcional
13 Pasos del Coder:
- Load Context
- Read Implementation Plan
- Understand Current Subtask
- Plan Approach
- Write Code
- 5.5 SELF-CRITIQUE (obligatorio)
- Run Tests
- 6.5 SELF-CRITIQUE (obligatorio)
- Fix Issues
- Run Linter
- Fix Lint Issues
- Verify Manually
- Update Plan Status
- Commit Changes
- Signal Completion
Comandos (@architect):
*create-plan- Crear plan de implementacion*create-context- Generar contexto del proyecto
Comandos (@dev):
*execute-subtask- Ejecutar subtask
Documentacion: ADE-EPIC4-HANDOFF.md
Proposito: Recuperar de fallos en subtasks
Flujo:
Subtask Fails → Track Attempt → Retry (<3) → Stuck Detection → Rollback → Escalate
Comandos (@dev):
*track-attempt- Registrar intento*rollback- Volver al estado anterior
Documentacion: ADE-EPIC5-HANDOFF.md
Proposito: Review estructurado en 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 correccion*verify-fix {issue}- Verificar correccion
Comandos (@dev):
*apply-qa-fix- Aplicar correccion del QA
Documentacion: ADE-EPIC6-HANDOFF.md
Proposito: Memoria persistente de patrones e insights
Tipos de Memoria:
- Insights - Descubrimientos durante el desarrollo
- Patterns - Patrones de codigo extraidos
- Gotchas - Trampas conocidas
- Decisions - Decisiones arquitecturales
Comandos (@dev):
*capture-insights- Capturar insights de la sesion*list-gotchas- Listar gotchas conocidas
Comandos (@architect):
*map-codebase- Generar mapa del codebase
Comandos (@analyst):
*extract-patterns- Extraer patrones del codigo
Documentacion: ADE-EPIC7-HANDOFF.md
# Activar PM y recopilar requisitos
@pm *gather-requirements
# Evaluar complejidad
@architect *assess-complexity
# Investigar dependencias
@analyst *research-deps
# Escribir spec
@pm *write-spec
# Criticar y aprobar
@qa *critique-spec# Crear plan de implementacion
@architect *create-plan
# Crear contexto del proyecto
@architect *create-context
# Ejecutar subtasks (bucle)
@dev *execute-subtask 1.1
@dev *execute-subtask 1.2
...# Review estructurado
@qa *review-build STORY-42
# Si hay issues:
@qa *request-fix "Missing error handling"
@dev *apply-qa-fix
@qa *verify-fix# Capturar insights de la sesion
@dev *capture-insights
# Documentar gotchas
@dev *list-gotchas.aiox-core/
├── development/
│ ├── agents/ # Definiciones de agentes V3
│ ├── tasks/ # Tasks ejecutables
│ │ ├── 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:
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 # @devautoClaude:
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'Cada Epic tiene un QA Gate que debe pasar antes de continuar:
@qa *gate epic-{N}-{name}Decisiones:
- PASS - Proximo epic liberado
- CONCERNS - Aprobado con follow-ups
- FAIL - Retorna para correcciones
- WAIVED - Bypass autorizado por @po
# Verificar historial de intentos
@dev *track-attempt --status
# Rollback al ultimo estado bueno
@dev *rollback --hard
# Intentar enfoque diferente
@dev *execute-subtask 2.1 --approach alternative# Ver feedback del critique
cat docs/stories/STORY-42/spec-critique.json
# Refinar spec
@pm *write-spec --iterate
# Re-enviar para critique
@qa *critique-spec# Listar worktrees
@devops *list-worktrees
# Resolver conflictos
@devops *merge-worktree STORY-42 --resolve
# Cleanup
@devops *cleanup-worktrees- ADE Architect Handoff - Overview general
- ADE Agent Changes - Alteraciones en todos los agentes con matriz de capabilities
- 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
AIOX Autonomous Development Engine - Transformando Ideas en Codigo Automaticamente