인수인계서 — 세션 49 (kdyspike 스킬 생성 — 사전 연구 자동 강제)

작성일: 2026-03-08 이전 세션: session48

작업 요약

/kdyspike 스킬을 신규 생성. 기술적으로 어려운 기능 구현 전 사전 연구를 자동 강제하는 스킬로, 난이도 5단계 자동 판별 → 마이크로/풀 스파이크 2트랙 → 검증 게이트 → ADR 의사결정 기록까지 자동 수행.

수정 파일 (13개)

상세 변경 사항

1. kdyspike 스킬 — 핵심 설계

Phase 흐름:

• Step 0-0: 체크포인트 확인 (--resume)
• Phase 0: 컨텍스트 탐지 (스택 파악, 기존 spikes/ 확인)
• Phase 1: 난이도 판별 (12개 항목 점수 → Level 1~5) [게이트1: 사용자 확인]
• Phase 2A: 마이크로 스파이크 (L2~3, 웹검색 3회, 문서 1개)
• Phase 2B: 풀 스파이크 (L45, 웹검색 510회, experiments/)
• Phase 3: 검증 게이트 (산출물 완전성 자동 검사) [게이트2: Go/No-Go]
• Phase 4: 의사결정 기록 (ADR + _SPIKE_CLEARANCE.md)

난이도 5단계: Trivial(02) / Simple(35) / Moderate(69) / Complex(1014) / Research(15+)

산출물:

• 마이크로: docs/research/micro-spike-{YYYYMMDD}-{주제}.md
• 풀: spikes/spike-{NNN}-{주제}/ (README + findings + experiments)
• ADR: docs/research/decisions/ADR-{NNN}-{주제}.md
• 코딩 허가: docs/research/_SPIKE_CLEARANCE.md

2. 기존 체계와의 관계

• 06-tech-rd/ Stage 1 (Tech Spike)을 자동화 + 마이크로 트랙 추가
• Level 5에서 POC 안내만 (직접 수행은 06-tech-rd Stage 2)
• hooks (spike-guard)는 opt-in (반복 실패 프로젝트에만 선택적 활성화)

검증 결과

• 스킬 컨벤션 체크리스트 8/8 PASS
• SKILL.md ~200줄 (500줄 미만, Standard 구조 적합)
• Phase 0 포함, 게이트 2개 모두 AskUserQuestion 사용
• 관련 스킬/에이전트 테이블 존재 (4개 관계)

터치하지 않은 영역

• 글로벌 스킬 동기화 (~/.claude/skills/kdyspike/ 미등록)
• kdygenesis/kdynext SKILL.md에 kdyspike 역참조 미추가 (수동 연쇄이므로 구조적)

알려진 이슈

• kdyspike 글로벌 스킬 미동기화 — /kdysync로 등록 필요
• kdygenesis/kdynext에 kdyspike Recommend 역참조 미추가 (ONE_WAY, 구조적 유지)

다음 작업 제안

1. /kdysync 실행으로 kdyspike 글로벌 스킬 동기화
2. /kdyspike --assess "실시간 협업 에디터" 테스트 (난이도 판별 검증)
3. /kdyspike --micro "Zustand 상태관리" 테스트 (마이크로 스파이크 흐름)
4. 실 프로젝트에서 /kdyspike 실전 검증

← handover/_index.md