Elicitación de Dominio OKF
Realiza una entrevista de dominio que sobrevive entre sesiones y emite un paquete OKF mientras se ejecuta. Tres palabras clave gobiernan cada ejecución:
- saturación — una línea de preguntas termina solo cuando se satura: una respuesta concreta, acotada, ejemplificada y probada con excepciones, que no genera ningún nuevo hilo.
- cola de ramas — cada caso no explorado se inserta en una cola en disco y se trabaja hasta vaciarla. Profundidad primero, amplitud monitorizada; nada se descarta.
- tri-temporal — todo hecho con relevancia temporal registra cuándo ocurrió, cuándo lo recibió la organización y cuándo se ingresó. Ver TRI-TEMPORAL.md.
Esta habilidad proporciona la estructura y los artefactos; combínala con una postura de entrevista implacable (ej. /grilling) para la persistencia.
Espacio de trabajo de sesión — reanudar antes de preguntar nada
Todo el estado reside en disco para que la entrevista sobreviva a los límites de ventana de contexto y de sesión. Al invocar:
- Determinar el slug del tema (preguntar al usuario el asunto si no está definido).
- Buscar
.interview/<slug>/. Si existe, LEERstate.jsonyqueue.jsonl, reanudar desde el estado registrado y el hilo activo, y anunciar dónde se reanuda. - Si no existe, crearlo:
.interview/<slug>/
state.json # {state, active_thread, topic, temporal_relevance}
queue.jsonl # una rama por línea: {id, prompt, status, parent}
index.md # raíz del paquete OKF — ver BUNDLE-FORMAT.md
glossary.md # lenguaje ubicuo — ver GLOSSARY-FORMAT.md
events.md # línea de tiempo del dominio — ver EVENTS-FORMAT.md
rules.md # reglas de negocio — ver RULES-FORMAT.md
context-map.md # contextos acotados — ver CONTEXT-MAP-FORMAT.md
Persistir después de cada hecho capturado y cada transición de estado. Nunca mantener la cola o los hechos capturados solo en contexto — el disco es la fuente de verdad.
Máquina de estados
Recorrer estos estados. El motor es el bucle NARRAR → PERFORAR → RAMIFICAR, sacando la cola de ramas de vuelta a NARRAR hasta que se cumplan las condiciones de finalización. Prompts completos: QUESTION-BANKS.md.
- S0 Encuadre — alcance, objetivo, actores en los límites. Establecer
temporal_relevance(¿día calendario? ¿segundo de reloj?) enstate.json. - S1 Narrar — obtener una historia concreta como una línea de tiempo de eventos; añadir eventos a
events.md. - S2 Perforar — por evento extraer: desencadenante · actor · datos de entrada · regla · resultado · momento · identidad, además de sus estados tri-temporales (ver TRI-TEMPORAL.md).
- S3 Ramificar — "¿qué más podría pasar aquí?" Insertar cada excepción / alternativa / fallo en
queue.jsonlcomopending. - S4 Definir — fijar términos (cada uno con un no-ejemplo), cardinalidades y límites; escribir en
glossary.mdycontext-map.md. - S5 Reflexionar — reproducir el modelo en palabras del interesado; capturar correcciones.
Reflejo de sondeo
Aplicar a CADA respuesta, en cualquier estado — este es el núcleo implacable:
cuantificador vago ("normalmente","unos pocos","habitualmente") → pedir el límite
abstracción sin ejemplo → exigir una instancia concreta
regla afirmada ("siempre hacemos X") → buscar la excepción
nuevo término → escribir en glossary.md CON un no-ejemplo
nuevo actor o evento → insertar en queue.jsonl
hecho con relevancia temporal → capturar los tres estados tri-temporales
si no (concreto, acotado, ejemplificado, probado con excepciones)
→ marcar hilo como saturado; extraer siguiente rama pendiente
Protocolo de cola de ramas
- Una rama es
{id, prompt, status: pending|active|saturated, parent}— un objeto JSON por línea, solo añadir al final. - Para trabajar una rama: establecerla como
activeenstate.json, ejecutar S1→S3 en ella, luego añadir una línea marcándola comosaturated. - Extraer la siguiente rama
pendingsolo cuando el hilo activo esté saturado. - Al reanudar, la cola es la fuente de verdad de lo que queda — leerla, nunca reconstruirla desde la memoria.
Criterios de finalización
Detenerse solo cuando TODOS se cumplan. Estos son verificables — no declarar terminado antes de tiempo:
queue.jsonlno tiene ninguna ramapending.- Cada término en
glossary.mdtiene tanto una definición como un no-ejemplo. - Cada evento en
events.mdlleva los tres estados tri-temporales, o un explíciton/a — {razón}. - La reproducción de S5 no produjo ninguna corrección material.
- Las nuevas preguntas solo generan repeticiones de hechos conocidos.
Emitir
Escribir OKF sobre la marcha — nunca procesar por lotes al final. Cada artefacto sigue su *-FORMAT.md; juntos forman un paquete OKF cuya raíz es index.md. Mantener index.md actualizado a medida que los artefactos ganan contenido. El paquete es el entregable — transferirlo (ej. a /to-prd o /to-issues) una vez que se cumplan los criterios de finalización.