Elicitação de Domínio OKF
Conduza uma entrevista de domínio que sobrevive entre sessões e emite um pacote OKF conforme avança. Três palavras-chave governam cada execução:
- saturação — uma linha de questionamento só termina quando se torna saturada: uma resposta concreta, delimitada, exemplificada e testada contra exceções, que não gera nenhum novo tópico.
- fila de ramificações — todo caso não explorado é enviado para uma fila em disco e trabalhado até que ela esvazie. Profundidade primeiro, largura rastreada; nada é descartado.
- tri-temporal — todo fato que envolve tempo registra quando aconteceu, quando a organização recebeu e quando foi inserido. Consulte TRI-TEMPORAL.md.
Esta habilidade fornece a estrutura e os artefatos; combine-a com uma postura de entrevista incansável (ex.: /grilling) para a persistência.
Espaço de trabalho da sessão — retome antes de perguntar qualquer coisa
Todo o estado reside em disco para que a entrevista sobreviva aos limites da janela de contexto e da sessão. Na invocação:
- Determine o slug do tópico (pergunte ao usuário qual é o assunto, se não estiver definido).
- Procure por
.interview/<slug>/. Se existir, LEIAstate.jsonequeue.jsonl, retome a partir do estado registrado e do tópico ativo, e anuncie onde está retomando. - Se não existir, crie-o:
.interview/<slug>/
state.json # {state, active_thread, topic, temporal_relevance}
queue.jsonl # uma ramificação por linha: {id, prompt, status, parent}
index.md # raiz do pacote OKF — veja BUNDLE-FORMAT.md
glossary.md # linguagem ubíqua — veja GLOSSARY-FORMAT.md
events.md # linha do tempo de eventos — veja EVENTS-FORMAT.md
rules.md # regras de negócio — veja RULES-FORMAT.md
context-map.md # contextos delimitados — veja CONTEXT-MAP-FORMAT.md
Persista após cada fato capturado e cada transição de estado. Nunca mantenha a fila ou os fatos capturados apenas no contexto — o disco é a fonte da verdade.
Máquina de estados
Percorra estes estados. O motor é o loop NARRAR → APROFUNDAR → RAMIFICAR, que retira a próxima ramificação da fila de volta para NARRAR até que a condição de término seja satisfeita. Prompts completos: QUESTION-BANKS.md.
- S0 Enquadrar — escopo, objetivo, atores nas fronteiras. Defina
temporal_relevance(dia calendário? segundo de relógio?) emstate.json. - S1 Narrar — elicie uma história concreta como uma linha do tempo de eventos; anexe eventos a
events.md. - S2 Aprofundar — por evento, extraia gatilho · ator · dados de entrada · regra · resultado · momento · identidade, além de seus estados tri-temporais (consulte TRI-TEMPORAL.md).
- S3 Ramificar — "o que mais poderia acontecer aqui?" Empurre cada exceção / alternativa / falha para
queue.jsonlcomopending. - S4 Definir — fixe termos (cada um com um não-exemplo), cardinalidades e limites; escreva em
glossary.mdecontext-map.md. - S5 Refletir — repita o modelo de volta com as palavras do interessado; capture correções.
Reflexo de sondagem
Aplique a CADA resposta, em todos os estados — este é o núcleo incansável:
quantificador vago ("geralmente", "alguns", "normalmente") → pergunte pelo limite
abstração sem exemplo → exija uma instância concreta
regra afirmada ("nós sempre X") → busque a exceção
novo termo → escreva no glossary.md COM um não-exemplo
novo ator ou evento → empurre para queue.jsonl
fato temporal → capture os três estados tri-temporais
senão (concreto, delimitado, exemplificado, testado contra exceção)
→ marque o tópico como saturado; retire a próxima ramificação pendente
Protocolo da fila de ramificações
- Uma ramificação é
{id, prompt, status: pending|active|saturated, parent}— um objeto JSON por linha, somente anexação. - Para trabalhar uma ramificação: defina-a como
activeemstate.json, execute S1→S3 nela, depois anexe uma linha marcando-a comosaturated. - Retire a próxima ramificação
pendingsomente quando o tópico ativo estiver saturado. - Ao retomar, a fila é a fonte da verdade para o que falta — leia-a, nunca reconstrua a partir da memória.
Critérios de conclusão
Pare apenas quando TODOS forem satisfeitos. Eles são verificáveis — não declare conclusão antes do tempo:
queue.jsonlnão tem nenhuma ramificaçãopending.- Cada termo em
glossary.mdtem tanto uma definição quanto um não-exemplo. - Cada evento em
events.mdcarrega todos os três estados tri-temporais, ou umn/a — {motivo}explícito. - A repetição S5 não produziu nenhuma correção material.
- Novas perguntas geram apenas reformulações de fatos conhecidos.
Emissão
Escreva o OKF conforme avança — nunca em lote no final. Cada artefato segue seu *-FORMAT.md; juntos formam um pacote OKF enraizado em index.md. Mantenha index.md atualizado à medida que os artefatos ganham conteúdo. O pacote é o entregável — passe-o adiante (ex.: para /to-prd ou /to-issues) assim que os critérios de conclusão forem satisfeitos.