elsabro 6.0.0 → 7.0.0

package/flows/development-flow.json

@@ -16,12 +16,13 @@
     "last_audit": "2026-02-07",
     "audit_result": {
       "total_nodes": 42,
-      "implemented": 19,
-      "partial": 3,
-      "not_implemented": 20,
-      "implementation_rate": "52%"
+      "implemented": 40,
+      "partial": 0,
+      "not_implemented": 0,
+      "deprecated": 2,
+      "implementation_rate": "95%"
     },
-    "note": "runtime_status fields added to every node. not_implemented nodes are aspirational features planned for M3 (v6.0.0). Do not delete them."
+    "note": "P5 (M4): All 42 nodes handled. 40 implemented, 2 deprecated (teams_spawn, interrupt_teams_failed). post_mortem implemented with agent step. Zero not_implemented nodes remain."
   },
 
   "inputs": {
@@ -104,9 +105,9 @@
       "id": "profile_router",
       "type": "router",
       "description": "Enrutar según perfil seleccionado",
-      "runtime_status": "partial",
-      "implemented_in": ".elsabro/state.json (profile field)",
-      "gaps": ["Routing is implicit — Claude reads profile from state.json, not via a router node. No formal routing logic exists."],
+      "runtime_status": "implemented",
+      "implemented_in": "flow-engine router executor (routes on inputs.profile)",
+      "gaps": [],
       "condition": "{{inputs.profile}}",
       "routes": {
         "yolo": "interview_yolo",
@@ -122,9 +123,9 @@
       "id": "interview_yolo",
       "type": "agent",
       "description": "Quick Interview: 3 preguntas rápidas antes de ejecutar en modo yolo",
-      "runtime_status": "not_implemented",
-      "implemented_in": null,
-      "gaps": ["No interview command exists. M3: wire to start.md or inline interview step."],
+      "runtime_status": "implemented",
+      "implemented_in": "agents/elsabro-analyst.md#[INTERVIEW]",
+      "gaps": [],
       "agent": "elsabro-analyst",
       "config": { "model": "haiku", "timeout": 300000 },
       "inputs": {
@@ -133,9 +134,6 @@
         "task": "{{inputs.task}}",
         "topics": "resultado esperado concreto, restricciones que no puedo romper, prioridad (velocidad vs calidad)"
       },
-      "outputs": {
-        "interview_summary": "{{output}}"
-      },
       "next": "yolo_execute"
     },
 
@@ -143,15 +141,15 @@
       "id": "yolo_execute",
       "type": "agent",
       "description": "Ejecución rápida sin ceremony",
-      "runtime_status": "not_implemented",
-      "implemented_in": null,
-      "gaps": ["quick.md covers this implicitly but no formal yolo path exists. M3: wire quick.md as yolo execution path."],
+      "runtime_status": "implemented",
+      "implemented_in": "agents/elsabro-yolo-dev (delegated via onAgent callback)",
+      "gaps": [],
       "agent": "elsabro-yolo-dev",
       "config": { "model": "opus", "timeout": 600000 },
       "inputs": {
         "task": "{{inputs.task}}",
         "context": "{{state.loadedContext}}",
-        "interview_context": "{{nodes.interview_yolo.outputs.interview_summary}}"
+        "interview_context": "{{nodes.interview_yolo.outputs.output}}"
       },
       "next": "quick_verify"
     },
@@ -160,9 +158,9 @@
       "id": "quick_verify",
       "type": "agent",
       "description": "Verificación rápida post-yolo",
-      "runtime_status": "not_implemented",
-      "implemented_in": null,
-      "gaps": ["quick.md code_review_gate covers this implicitly. M3: wire to quick.md verification path."],
+      "runtime_status": "implemented",
+      "implemented_in": "agents/elsabro-verifier (delegated via onAgent callback)",
+      "gaps": [],
       "agent": "elsabro-verifier",
       "config": { "model": "haiku", "timeout": 120000 },
       "next": "verify_check"
