# Guía conversacional

Cómo guiar la conversación con el usuario en la Fase 1 de la skill.

## Apertura

> "Genial, vamos a arrancar una solución WxO nueva. Primero necesito
> entender el caso. ¿Para qué cliente o caso de uso es?"

## Preguntas en cascada

### 1. Cliente / Caso

- **Si menciona un cliente FIT existente:**
  > "¿Querés que traiga contexto de la ficha del cliente en Outline y
  > deals activos de HubSpot? Puedo invocar la skill `consulta-fichas`."

- **Si menciona un caso de uso técnico ("mesa N1", "QA testing", etc.):**
  > "Ok, ¿es similar a alguno que hayamos hecho? (Cotemar = mesa N1, Dun
  > = QA copilot). Si tenés transcripción, email, RFP o diagrama, mandalo."

- **Si es vago:**
  > "Para diseñar la arquitectura necesito saber: (a) qué le pide el usuario
  > al agente, (b) qué sistemas externos necesita tocar, (c) qué procedimiento
  > debe seguir. Si tenés un caso concreto, contámelo paso a paso."

### 2. Dominios

Después de oír el caso, decir lo que vos VES:

> "Por lo que me contás identifico estos dominios:
> 1. **[X]** — porque mencionaste [evidencia]
> 2. **[Y]** — porque [evidencia]
>
> ¿Falta alguno? ¿Alguno sobra?"

### 3. Sistemas externos

> "Qué sistemas tocaría cada dominio?
>   - ¿Son sistemas reales (AD, ServiceNow, SAP, Dynatrace) que ya existen?
>   - ¿O vamos a mockear todo para un PoC?
>   - ¿Hay backend propio que ya tenemos que extender?"

### 4. Stack web

> "Para la capa web hay dos happy-paths:
>   - **FastAPI + HTMX (SSR)** — perfecto para demos, control planes, paneles operativos
>   - **FastAPI + React + Vite** — para apps productivas con varios usuarios
>
> ¿Cuál te encaja?"

### 5. Confirmación

Antes de empezar a generar:

> "Resumiendo:
>   - Cliente: X
>   - Topología: 1 orchestrator + N specialists
>   - Agentes: [lista con nombres]
>   - Tools: [Python para mocks, OpenAPI para backend Y]
>   - Web: HTMX
>   - Runbooks: [lista]
>
> ¿Avanzo con esto? ¿Querés cambiar algo?"

## Cuándo NO seguir

Detenerse y pedir más contexto si:
- No queda claro qué le pide el usuario al agente
- No queda claro qué sistemas externos hay
- La topología propuesta tiene un agente con >10 tools (split)
- El orchestrator necesitaría tools de remediación (rediseñar)
- Hay >5 dominios y el usuario no quiere multi-capa (advertir consecuencias)