Communitygithub.com

NickMoignard/okf-domain-elicit

Habilidad para agente: entrevistas estructuradas y reanudables de elicitación de dominio que emiten un paquete OKF (glosario, eventos tri-temporales, reglas, mapa de contexto).

¿Qué es okf-domain-elicit?

Esta habilidad convierte a cualquier agente de IA (como Claude Code o Cursor) en un entrevistador sistemático de dominio. Proporciona una máquina de estados que guía la conversación desde el encuadre inicial hasta la reflexión final, asegurando que cada hecho capturado sea concreto, acotado, ejemplificado y probado con excepciones. El estado completo vive en disco (`.interview/<slug>/`), lo que permite reanudar la entrevista tras cualquier interrupción de sesión o límite de contexto. El agente mantiene una cola de ramas (`queue.jsonl`) que garantiza que no se descarte ningún caso sin explorar, y cada hecho con relevancia temporal registra los tres estados tri-temporales: cuándo ocurrió, cuándo lo recibió la organización y cuándo se ingresó. Al finalizar, se obtiene un paquete OKF (Ontology Knowledge Framework) completo: glosario con lenguaje ubicuo, línea de tiempo de eventos, reglas de negocio y mapa de contextos acotados, listo para ser usado en especificaciones técnicas o documentos de requisitos.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add NickMoignard/okf-domain-elicit

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

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:

  1. Determinar el slug del tema (preguntar al usuario el asunto si no está definido).
  2. Buscar .interview/<slug>/. Si existe, LEER state.json y queue.jsonl, reanudar desde el estado registrado y el hilo activo, y anunciar dónde se reanuda.
  3. 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?) en state.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.jsonl como pending.
  • S4 Definir — fijar términos (cada uno con un no-ejemplo), cardinalidades y límites; escribir en glossary.md y context-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 active en state.json, ejecutar S1→S3 en ella, luego añadir una línea marcándola como saturated.
  • Extraer la siguiente rama pending solo 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.jsonl no tiene ninguna rama pending.
  • Cada término en glossary.md tiene tanto una definición como un no-ejemplo.
  • Cada evento en events.md lleva los tres estados tri-temporales, o un explícito n/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.

Skills relacionados