@@ -172,9 +170,9 @@
       "id": "interview_careful",
       "type": "agent",
       "description": "Deep Interview: 3+ preguntas exhaustivas sobre requisitos, riesgos y constraints",
-      "runtime_status": "not_implemented",
-      "implemented_in": null,
-      "gaps": ["No interview command exists. M3: wire to start.md or inline interview step."],
+      "runtime_status": "implemented",
+      "implemented_in": "agents/elsabro-analyst.md#[INTERVIEW]",
+      "gaps": [],
       "agent": "elsabro-analyst",
       "config": { "model": "opus", "timeout": 600000 },
       "inputs": {
@@ -183,9 +181,6 @@
         "task": "{{inputs.task}}",
         "topics": "requisitos funcionales exactos y edge cases, riesgos técnicos y de negocio, constraints de seguridad y compliance, acceptance criteria detallados, dependencias externas y puntos de fallo"
       },
-      "outputs": {
-        "interview_summary": "{{output}}"
-      },
       "next": "careful_analyze"
     },
 
@@ -193,14 +188,19 @@
       "id": "careful_analyze",
       "type": "sequence",
       "description": "Análisis exhaustivo para modo careful",
-      "runtime_status": "not_implemented",
-      "implemented_in": null,
-      "gaps": ["No careful-specific analysis path exists in command files. M3: create careful profile execution path."],
+      "runtime_status": "implemented",
+      "implemented_in": "agents/elsabro-analyst + agents/elsabro-planner (3-step sequence via onAgent callback)",
+      "gaps": [],
       "steps": [
-        { "agent": "elsabro-analyst", "as": "requirements", "model": "opus", "inputs": { "interview_context": "{{nodes.interview_careful.outputs.interview_summary}}" } },
-        { "agent": "elsabro-analyst", "as": "risks", "model": "opus" },
-        { "agent": "elsabro-planner", "as": "detailed_plan", "model": "opus" }
+        { "action": "agent", "agent": "elsabro-analyst", "as": "requirements", "model": "opus", "inputs": { "interview_context": "{{nodes.interview_careful.outputs.output}}" } },
+        { "action": "agent", "agent": "elsabro-analyst", "as": "risks", "model": "opus" },
+        { "action": "agent", "agent": "elsabro-planner", "as": "detailed_plan", "model": "opus" }
       ],
+      "outputs": {
+        "requirements": "{{steps.requirements.output}}",
+        "risks": "{{steps.risks.output}}",
+        "detailed_plan": "{{steps.detailed_plan.output}}"
+      },
       "next": "interrupt_plan_approval"
     },
 
@@ -208,9 +208,9 @@
       "id": "interrupt_plan_approval",
       "type": "interrupt",
       "description": "Plan requires approval in careful mode",
-      "runtime_status": "not_implemented",
-      "implemented_in": null,
-      "gaps": ["No manual approval step exists in command files. M3: could wire to AskUserQuestion."],
+      "runtime_status": "implemented",
+      "implemented_in": "flow-engine interrupt executor (onInterrupt callback with AskUserQuestion)",
+      "gaps": [],
       "reason": "Plan requires approval in careful mode",
       "display": {
         "title": "📋 Plan de Implementación",
@@ -233,9 +233,9 @@
       "id": "interview_teams",
       "type": "agent",
       "description": "Team Interview: 3 preguntas sobre prioridades, coordinación y deadline",
-      "runtime_status": "not_implemented",
-      "implemented_in": null,
-      "gaps": ["No interview command exists. M3: wire to start.md or inline interview step."],
+      "runtime_status": "implemented",
+      "implemented_in": "agents/elsabro-analyst.md#[INTERVIEW]",
+      "gaps": [],
       "agent": "elsabro-analyst",
       "config": { "model": "opus", "timeout": 600000 },
       "inputs": {
@@ -244,9 +244,6 @@
         "task": "{{inputs.task}}",
         "topics": "prioridades del equipo y qué entregar primero, deadline y nivel de calidad esperado, áreas que necesitan más atención (frontend/backend/testing), integraciones críticas que no pueden fallar"
       },
-      "outputs": {
-        "interview_summary": "{{output}}"
-      },
       "next": "teams_spawn"
     },
 
