인수인계서 — 세션 14 (kdye2e 스킬 생성 + e2e 세팅 가이드)

작성일: 2026-02-17 이전 세션: session13

작업 요약

E2E 테스트를 프로젝트 레퍼런스/인수인계서 기반으로 체계적으로 수행하는 /kdye2e 스킬 생성. 범용 e2e 세팅 가이드도 함께 작성.

수정 파일 (6개)

상세 변경 사항

1. e2e-setup-guide.md — 범용 E2E 세팅 가이드

Playwright 기반 e2e 테스트를 다른 프로젝트에 도입할 때 사용하는 가이드. 프로젝트의 개발 체계(레퍼런스, 인수인계서)를 접목하여 시나리오를 체계적으로 도출하는 것이 핵심.

10개 섹션 구성:

1. 프로젝트 분석 (레퍼런스 7종 필수 확인)
2. 환경 설치 (Playwright + 선택적 Vitest/MSW)
3. 디렉토리 구조 (e2e/fixtures/pages 3계층)
4. 설정 파일 (playwright.config.ts + .gitignore)
5. Page Object 세팅 (02-reusable-code 자산 재활용)
6. 인증 셋업 (일반/관리자 분리)
7. 시나리오 도출 (5 카테고리, P0/P1/P2)
8. 테스트 작성 (스모크 → 인증 → CRUD)
9. 실행/CI (GitHub Actions 포함)
10. 레퍼런스 갱신

2. kdye2e 스킬 — 4 Phase 파이프라인

6가지 실행 모드:

• (없음) — 전체 흐름
• --scenario — 시나리오 도출만
• --run — 실행만
• --fix — 수정만
• --setup — Playwright 세팅
• --smoke — 스모크 테스트만

실패 원인 7유형 분류:

• T-선택자, T-타이밍, T-데이터, T-설정 (테스트 코드 수정)
• A-버그, A-미구현, A-API (소스 코드 수정)

3. 글로벌 스킬 등록

~/.claude/skills/kdye2e/SKILL.md에 위임 방식으로 등록. 스킬 발동 시 03-skills/kdye2e/SKILL.md 본체를 Read하여 실행.

검증 결과

• 글로벌 스킬 등록 확인: ~/.claude/skills/kdye2e/SKILL.md 존재
• 스킬 목록 반영 확인: system-reminder에 kdye2e 표시됨
• CLAUDE.md 정합성: 폴더 구조 + 스킬 테이블 일치

터치하지 않은 영역

• docs/references/_COMPONENT_MAP.md — kdye2e 연결 미반영 (inception 실행 시 자동 갱신)
• docs/references/_SYNERGY_ANALYSIS.md — kdye2e 시너지 미분석
• 04-agents/ — 변경 없음
• 02-reusable-code/13-testing-patterns/ — 참조만 (수정 없음)

알려진 이슈

없음

다음 작업 제안

1. /inception 실행 — kdye2e 스킬 추가에 따른 _COMPONENT_MAP.md 자동 갱신
2. 실 프로젝트에서 /kdye2e 실전 검증 — 전체 흐름(분석→시나리오→실행→수정) 동작 확인
3. 실 프로젝트에서 e2e-setup-guide.md 적용 검증

← handover 목록