인수인계서 — 세션 34 (kdyweb audit 모드 추가)

작성일: 2026-02-19 이전 세션: session33

작업 요약

kdyweb 스킬에 7번째 모드 "audit(완성도 감사)"를 추가. 기존 verify 모드가 "연결성"만 검증하는 반면, audit 모드는 "내용 완성도"를 검사하여 미존재/미완성(스텁) 페이지를 탐지하고 자동 구현까지 수행.

#	파일	변경 내용
1	`03-skills/kdyweb/phases/audit.md`	신규 — 완성도 감사 모드 6단계 워크플로우 (511줄)
2	`03-skills/kdyweb/SKILL.md`	7개소 수정 (frontmatter, 트리, 분기, 연쇄, 예시)
3	`03-skills/kdyweb/contract/_WEB_CONTRACT_TEMPLATE.md`	`⚠️ 스텁` 상태값 추가
4	`03-skills/kdyweb/references/shared-variables.md`	"8. Audit 모드 변수" 섹션 추가
5	`CLAUDE.md`	스킬 테이블 kdyweb 설명 "6모드→7모드" 갱신

verify와의 역할 분리 원칙: verify=지도 검사(길이 연결되어 있는가), audit=건물 검사(건물이 실제로 지어져 있는가).

6단계 워크플로우:

계약 파싱 + 페이지 인벤토리 — 라우트 레지스트리 전수 파싱 + 미등록 페이지 추가 탐색
완성도 스캔 (핵심) — 5가지 스텁 탐지 휴리스틱 적용
- H1: 준비공 (실질 코드 < 15줄)
- H2: 플레이스홀더 (TODO, Coming soon 등 키워드)
- H3: 빈 반환 (return null, <></>)
- H4: 보일러플레이트만 (export + 제목만, 로직 0개)
- H5: 핵심 컴포넌트 부재 (유형별 필수 컴포넌트 0개)
완성도 보고서 — 구현됨/미완성(심각/보통/경미)/미존재 분류 + 우선순위 제안
자동 구현 — 미존재: 유형별 전체 파일 생성, 미완성: 기존 코드 보존 + 부족분 추가
계약 갱신 — 라우트 상태 업데이트 + 컴포넌트 매핑 + 버전 증가
연쇄 검증 — 미니 verify (파일 존재/진입점/라우터 등록/컴포넌트 해소) + kdypick 추천

상태값 목록에 ⚠️ 스텁 — 파일 존재하나 미완성 (audit 모드에서 감지) 추가.

"8. Audit 모드 변수" 섹션 추가:

code-reviewer 에이전트 리뷰 실행: Critical 1건, Important 3건, Minor 3건 발견 → 필수/권장 3건 즉시 수정
스킬 컨벤션 8항목 대체로 충족 (name kebab-case, 트리거 포함, Phase 0 존재, 관계 테이블 존재, AskUserQuestion 존재)
audit.md가 verify.md와 동일한 구조/상세 수준 유지 확인
shared-variables.md 변수명과 audit.md 참조 일치 확인

phases/init.md, page.md, verify.md, migrate.md, component.md, evolve.md — 기존 모드 파일 미수정
references/common-pages.md, connection-patterns.md, page-companions.md, seo-metadata.md, component-registry.md — 읽기 참조만
strategies/large-project.md — 미수정
글로벌 스킬 동기화 (~/.claude/skills/kdyweb/) — 미수행

글로벌 스킬 kdyweb 미동기화: ~/.claude/skills/kdyweb/ 에 audit.md 추가 및 SKILL.md 갱신 필요
audit.md가 511줄로 500줄 기준 초과 — 스킬 컨벤션에 따르면 references/ 분리 권장이나, 단일 phases/ 파일로서는 verify.md(713줄)보다 짧아 현재 수준 유지 가능