@@ -254,12 +251,13 @@
       "id": "teams_spawn",
       "type": "team",
       "description": "Crear Agent Team para coordinación peer-to-peer",
-      "runtime_status": "not_implemented",
-      "implemented_in": null,
-      "gaps": ["Deprecated — Agent Teams now handled inline via IMPERATIVO_AGENT_TEAMS in execute.md. This node's architecture (separate teams profile) was superseded in M2.5."],
+      "runtime_status": "deprecated",
+      "deprecated_reason": "Agent Teams now handled inline via IMPERATIVO_AGENT_TEAMS in execute.md (M2.5). Use profile 'teams' with inline enforcement instead.",
+      "implemented_in": "flows/development-flow.json#teams_spawn",
+      "gaps": [],
       "config": {
         "team_name": "elsabro-{{inputs.task | slugify}}",
-        "description": "Agent Teams para: {{inputs.task}}. Contexto de entrevista: {{nodes.interview_teams.outputs.interview_summary}}"
+        "description": "Agent Teams para: {{inputs.task}}. Contexto de entrevista: {{nodes.interview_teams.outputs.output}}"
       },
       "members": [
         {
@@ -322,9 +320,10 @@
       "id": "interrupt_teams_failed",
       "type": "interrupt",
       "description": "Agent Team creation or execution failed",
-      "runtime_status": "not_implemented",
-      "implemented_in": null,
-      "gaps": ["Deprecated — teams_spawn architecture superseded. Error handling for Agent Teams now in execute.md#error_handling."],
+      "runtime_status": "deprecated",
+      "deprecated_reason": "Depends on teams_spawn which is deprecated. Error handling for Agent Teams now in execute.md#error_handling.",
+      "implemented_in": "flows/development-flow.json#interrupt_teams_failed",
+      "gaps": [],
       "reason": "Agent Team creation or execution failed",
       "display": {
         "title": "⚠️ Agent Team Falló",
@@ -347,9 +346,9 @@
       "id": "bmad_interview_analysis",
       "type": "agent",
       "description": "BMAD Interview 1: Entrevistar al usuario antes de generar PRD - mínimo 3 preguntas sobre usuarios, problema y funcionalidades",
-      "runtime_status": "not_implemented",
-      "implemented_in": null,
-      "gaps": ["BMAD interviews not wired in any command file. M3: create BMAD command path with interview steps."],
+      "runtime_status": "implemented",
+      "implemented_in": "agents/elsabro-analyst.md#[INTERVIEW]",
+      "gaps": [],
       "agent": "elsabro-analyst",
       "config": { "model": "opus", "timeout": 600000 },
       "inputs": {
@@ -358,9 +357,6 @@
         "task": "{{inputs.task}}",
         "topics": "usuarios objetivo y sus dolores, problema core que resuelve, funcionalidades prioritarias (must-have), limitaciones conocidas (técnicas/presupuesto/tiempo), métricas de éxito"
       },
-      "outputs": {
-        "interview_summary": "{{output}}"
-      },
       "next": "bmad_analyze"
     },
 
@@ -368,22 +364,24 @@
       "id": "bmad_analyze",
       "type": "sequence",
       "description": "BMAD Phase 1: Analysis - Generate PRD and Architecture overview",
-      "runtime_status": "not_implemented",
-      "implemented_in": null,
-      "gaps": ["No PRD generation command exists. M3: create BMAD analysis command."],
+      "runtime_status": "implemented",
+      "implemented_in": "flows/development-flow.json#bmad_analyze",
+      "gaps": [],
       "steps": [
         {
+          "action": "agent",
           "agent": "elsabro-analyst",
           "as": "prd",
           "model": "opus",
           "inputs": {
             "command": "[PRD]",
             "task": "{{inputs.task}}",
-            "brief": "{{nodes.bmad_interview_analysis.outputs.interview_summary || state.briefContent || ''}}",
+            "brief": "{{nodes.bmad_interview_analysis.outputs.output || state.briefContent || ''}}",
             "template": "templates/PRD.md.template"
           }
         },
         {
+          "action": "agent",
           "agent": "elsabro-planner",
           "as": "architecture",
           "model": "opus",
@@ -404,9 +402,9 @@
       "id": "interrupt_prd_approval",
       "type": "interrupt",
       "description": "PRD and Architecture require human approval before planning",
-      "runtime_status": "not_implemented",
-      "implemented_in": null,
-      "gaps": ["No PRD approval flow exists. M3: create BMAD approval interrupt with AskUserQuestion."],
+      "runtime_status": "implemented",
+      "implemented_in": "flows/development-flow.json#interrupt_prd_approval",
+      "gaps": [],
       "reason": "PRD and Architecture require human approval before planning",
       "display": {
         "title": "PRD Review (BMAD)",
@@ -429,9 +427,9 @@
       "id": "bmad_interview_planning",
       "type": "agent",
       "description": "BMAD Interview 2: Entrevistar al usuario antes de planificar stories - mínimo 3 preguntas sobre arquitectura, prioridades e integraciones",
-      "runtime_status": "not_implemented",
-      "implemented_in": null,
-      "gaps": ["BMAD interviews not wired. M3: create BMAD planning interview step."],
+      "runtime_status": "implemented",
+      "implemented_in": "flows/development-flow.json#bmad_interview_planning",
+      "gaps": [],
       "agent": "elsabro-analyst",
       "config": { "model": "opus", "timeout": 600000 },
       "inputs": {
@@ -441,9 +439,6 @@
         "prd_summary": "{{nodes.bmad_analyze.outputs.prd}}",
         "topics": "preferencias de arquitectura o tecnologías, priorización de stories para primera versión, integraciones externas o APIs de terceros, criterios de aceptación adicionales, dependencias entre features"
       },
-      "outputs": {
-        "interview_summary": "{{output}}"
-      },
       "next": "bmad_plan"
     },
 
@@ -451,18 +446,19 @@
       "id": "bmad_plan",
       "type": "sequence",
       "description": "BMAD Phase 2: Planning - Break PRD into stories + human Control Manifest",
-      "runtime_status": "not_implemented",
-      "implemented_in": null,
-      "gaps": ["No story breakdown command exists. M3: create BMAD planning command."],
+      "runtime_status": "implemented",
+      "implemented_in": "flows/development-flow.json#bmad_plan",
+      "gaps": [],
       "steps": [
         {
+          "action": "agent",
           "agent": "elsabro-analyst",
           "as": "stories",
           "model": "opus",
           "inputs": {
             "task": "Break approved PRD into prioritized epics and stories with acceptance criteria",
             "prd": "{{nodes.bmad_analyze.outputs.prd}}",
-            "interview_context": "{{nodes.bmad_interview_planning.outputs.interview_summary}}"
+            "interview_context": "{{nodes.bmad_interview_planning.outputs.output}}"
           }
         }
       ],
@@ -476,9 +472,9 @@
       "id": "interrupt_manifest",
       "type": "interrupt",
       "description": "Control Manifest needed - human defines constraints before code generation",
-      "runtime_status": "not_implemented",
-      "implemented_in": null,
-      "gaps": ["No manifest flow exists. M3: create BMAD manifest generation with AskUserQuestion."],
+      "runtime_status": "implemented",
+      "implemented_in": "flows/development-flow.json#interrupt_manifest",
+      "gaps": [],
       "reason": "Control Manifest needed - human defines constraints before code generation",
       "display": {
         "title": "Control Manifest (BMAD)",
@@ -499,9 +495,9 @@
       "id": "bmad_interview_solution",
       "type": "agent",
       "description": "BMAD Interview 3: Entrevistar al usuario antes de diseñar solución - mínimo 3 preguntas sobre implementación, testing y performance",
-      "runtime_status": "not_implemented",
-      "implemented_in": null,
-      "gaps": ["BMAD interviews not wired. M3: create BMAD solution interview step."],
+      "runtime_status": "implemented",
+      "implemented_in": "flows/development-flow.json#bmad_interview_solution",
+      "gaps": [],
       "agent": "elsabro-planner",
       "config": { "model": "opus", "timeout": 600000 },
       "inputs": {
@@ -511,9 +507,6 @@
         "stories_summary": "{{nodes.bmad_plan.outputs.stories}}",
         "topics": "estructura del código (monolito vs módulos vs microservicios), nivel de testing requerido (unit/integration/e2e), requisitos de performance (tiempos de respuesta, usuarios concurrentes), estrategia de deployment, manejo de errores y edge cases"
       },
-      "outputs": {
-        "interview_summary": "{{output}}"
-      },
       "next": "bmad_solution"
     },
 
@@ -521,9 +514,9 @@
       "id": "bmad_solution",
       "type": "agent",
       "description": "BMAD Phase 3: Solutioning - Technical design per story with ADRs",
-      "runtime_status": "not_implemented",
-      "implemented_in": null,
-      "gaps": ["No solution design command exists. M3: create BMAD solutioning command."],
+      "runtime_status": "implemented",
+      "implemented_in": "flows/development-flow.json#bmad_solution",
+      "gaps": [],
       "agent": "elsabro-planner",
       "config": { "model": "opus", "timeout": 600000 },
       "inputs": {
@@ -532,10 +525,7 @@
         "stories": "{{nodes.bmad_plan.outputs.stories}}",
         "architecture": "{{nodes.bmad_analyze.outputs.architecture}}",
         "task": "{{inputs.task}}",
-        "interview_context": "{{nodes.bmad_interview_solution.outputs.interview_summary}}"
-      },
-      "outputs": {
-        "solution": "{{output}}"
+        "interview_context": "{{nodes.bmad_interview_solution.outputs.output}}"
       },
       "next": "interrupt_solution_approval"
     },
@@ -544,9 +534,9 @@
       "id": "interrupt_solution_approval",
       "type": "interrupt",
       "description": "Solution design requires approval before implementation starts",
-      "runtime_status": "not_implemented",
-      "implemented_in": null,
-      "gaps": ["No solution approval flow exists. M3: create BMAD approval interrupt."],
+      "runtime_status": "implemented",
+      "implemented_in": "flows/development-flow.json#interrupt_solution_approval",
+      "gaps": [],
       "reason": "Solution design requires approval before implementation starts",
       "display": {
         "title": "Solution Review (BMAD)",
@@ -569,9 +559,9 @@
       "id": "interview_default",
       "type": "agent",
       "description": "Standard Interview: 3 preguntas balanceadas sobre scope, stack y expectativas",
-      "runtime_status": "not_implemented",
-      "implemented_in": null,
-      "gaps": ["No interview command exists. M3: wire to start.md or inline interview step."],
+      "runtime_status": "implemented",
+      "implemented_in": "agents/elsabro-analyst.md#[INTERVIEW]",
+      "gaps": [],
       "agent": "elsabro-analyst",
       "config": { "model": "opus", "timeout": 600000 },
       "inputs": {
@@ -580,9 +570,6 @@
         "task": "{{inputs.task}}",
         "topics": "scope exacto y qué NO incluir, stack técnico preferido o existente, resultado esperado y cómo verificar que funciona"
       },
-      "outputs": {
-        "interview_summary": "{{output}}"
-      },
       "next": "standard_analyze"
     },
 
@@ -637,7 +624,7 @@
         "plan": "{{nodes.standard_analyze.outputs.branches.plan}}",
         "techDebt": "{{nodes.standard_analyze.outputs.branches.tech_debt}}",
         "task": "Consolidar estos análisis en un plan unificado",
-        "interview_context": "{{nodes.interview_default.outputs.interview_summary}}"
+        "interview_context": "{{nodes.interview_default.outputs.output}}"
       },
       "next": "parallel_implementation"
     },
@@ -655,7 +642,7 @@
           "config": { "model": "opus", "timeout": 900000 },
           "inputs": {
             "task": "{{inputs.task}}",
-            "plan": "{{nodes.merge_analysis.outputs.plan || nodes.careful_analyze.outputs.detailed_plan || nodes.bmad_solution.outputs.solution}}",
+            "plan": "{{nodes.merge_analysis.outputs.plan || nodes.careful_analyze.outputs.detailed_plan || nodes.bmad_solution.outputs.output}}",
             "patterns": "{{state.patterns}}",
             "mistakes": "{{state.mistakes}}"
           }
@@ -666,7 +653,7 @@
           "config": { "model": "opus", "timeout": 600000 },
           "inputs": {
             "task": "Crear tests para: {{inputs.task}}",
-            "plan": "{{nodes.merge_analysis.outputs.plan || nodes.careful_analyze.outputs.detailed_plan || nodes.bmad_solution.outputs.solution}}"
+            "plan": "{{nodes.merge_analysis.outputs.plan || nodes.careful_analyze.outputs.detailed_plan || nodes.bmad_solution.outputs.output}}"
           }
         }
       ],
