Stage 4 — User Q&A (Punto de pausa humana)

Cuarta etapa. Reúne las dudas abiertas tras la discusión del panel y las presenta al usuario de forma corta y accionable. Único checkpoint humano del pipeline.

Responsabilidad

Una sola cosa: listar los campos ASK_USER (y los SIN_VARIABLE cuyo tratamiento conviene confirmar) en un markdown breve que el usuario responde rápido, idealmente desde el móvil. No configura, no decide por el usuario.

Cuándo NO pausa

Si Stage 3 no dejó ningún ASK_USER y los SIN_VARIABLE son obvios (firmas, sellos, notas internas), devuelve:

# Dudas para el usuario
Sin dudas abiertas — el panel resolvió todos los campos. Avanzando a la configuración.

…y el orquestador salta directo a Stage 5.

Formato del markdown (cuando sí hay dudas)

Corto, escaneable, una pregunta por bloque, opción por defecto sugerida cuando sea posible:

# Confirmaciones antes de configurar la plantilla — {client_name}

Necesito tu ok en {N} puntos. Responde con el número y tu elección.

1. **"TIPO DE GARANTÍA OTORGADA"** (sección Datos Generales)
   ¿Lo lleno con la capacidad estatutaria que extrae Trébol (`{legal_businessAssetPledging}`, sale "sí/no"), o es un dato que captura tu equipo a mano?
   - a) Variable de Trébol  ·  b) Campo manual (lo dejo en blanco)
   _Sugerencia: (a) si el campo solo refleja el objeto social._

2. **"OBSERVACIONES DEL ANALISTA"** (final del dictamen)
   No hay variable de Trébol para esto. ¿Lo dejo en blanco para llenado manual, o lo quito?
   - a) Dejar en blanco  ·  b) Quitar la sección

3. **Apoderados (PDF)**: tu plantilla es PDF, no soporta listas dinámicas. ¿Para cuántos apoderados dejo campos? (Trébol llenará los que existan)
   - a) 2  ·  b) 3  ·  c) 4

Reglas duras

No avances sin respuestas. Si el orquestador no tiene state.user_answers, el pipeline se queda aquí.
No auto-respondas. Aunque “sepas” la respuesta probable, el usuario decide los campos de negocio y los sin-variable.
Solo lo no resuelto. No re-preguntes campos ya decididos FINAL por el panel. El usuario no debe revisar todo el mapeo, solo lo dudoso.
Cerrado y corto. Preguntas con opciones, no ensayos. Máximo una decisión por punto.
Respuesta parcial: procesa lo respondido, vuelve a preguntar solo lo que falta. No avances con huecos.

Output

Cuando el usuario responde, estructura state.user_answers como {field_id: decisión} y devuélvelo al orquestador para Stage 5. Marca claramente cualquier punto que siga sin respuesta.

Checklist

Solo aparecen campos no resueltos por el panel.
Cada punto es una pregunta cerrada con opciones.
Hay sugerencia por defecto donde aplica.
El markdown es corto y escaneable.
No se auto-respondió nada; el pipeline pausa hasta recibir respuestas.

Intro al API de Trébol

Stage 4 user qa

Stage 4 — User Q&A (Punto de pausa humana)

Responsabilidad

Cuándo NO pausa

Formato del markdown (cuando sí hay dudas)

Reglas duras

Output

Checklist

​Stage 4 — User Q&A (Punto de pausa humana)

​Responsabilidad

​Cuándo NO pausa

​Formato del markdown (cuando sí hay dudas)

​Reglas duras

​Output

​Checklist

Stage 4 — User Q&A (Punto de pausa humana)

Responsabilidad

Cuándo NO pausa

Formato del markdown (cuando sí hay dudas)

Reglas duras

Output

Checklist