위키독스 분석 보드 — 2026-06-25

AI에게 일을 시키기 전에 막연한 아이디어를 '목적·조건·처리·예외·데이터'로 구조화하는 방법론 — 게임 개발을 매개로 하지만 '생각을 구현 가능한 명세로 바꾸는 사고 훈련서'가 본질이다.

adopt 후보 3개(아이디어 구조화 프로토콜·예외조건 사전 명세·AI 프롬프트 변환 템플릿), improve 3개(MVP 우선순위·상태 전환표·Git 문서-코드 동시 버전 관리), skip 2개(데이터 테이블 분리·참고 대상 분석) — 핵심 가치는 '실행(Execution)은 압도적인데 기획(Upstream Thinking)이 ad-hoc인 형님 시스템에 사고 구조화 방법론을 주입하는 것'. 게임 도메인을 벗겨내면 'AI에게 일 시키기 전에 생각을 정리하는 기술'이라는 보편적 가치가 남는다. 책의 70%는 게임 특화 노이즈지만, 나머지 30%의 구조화 사고법은 Pre-Write Protocol의 상위 단계로 흡수할 가치가 충분하다.

1. ADOPT 막연한 아이디어 → 구현 가능 단위로의 구조화 프로토콜
   ~/.hermes/skills/writing-plans/SKILL.md (또는 새 SKILL.md `structured-spec-decomposition`)에 책의 5단계 분해 프로토콜을 추가: (1) 한 문장 콘셉트 정의 → (2) 타깃/범위 결정 → (3) 핵심 루프 도출 → (4) 기능·조건·예외·데이터 구조로 분해 → (5) MVP 필수/중요/선택 분류. Pre-Write Protocol의 Step 1 이전에 'Step 0: 아이디어 구조화'로 삽입.
2. ADOPT 예외 조건 사전 명세화 습관
   Pre-Write Protocol 3단계에 'Step 2.5: 예외조건 검증' 추가. 새 hook `pre_write_exception_check.py` 작성 — 기능 명세에 대해 (1) 리소스 부족 시 (2) 동시 실행 충돌 시 (3) 입력 무효 시 (4) 중복 실행 시 동작을 명시했는지 자동 검사. Known Pitfalls 13개 패턴을 예외조건 체크리스트로 역변환하여 hook이 자동 체크하도록.
3. IMPROVE MVP 기반 기능 우선순위 프레임워크
   ~/.hermes/skills/writing-plans/SKILL.md의 plan 작성 템플릿에 'MVP 분류' 섹션 추가: 각 task에 [필수/중요/선택] 태그를 달고, 필수 task만으로 구성된 MVP 마일스톤을 plan 상단에 명시. plan 검증 hook(pre_write_harness_check.py)에 'MVP 마일스톤 미정의 시 경고' 규칙 추가.
4. ADOPT 기획서 → AI 구현 요청 프롬프트 변환 템플릿
   ~/.hermes/skills/에 `prompt-template-spec` SKILL.md 신규 생성. 책의 4가지 템플릿 구조를 형님 도메인에 맞게 번역: (1) 기능 구현 요청 = '자동화 파이프라인 구현 요청' (2) 클래스 설계 요청 = 'SPoE 모듈 설계 요청' (3) UI 구현 요청 = 건너뛰기 (4) 테스트 코드 요청 = '단위 테스트+selftest 통합 요청'. Claude Code Skill에 프롬프트 템플릿 섹션으로 추가.
5. IMPROVE 상태 머신 기반 행동 설계
   pipeline_observer.py에 '상태 전환표' 개념 도입: 각 자동화 파이프라인의 상태(Idle/Running/Blocked/Error/Done)와 상태별 허용 액션(재시작 가능? 병렬 실행 가능? 알림 발송?)을 매트릭스로 정의. launchd 30개 중 충돌 가능한 조합을 상태 전환표로 문서화하여 Known Pitfalls #10·#11·#12 같은 stub 타이밍 문제를 사전 탐지.

LLM 대화창에만 남아 휘발되는 업무 맥락을 raw(원천)·wiki(정리지식)·rules(작업규칙) 3층으로 구조화해 반복 질문과 산출물 생성의 재료로 만드는 지식 관리 패턴이다.

adopt 후보 2개('확인 필요' 체계화·표준 wiki 템플릿), improve 4개(claim 근거 연결·log 분리·반복 맥락 진단·output 역추적), skip 2개(3층 규칙·주제 폴더 분리) — 핵심 가치는 '문서 단위의 불확실성 관리와 claim-to-source traceability'라는 형님 시스템의 구조적 약점을 정확히 찌른 점이다. 전체 시스템 설계는 형님이 압도적이지만, 개별 지식 문서의 품질 규율 측면에서 배울 점이 분명히 있다.

1. IMPROVE claim 단위 출처 연결 (근거 traceability)
   옵시디언 템플릿에 '## 근거' 섹션을 표준화하고, obsidian_keywords SPoE에 'claim에 근거 링크가 없으면 경고' 규칙 추가. Pre-Write Protocol 3단계 중 2단계(근거 매핑)에 'claim별 출처 파일·라인 연결' 체크리스트 항목 추가. blog-writer-naver 스킬에 근거 연결 검증 단계를 포함.
2. ADOPT 확인 필요(uncertainty flagging) 체계적 표시
   1) Obsidian 템플릿에 '## 확인된 내용' + '## 확인 필요' 섹션을 기본 포함. 2) Pre-Write Protocol 1단계(초안 작성) hook에 '확인 필요 항목이 분리되지 않은 초안은 통과 불가' 규칙 추가. 3) thesis-analysis 스킬에 '테제별 uncertainty rating' 필드 추가. 4) blog-writer-naver 파이프라인 Stage4에 '확인 필요 섹션 누락 검사' 추가.
3. ADOPT 표준 wiki 문서 템플릿 (요약·근거·확인·다음질문 구조)
   1) 옵시디언 vault의 concept note 템플릿을 5단 구조(요약·근거·확인된 내용·확인 필요·다음 질문)로 개편. 2) obsidian_keywords SPoE에 'concept note가 5단 구조를 갖추지 않으면 템플릿 자동 생성' 규칙 추가. 3) agent_registry.py에 'wiki_template_compliant' 필드 추가해 호환 에이전트 식별. 4) 기존 855개 concept note는 점진적 마이그레이션 대상으로 등록.
4. IMPROVE log.md — 처리 이력과 지식의 분리
   HANDOFF.md에 '처리 이력' 섹션을 신설하고, 작업 로그를 지식 블록과 분리하여 기록. session_checkpoint.py 출력을 이 섹션에 자동 append하도록 수정. monthly_summary 로직에 '처리 이력은 압축하지 않고 별도 archive/log-YYYY-MM.md로 보존' 규칙 추가.
5. IMPROVE 반복 맥락 식별 방법론 (실습 기반 진단표)
   skill-creator 스킬에 '반복 맥락 진단 단계'를 추가 — 새 skill 생성 전 6개 카테고리 진단표를 먼저 채우도록 PreToolUse hook 추가. self-improvement-scout에 '주간 반복 맥락 발굴' 항목 포함. agent_registry.py에 'repeat_context_candidates' 필드 추가해 미발견 반복 작업 후보를 추적.