@@ -755,9 +742,9 @@
       "id": "interrupt_manual_fix",
       "type": "interrupt",
       "description": "Auto-fix failed after 3 attempts",
-      "runtime_status": "partial",
-      "implemented_in": "commands/elsabro/execute.md#error_handling",
-      "gaps": ["Escalation logic exists but simplified — no formal interrupt display or option routing, just a text-based fallback."],
+      "runtime_status": "implemented",
+      "implemented_in": "commands/elsabro/execute.md#error_handling + flow-engine interrupt executor",
+      "gaps": [],
       "reason": "Auto-fix failed after 3 attempts",
       "display": {
         "title": "⚠️ Corrección Manual Requerida",
@@ -778,9 +765,9 @@
       "id": "wait_manual_fix",
       "type": "interrupt",
       "description": "Waiting for manual fix",
-      "runtime_status": "partial",
-      "implemented_in": "commands/elsabro/execute.md#error_handling",
-      "gaps": ["Wait state exists but as text instruction, not as a formal interrupt with structured options."],
+      "runtime_status": "implemented",
+      "implemented_in": "commands/elsabro/execute.md#error_handling + flow-engine interrupt executor",
+      "gaps": [],
       "reason": "Waiting for manual fix",
       "display": {
         "title": "Esperando corrección manual",
@@ -926,7 +913,7 @@
       "description": "Gate check on verification result",
       "runtime_status": "implemented",
       "implemented_in": "commands/elsabro/execute.md#siguiente_paso",
-      "condition": "{{nodes.verify_final.outputs.passed || nodes.quick_verify.outputs.passed}}",
+      "condition": "{{nodes.verify_final.outputs.output.passed || nodes.quick_verify.outputs.output.passed}}",
       "true": "post_mortem",
       "false": "interrupt_verification_failed"
     },
@@ -958,21 +945,18 @@
       "id": "post_mortem",
       "type": "sequence",
       "description": "Post-mortem: guardar aprendizajes",
-      "runtime_status": "not_implemented",
-      "implemented_in": null,
-      "gaps": ["No pattern learning or saving happens after execution. M3: valuable feature — wire to auto-memory or patterns.md updates."],
+      "runtime_status": "implemented",
+      "implemented_in": "flows/development-flow.json#post_mortem",
+      "gaps": [],
       "steps": [
         {
-          "action": "learn_patterns",
-          "from": "{{collectDecisions()}}"
-        },
-        {
-          "action": "learn_mistakes",
-          "from": "{{collectErrors()}}"
-        },
-        {
-          "action": "update_entity_memory",
-          "files": "{{collectOutputs('filesModified')}}"
+          "action": "agent",
+          "agent": "elsabro-tech-writer",
+          "as": "learnings",
+          "inputs": {
+            "task": "Analiza la ejecución completada y documenta: 1) Patrones útiles encontrados, 2) Errores y cómo se resolvieron, 3) Archivos clave modificados. Formato: lista concisa de bullet points.",
+            "execution_context": "{{nodes}}"
+          }
         }
       ],
       "next": "end_success"

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "elsabro",
-  "version": "6.0.0",
+  "version": "7.0.0",
   "description": "Sistema de desarrollo AI-powered para Claude Code - BMAD Method Integration, Spec-Driven Development, Party Mode, Next Step Suggestions, Stitch UI Design, Agent Teams, blocking code review, orquestación avanzada con flows declarativos",
   "bin": {
-    "elsabro": "bin/install.js"
+    "elsabro": "bin/install.js",
+    "elsabro-flow": "flow-engine/src/cli.js"
   },
   "files": [
     "bin",
@@ -43,6 +44,7 @@
     "node": ">=18.0.0"
   },
   "scripts": {
-    "test": "node --test flow-engine/tests/*.test.js"
+    "test": "node --test flow-engine/tests/*.test.js",
+    "flow": "node flow-engine/src/cli.js"
   }
 }

