인수인계서 — 세션 6 (kdyweb 풀뿌리 검증 로직 구현)

작성일: 2026-02-16 이전 세션: session5

작업 요약

실 프로젝트 풀뿌리 검증 사례를 분석하고, kdyweb verify 모드에 2단계 프로세스 기반 풀뿌리 검증 체계를 구현. 이슈 유형 6→10, 단계 5→7로 확장.

수정 파일 (3개)

상세 변경 사항

1. verify.md — 풀뿌리 검증 전면 구현

핵심 개념: 2단계 프로세스

• 1단계 기계적 탐색: 존재/연결/import 여부를 사실만 수집 (판단 없음)
• 2단계 필요성 검증: 각 이슈 내용을 읽고 개별 판정 (삭제/연결/유지/갱신)

신규 스캔 (Step 2 확장)

신규 이슈 유형 (Step 3 확장)

Step 4 필요성 검증 (신규)

• 파일 내용 읽기 → 사용 컨텍스트 파악 → 대체품 확인 → 보안 이슈 확인
• 4가지 판정: 삭제(대체품 존재+사용처 0) / 연결(실 동작하나 진입점 없음) / 유지(역할 다름) / 갱신(문서 미최신)
• 각 판정마다 근거 기록 필수
• 중복 후보 자동 검색 (유사 이름/역할 파일 비교)

검증 범위 이원화

• 전체 검증: 이슈 1~6 (기존 호환)
• 풀뿌리 검증: 이슈 16 + 710

보고 형식 이원화

• 전체 검증: 기존 3단계 심각도 보고 유지
• 풀뿌리 검증: 1단계 요약 + 2단계 개별 판정 테이블 + 종합 요약

2. SKILL.md — 모드 분기 확장

• 핵심 원칙 5번: "풀뿌리 검증 — 2단계 프로세스로 사장된 코드 제로 보장"
• 모드 분기: 풀뿌리/grassroots 키워드 → verify (grassroots) 모드
• 강제 플래그: --verify grassroots 추가
• 연쇄 발동: verify에 "(풀뿌리: 2단계 필요성 검증 포함)" 주석
• 다이어그램: verify 하위에 "10가지 이슈유형 / 2단계 풀뿌리" 표기

3. 계약 템플릿 — 검증 결과 확장

• 검증 범위(전체/풀뿌리) 행 추가
• Important에 고아 컴포넌트/스토어/API 카운트 추가
• Minor에 문서 트리 카운트 추가
• 판정 결과(삭제/연결/갱신/유지) 행 추가 (풀뿌리 검증 시)

검증 결과

• code-reviewer 에이전트 교차 검증 — 3개 파일 간 이슈 유형 번호, 단계 수, 심각도 분류, 참조 경로 일관성 확인
• 기존 전체 검증(1~6) 하위 호환 유지 확인

터치하지 않은 영역

• phases/init.md, phases/page.md, phases/migrate.md, phases/evolve.md — 변경 없음
• references/ 하위 참조 파일들 — 변경 없음
• docs/references/ 표준 레퍼런스 5개 — 이미 최신 (세션 5에서 풀뿌리 관련 내용 반영됨)

알려진 이슈

• 없음

다음 작업 제안

1. 풀뿌리 검증 실전 테스트 — 실 프로젝트에서 /kdyweb 풀뿌리 검증 실행하여 10가지 이슈 유형 + 2단계 프로세스 동작 확인
2. 기존 스킬 frontmatter 표준화 — 공식 스펙 기반으로 9개 스킬 표준화
3. Hooks 실전 검증 — hooks-template.json 실 프로젝트 적용

← docs/status/current.md