sinapse-ai 5.0.8 → 6.0.1

package/docs/es/architecture/ADE-AGENT-CHANGES.md

@@ -1,469 +0,0 @@
-# Cambios en los Agentes ADE - Alteraciones en los Agentes SINAPSE
-
-> **Documento:** Registro de las alteraciones realizadas en los agentes para soportar ADE
-> **Fecha:** 2026-01-29
-> **Estado:** Completo
-> **Relacionado:** ADE Epics 1-7
-
----
-
-## Descripción General
-
-Este documento registra todas las alteraciones realizadas en los archivos de definición de los agentes SINAPSE para soportar el SINAPSE Autonomous Development Engine (ADE).
-
-**Archivos modificados:**
-
-- `.sinapse-ai/development/agents/*.md` (fuente)
-- `.claude/commands/SINAPSE/agents/*.md` (sincronizado)
-
----
-
-## Formato autoClaude V3
-
-Todos los agentes fueron migrados para incluir la sección `autoClaude` en el formato V3:
-
-```yaml
-autoClaude:
-  version: '3.0'
-  migratedAt: '2026-01-29T02:24:XX.XXXZ'
-
-  # Capacidades del Spec Pipeline (Epic 3)
-  specPipeline:
-    canGather: boolean # Recolectar requisitos
-    canAssess: boolean # Evaluar complejidad
-    canResearch: boolean # Investigar dependencias
-    canWrite: boolean # Escribir spec
-    canCritique: boolean # Criticar spec
-
-  # Capacidades del Execution Engine (Epic 4)
-  execution:
-    canCreatePlan: boolean # Crear plan de implementación
-    canCreateContext: boolean # Crear contexto del proyecto
-    canExecute: boolean # Ejecutar subtasks
-    canVerify: boolean # Verificar subtasks
-
-  # Capacidades del Recovery System (Epic 5)
-  recovery:
-    canTrackAttempts: boolean # Rastrear intentos
-    canRollback: boolean # Hacer rollback
-
-  # Capacidades de QA Evolution (Epic 6)
-  qa:
-    canReview: boolean # Hacer review estructurado
-    canRequestFix: boolean # Solicitar correcciones
-
-  # Capacidades de Worktree (Epic 1)
-  worktree:
-    canCreate: boolean # Crear worktrees
-    canMerge: boolean # Hacer merge
-    canCleanup: boolean # Limpiar worktrees
-
-  # Capacidades de Memory Layer (Epic 7)
-  memory:
-    canCaptureInsights: boolean # Capturar insights
-    canExtractPatterns: boolean # Extraer patrones
-    canDocumentGotchas: boolean # Documentar gotchas
-```
-
----
-
-## Alteraciones por Agente
-
-### @devops (Gage)
-
-**Archivo:** `.sinapse-ai/development/agents/devops.md`
-
-**Comandos Añadidos:**
-
-```yaml
-# Worktree Management (Epic 1 - ADE Infrastructure)
-- create-worktree {story}: Crear worktree aislado para desarrollo de story
-- list-worktrees: Listar todos los worktrees activos con estado
-- merge-worktree {story}: Hacer merge del worktree completado de vuelta a main
-- cleanup-worktrees: Eliminar worktrees obsoletos/mergeados
-
-# Migration Management (Epic 2 - V2→V3 Migration)
-- inventory-assets: Generar inventario de migración desde assets V2
-- analyze-paths: Analizar dependencias de rutas e impacto de migración
-- migrate-agent: Migrar un solo agente del formato V2 al V3
-- migrate-batch: Migrar en lote todos los agentes con validación
-```
-
-**Capacidades autoClaude:**
-
-```yaml
-autoClaude:
-  version: '3.0'
-  worktree:
-    canCreate: true
-    canMerge: true
-    canCleanup: true
-```
-
-**Dependencias Añadidas:**
-
-```yaml
-dependencies:
-  scripts:
-    # Worktree Management (Epic 1)
-    - worktree-manager.js
-    - story-worktree-hooks.js
-    - project-status-loader.js
-    # Migration Management (Epic 2)
-    - asset-inventory.js
-    - path-analyzer.js
-    - migrate-agent.js
-  tasks:
-    - worktree-create.md
-    - worktree-list.md
-    - worktree-merge.md
-  workflows:
-    - auto-worktree.yaml
-```
-
----
-
-### @pm (Morgan)
-
-**Archivo:** `.sinapse-ai/development/agents/pm.md`
-
-**Comandos Añadidos:**
-
-```yaml
-# Spec Pipeline (Epic 3 - ADE)
-- gather-requirements: Recopilar y documentar requisitos de los stakeholders
-- write-spec: Generar documento de especificación formal a partir de requisitos
-```
-
-**Capacidades autoClaude:**
-
-```yaml
-autoClaude:
-  version: '3.0'
-  specPipeline:
-    canGather: true
-    canAssess: false
-    canResearch: false
-    canWrite: true
-    canCritique: false
-```
-
-**Dependencias Añadidas:**
-
-```yaml
-dependencies:
-  tasks:
-    # Spec Pipeline (Epic 3)
-    - spec-gather-requirements.md
-    - spec-write-spec.md
-```
-
----
-
-### @architect (Aria)
-
-**Archivo:** `.sinapse-ai/development/agents/architect.md`
-
-**Comandos Añadidos:**
-
-```yaml
-# Spec Pipeline (Epic 3 - ADE)
-- assess-complexity: Evaluar complejidad de la story y estimar esfuerzo
-
-# Execution Engine (Epic 4 - ADE)
-- create-plan: Crear plan de implementación con fases y subtasks
-- create-context: Generar contexto del proyecto y archivos para la story
-
-# Memory Layer (Epic 7 - ADE)
-- map-codebase: Generar mapa del codebase (estructura, servicios, patrones, convenciones)
-```
-
-**Capacidades autoClaude:**
-
-```yaml
-autoClaude:
-  version: '3.0'
-  specPipeline:
-    canGather: false
-    canAssess: true
-    canResearch: false
-    canWrite: false
-    canCritique: false
-  execution:
-    canCreatePlan: true
-    canCreateContext: true
-    canExecute: false
-    canVerify: false
-```
-
-**Dependencias Añadidas:**
-
-```yaml
-dependencies:
-  tasks:
-    # Spec Pipeline (Epic 3)
-    - spec-assess-complexity.md
-    # Execution Engine (Epic 4)
-    - plan-create-implementation.md
-    - plan-create-context.md
-  scripts:
-    # Memory Layer (Epic 7)
-    - codebase-mapper.js
-```
-
----
-
-### @analyst (Atlas)
-
-**Archivo:** `.sinapse-ai/development/agents/analyst.md`
-
-**Comandos Añadidos:**
-
-```yaml
-# Spec Pipeline (Epic 3 - ADE)
-- research-deps: Investigar dependencias y restricciones técnicas para la story
-
-# Memory Layer (Epic 7 - ADE)
-- extract-patterns: Extraer y documentar patrones de código del codebase
-```
-
-**Capacidades autoClaude:**
-
-```yaml
-autoClaude:
-  version: '3.0'
-  specPipeline:
-    canGather: false
-    canAssess: false
-    canResearch: true
-    canWrite: false
-    canCritique: false
-  memory:
-    canCaptureInsights: false
-    canExtractPatterns: true
-    canDocumentGotchas: false
-```
-
-**Dependencias Añadidas:**
-
-```yaml
-dependencies:
-  tasks:
-    # Spec Pipeline (Epic 3)
-    - spec-research-dependencies.md
-  scripts:
-    # Memory Layer (Epic 7)
-    - pattern-extractor.js
-```
-
----
-
-### @qa (Quinn)
-
-**Archivo:** `.sinapse-ai/development/agents/qa.md`
-
-**Comandos Añadidos:**
-
-```yaml
-# Structured Review (Epic 6 - QA Evolution)
-- 'review-build {story}': Review de QA estructurado en 10 fases - genera qa_report.md
-- 'request-fix {issue}': Solicitar corrección específica de @dev con contexto
-- 'verify-fix {issue}': Verificar que la corrección fue implementada correctamente
-
-# Spec Pipeline (Epic 3 - ADE)
-- 'critique-spec {story}': Revisar y criticar especificación para completitud
-```
-
-**Capacidades autoClaude:**
-
-```yaml
-autoClaude:
-  version: '3.0'
-  specPipeline:
-    canGather: false
-    canAssess: false
-    canResearch: false
-    canWrite: false
-    canCritique: true
-  qa:
-    canReview: true
-    canRequestFix: true
-```
-
-**Dependencias Añadidas:**
-
-```yaml
-dependencies:
-  tasks:
-    # Spec Pipeline (Epic 3)
-    - spec-critique.md
-    # QA Evolution (Epic 6)
-    - qa-review-build.md
-    - qa-fix-issues.md
-    - qa-structured-review.md
-  scripts:
-    - qa-loop-orchestrator.js
-    - qa-report-generator.js
-  workflows:
-    - qa-loop.yaml
-  templates:
-    - qa-report-tmpl.yaml
-```
-
----
-
-### @dev (Dexter)
-
-**Archivo:** `.sinapse-ai/development/agents/dev.md`
-
-**Comandos Añadidos:**
-
-```yaml
-# Execution Engine (Epic 4 - ADE)
-- name: execute-subtask
-  visibility: [full, quick]
-  description: 'Ejecutar una subtask siguiendo workflow de 13 pasos con auto-crítica'
-
-# Recovery System (Epic 5 - ADE)
-- name: track-attempt
-  visibility: [full, quick]
-  description: 'Rastrear intento de implementación para una subtask (registra en recovery/attempts.json)'
-- name: rollback
-  visibility: [full, quick]
-  description: 'Rollback al último estado bueno para una subtask (--hard para omitir confirmación)'
-
-# QA Loop (Epic 6)
-- name: apply-qa-fix
-  visibility: [full, quick]
-  description: 'Aplicar corrección solicitada por QA (lee qa_report.md para contexto)'
-
-# Memory Layer (Epic 7 - ADE)
-- name: capture-insights
-  visibility: [full, quick]
-  description: 'Capturar insights de sesión (descubrimientos, patrones, gotchas, decisiones)'
-- name: list-gotchas
-  visibility: [full, quick]
-  description: 'Listar gotchas conocidos de .sinapse/gotchas.md'
-```
-
-**Capacidades autoClaude:**
-
-```yaml
-autoClaude:
-  version: '3.0'
-  execution:
-    canCreatePlan: false
-    canCreateContext: false
-    canExecute: true
-    canVerify: true
-  recovery:
-    canTrackAttempts: true
-    canRollback: true
-  memory:
-    canCaptureInsights: true
-    canExtractPatterns: false
-    canDocumentGotchas: true
-```
-
-**Dependencias Añadidas:**
-
-```yaml
-dependencies:
-  tasks:
-    # Execution Engine (Epic 4)
-    - plan-execute-subtask.md
-    # QA Evolution (Epic 6)
-    - qa-fix-issues.md
-    # Memory Layer (Epic 7)
-    - capture-session-insights.md
-  scripts:
-    # Execution Engine (Epic 4)
-    - subtask-verifier.js
-    - plan-tracker.js
-    # Recovery System (Epic 5)
-    - recovery-tracker.js
-    - approach-manager.js
-    - rollback-manager.js
-    - stuck-detector.js
-    # Memory Layer (Epic 7)
-    - gotchas-documenter.js
-  checklists:
-    - self-critique-checklist.md
-```
-
----
-
-## Matriz de Capacidades por Agente
-
-| Capacidad          | @devops | @pm | @architect | @analyst | @qa | @dev |
-| ------------------ | ------- | --- | ---------- | -------- | --- | ---- |
-| **Spec Pipeline**  |
-| canGather          | -       | YES | -          | -        | -   | -    |
-| canAssess          | -       | -   | YES        | -        | -   | -    |
-| canResearch        | -       | -   | -          | YES      | -   | -    |
-| canWrite           | -       | YES | -          | -        | -   | -    |
-| canCritique        | -       | -   | -          | -        | YES | -    |
-| **Execution**      |
-| canCreatePlan      | -       | -   | YES        | -        | -   | -    |
-| canCreateContext   | -       | -   | YES        | -        | -   | -    |
-| canExecute         | -       | -   | -          | -        | -   | YES  |
-| canVerify          | -       | -   | -          | -        | -   | YES  |
-| **Recovery**       |
-| canTrackAttempts   | -       | -   | -          | -        | -   | YES  |
-| canRollback        | -       | -   | -          | -        | -   | YES  |
-| **QA**             |
-| canReview          | -       | -   | -          | -        | YES | -    |
-| canRequestFix      | -       | -   | -          | -        | YES | -    |
-| **Worktree**       |
-| canCreate          | YES     | -   | -          | -        | -   | -    |
-| canMerge           | YES     | -   | -          | -        | -   | -    |
-| canCleanup         | YES     | -   | -          | -        | -   | -    |
-| **Memory**         |
-| canCaptureInsights | -       | -   | -          | -        | -   | YES  |
-| canExtractPatterns | -       | -   | -          | YES      | -   | -    |
-| canDocumentGotchas | -       | -   | -          | -        | -   | YES  |
-
----
-
-## Sincronización de Archivos
-
-Todos los agentes fueron sincronizados entre:
-
-```
-.sinapse-ai/development/agents/   →   .claude/commands/SINAPSE/agents/
-         (fuente)                           (sincronizado)
-```
-
-**Agentes sincronizados:**
-
-- analyst.md
-- architect.md
-- dev.md
-- devops.md
-- pm.md
-- po.md
-- qa.md
-- sm.md
-- ux-design-expert.md
-- data-engineer.md
-- sinapse-master.md
-- squad-creator.md
-
----
-
-## Validación
-
-Todos los agentes validan contra:
-
-- `.sinapse-ai/infrastructure/schemas/agent-v3-schema.json`
-
-**Comando para validar:**
-
-```bash
-node .sinapse-ai/infrastructure/scripts/migrate-agent.js --validate
-```
-
----
-
-_Documento creado por Quinn (@qa) - Guardián de la Calidad_
-_Fecha: 2026-01-29_