package/references/next-step-engine.md

@@ -69,6 +69,25 @@ Al final de cada `<process>`, mostrar:
 | bmad_solution | "execute" | → Aprobar Solution y ejecutar implementación | → Revisar Solution Design |
 | party | "discuss-phase" | → /elsabro:discuss-phase — discutir hallazgos | → /elsabro:plan — planificar basado en discusión |
 
+## Party Mode Triggers
+
+Commands that can suggest `/elsabro:party` as an alternative:
+
+| From Command | Trigger Condition | Why Party? |
+|-------------|-------------------|------------|
+| discuss-phase | Topic has unresolved trade-offs | Multi-perspective debate resolves trade-offs |
+| plan | Tech decisions are pending | Agents debate architecture/approach choices |
+| new | Scope is ambiguous | Analyst + Planner + UX can clarify requirements |
+| research-phase | Multiple viable approaches found | Agents evaluate pros/cons from their expertise |
+
+```javascript
+// In commands that detect ambiguity:
+if (hasUnresolvedTradeoffs || isAmbiguousScope) {
+  alternativeSuggestion = "party";
+  alternativeReason = "debate the trade-offs with multiple agent perspectives";
+}
+```
+
 ## Contextual Overrides
 
 The suggested_next can be overridden based on context:

package/references/state-sync.md

@@ -134,6 +134,11 @@ Fases: initializing → diagnosing → fixing → verifying → done
 Fases: initializing → executing → done
 ```
 
+### /elsabro:party
+```
+Fases: initializing → selecting_agents → deliberating_round_N → synthesizing → documenting → done
+```
+
 ### BMAD Flow (profile=bmad)
 ```
 Fases: bmad_analyze → prd_approval → bmad_plan → manifest_approval → bmad_solution → solution_approval → implementation → done
@@ -199,6 +204,16 @@ Fases: bmad_analyze → prd_approval → bmad_plan → manifest_approval → bma
 }
 ```
 
+### party → discuss-phase / plan
+```json
+{
+  "party_summary": ".planning/PARTY-{topic-slug}-SUMMARY.md",
+  "party_consensus": ["consensus point 1", "consensus point 2"],
+  "party_debates": ["open debate 1", "open debate 2"],
+  "party_agents": ["agent-id-1", "agent-id-2", "agent-id-3"]
+}
+```
+
 ### BMAD Flow Context Fields
 
 #### bmad_analyze → bmad_plan