Communitygithub.com

NickMoignard/okf-domain-elicit

Agent 스킬: 구조화된 재개 가능 도메인 도출 인터뷰를 수행하여 OKF 지식 번들(용어집, 삼중 시간 이벤트, 규칙, 컨텍스트 맵)을 생성합니다.

okf-domain-elicit란 무엇인가요?

이 스킬은 AI 에이전트가 다중 세션에 걸쳐 지속 가능한 구조화된 도메인 도출 인터뷰를 수행할 수 있게 합니다. 핵심은 세 가지 원칙인 **포화**, **분기 큐**, **삼중 시간**에 기반하여, 모든 질문은 구체적이고 경계가 명확하며 예시와 예외 검증을 통해 포화될 때까지 진행됩니다. 탐색되지 않은 모든 사례는 디스크 기반 큐에 저장되어 깊이 우선으로 처리되며, 시간 관련 사실은 발생 시점, 조직 수신 시점, 입력 시점을 모두 기록합니다. 인터뷰 상태는 파일 시스템에 지속적으로 저장되어 컨텍스트 윈도우나 세션 종료 후에도 재개가 가능합니다. Cursor, Claude Code 등 파일 시스템 접근이 가능한 모든 AI 에이전트 플랫폼에서 사용할 수 있으며, 인터뷰 결과물은 OKF(Organized Knowledge Framework) 번들로 실시간 생성됩니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add NickMoignard/okf-domain-elicit

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

OKF 도메인 도출

세션을 넘어 지속되고 실행되는 동안 OKF 번들을 생성하는 도메인 인터뷰를 수행합니다. 세 가지 핵심 단어가 모든 실행을 제어합니다:

  • 포화 — 질문 라인은 포화 상태가 될 때까지 완료되지 않습니다: 답변이 구체적이고, 경계가 명확하며, 예시가 있고, 예외가 검증되어 새로운 스레드를 생성하지 않는 상태입니다.
  • 분기 큐 — 탐색되지 않은 모든 사례는 디스크 기반 큐에 푸시되고 큐가 빌 때까지 작업됩니다. 깊이 우선, 너비 추적; 어떤 것도 누락되지 않습니다.
  • 삼중 시간 — 시간 관련 모든 사실은 발생 시점, 조직 수신 시점, 입력 시점을 기록합니다. TRI-TEMPORAL.md를 참조하세요.

이 스킬은 구조와 아티팩트를 제공합니다; 지속성을 위해 집요한 인터뷰 태도(예: /grilling)와 함께 사용하세요.

세션 작업 공간 — 질문 전에 반드시 재개

모든 상태는 디스크에 저장되어 인터뷰가 컨텍스트 윈도우 및 세션 경계를 넘어 지속됩니다. 호출 시:

  1. 주제 슬러그를 결정합니다(설정되지 않은 경우 사용자에게 주제를 물어보세요).
  2. .interview/<slug>/ 디렉토리를 찾습니다. 존재하면 state.json과 queue.jsonl을 읽고, 기록된 상태와 활성 스레드에서 재개하며, 재개 위치를 알립니다.
  3. 존재하지 않으면 생성합니다:
.interview/<slug>/
  state.json      # {state, active_thread, topic, temporal_relevance}
  queue.jsonl     # 한 줄에 하나의 분기: {id, prompt, status, parent}
  index.md        # OKF 번들 루트        — BUNDLE-FORMAT.md 참조
  glossary.md     # 유비쿼터스 언어      — GLOSSARY-FORMAT.md 참조
  events.md       # 도메인 이벤트 타임라인 — EVENTS-FORMAT.md 참조
  rules.md        # 비즈니스 규칙          — RULES-FORMAT.md 참조
  context-map.md  # 경계 컨텍스트         — CONTEXT-MAP-FORMAT.md 참조

모든 획득된 사실과 모든 상태 전환 후에 지속하세요. 큐나 획득된 사실을 컨텍스트에만 보유하지 마십시오 — 디스크가 진실의 원천입니다.

상태 머신

다음 상태를 따라 이동합니다. 엔진은 NARRATE → DRILL → BRANCH 루프로, 종료 조건이 충족될 때까지 분기 큐를 다시 NARRATE로 팝합니다. 전체 프롬프트: QUESTION-BANKS.md.

  • S0 프레임 — 범위, 목표, 경계의 행위자를 설정합니다. state.json에 temporal_relevance(달력 일? 시계 초?)를 설정합니다.
  • S1 서술 — 하나의 구체적인 이야기를 이벤트 타임라인으로 도출하고, events.md에 이벤트를 추가합니다.
  • S2 드릴 — 각 이벤트에 대해 트리거 · 행위자 · 입력 데이터 · 규칙 · 결과 · 타이밍 · 식별자와 삼중 시간 상태를 추출합니다(TRI-TEMPORAL.md 참조).
  • S3 분기 — "여기서 또 무엇이 일어날 수 있나?" 각 예외/대안/실패를 pending 상태로 queue.jsonl에 푸시합니다.
  • S4 정의 — 용어를 정의합니다(각각 비예시 포함), 카디널리티와 경계를 설정하고, glossary.md와 context-map.md에 작성합니다.
  • S5 반영 — 이해관계자의 언어로 모델을 다시 말하고 수정 사항을 캡처합니다.

탐침 반사

모든 상태의 모든 답변에 적용하세요 — 이것이 집요한 핵심입니다:

모호한 수량사 ("보통", "몇몇", "일반적으로") → 경계를 요청
예시 없는 추상화                               → 구체적인 인스턴스 요구
주장된 규칙 ("우리는 항상 X")                  → 예외 찾기
새로운 용어                                     → 비예시와 함께 glossary.md에 작성
새로운 행위자 또는 이벤트                       → queue.jsonl에 푸시
시간 관련 사실                                  → 세 가지 삼중 시간 상태 모두 캡처
그 외 (구체적, 경계 명확, 예시 있음, 예외 검증됨)
                                                  → 스레드 포화 표시; 다음 대기 분기 팝

분기 큐 프로토콜

  • 분기는 {id, prompt, status: pending|active|saturated, parent} — 한 줄에 하나의 JSON 객체, 추가 전용입니다.
  • 분기 작업: state.json에서 active로 설정하고, S1→S3을 실행한 후, saturated로 표시하는 줄을 추가합니다.
  • 활성 스레드가 포화된 경우에만 다음 pending 분기를 팝합니다.
  • 재개 시, 큐는 남은 작업의 진실 원천입니다 — 읽기만 하고 메모리에서 재구성하지 마세요.

완료 기준

모든 조건이 충족될 때만 중단하세요. 확인 가능합니다 — 조기 완료를 선언하지 마세요:

  • queue.jsonl에 pending 분기가 없습니다.
  • glossary.md의 모든 용어에 정의와 비예시가 모두 있습니다.
  • events.md의 모든 이벤트에 세 가지 삼중 시간 상태 또는 명시적 n/a — {이유}가 있습니다.
  • S5 반영에서 실질적인 수정이 발생하지 않았습니다.
  • 새로운 질문은 알려진 사실의 재진술만 생성합니다.

생성

진행하면서 OKF를 작성하세요 — 마지막에 일괄 처리하지 마십시오. 각 아티팩트는 해당 *-FORMAT.md를 따릅니다; 함께 index.md에 루트된 OKF 번들을 형성합니다. 아티팩트에 내용이 추가됨에 따라 index.md를 최신 상태로 유지하세요. 번들이 전달물입니다 — 완료 기준이 충족되면(예: /to-prd 또는 /to-issues로) 전달하세요.

관련 스킬