초기 프로젝트 설정: 하네스 시스템 + 설계서 + RE 노하우

- CLAUDE.md: 프로젝트 규칙, 기술 스택, 코딩 규칙, 페이즈 로드맵
- .claude/settings.json: 권한, 강제 훅 (매 프롬프트 설계서 규칙 주입)
- .claude/skills/: implement-phase, review-phase, scaffold, test-commit, debug
- .claude/agents/: electron-architect, voice-pipeline-expert, ui-specialist
- docs/design/00-09: 마스터 아키텍처, 서비스 명세(16개), IPC(113채널),
  DB스키마, UI컴포넌트, 검증리포트, 외부엔진연동, 갭분석,
  VoiceMode패턴, 디자인시스템, 히스토리팝업
- docs/phases/1-7+3.5: 전체 구현 페이즈 문서
- docs/re-findings/: Speakly RE 노하우 5개 문서

.claude/skills/debug-electron/SKILL.md

@@ -0,0 +1,29 @@
+---
+name: debug-electron
+description: Electron 앱 디버깅. IPC 문제, 메모리 누수, 렌더러 크래시 등 진단.
+allowed-tools: Read Grep Glob Bash
+---
+
+# Electron Debug
+
+## 일반 디버깅
+1. 로그 확인 (`electron-log` 출력)
+2. IPC 채널 매칭 검증 (`shared/ipc-channels.ts` vs 실제 핸들러)
+3. 프리로드 스크립트 노출 API 확인
+
+## IPC 문제
+- `shared/ipc-channels.ts`에 채널 정의 확인
+- `src/main/ipc/`에 핸들러 등록 확인
+- `src/preload/index.ts`에 브릿지 노출 확인
+- 렌더러에서 `window.electronAPI.*` 호출 확인
+
+## 오디오 문제
+- Web Audio API 초기화 상태
+- 마이크 권한 확인
+- AudioContext sampleRate (24000Hz)
+- noiseSuppression: false 확인
+
+## 메모리 누수
+- useEffect cleanup 함수 확인
+- IPC 이벤트 리스너 제거 확인
+- BrowserWindow destroy 확인

.claude/skills/implement-phase/SKILL.md

@@ -0,0 +1,45 @@
+---
+name: implement-phase
+description: Speakly RE 노하우를 기반으로 D3RO-VOICE의 특정 페이즈를 구현. 페이즈 번호를 인자로 전달.
+argument-hint: "[phase number, e.g. 1]"
+allowed-tools: Read Write Edit Bash Glob Grep Agent
+---
+
+# Phase Implementation
+
+지정된 페이즈를 구현합니다.
+
+## 실행 순서
+
+1. **설계서 로드** (필수, 반드시 먼저):
+   - `docs/design/00-master-architecture.md` — 파일 트리, 초기화 순서, 서비스 의존관계
+   - `docs/design/01-service-specifications.md` — 서비스 인터페이스, 상태 머신, 이벤트
+   - `docs/design/02-ipc-and-types.md` — IPC 채널, TypeScript 타입, 에러 코드
+   - `docs/design/03-db-and-ui.md` — DB 스키마, 컴포넌트 명세, MUI 테마
+2. **페이즈 문서 로드**: `docs/phases/phase-$ARGUMENTS.md` 읽기
+3. **RE 참조 문서 확인**: `docs/re-findings/` 에서 관련 노하우 확인
+4. **현재 코드 상태 파악**: 기존 구현된 코드 검토
+4. **구현 계획 수립**: TaskCreate로 세부 태스크 생성
+5. **구현**: 태스크별로 순차 구현
+   - 타입 정의 (shared/) 먼저
+   - 메인 프로세스 서비스 구현
+   - IPC 핸들러 등록
+   - 렌더러 UI 구현
+   - 프리로드 브릿지 업데이트
+6. **테스트**: 각 모듈 단위 테스트
+7. **CLAUDE.md 업데이트**: 현재 상태 갱신
+
+## 구현 규칙 (위반 불가)
+- 서비스는 **설계서 01**의 인터페이스를 그대로 구현 (메서드 시그니처, 이벤트 페이로드 일치)
+- IPC 채널은 **설계서 02**의 `IPC_CHANNELS` 상수를 그대로 사용 (임의 채널명 금지)
+- 타입은 **설계서 02**의 `shared/types.ts` 정의를 그대로 사용 (임의 타입 금지)
+- 에러는 **설계서 02**의 `D3ROError` + `ErrorCode` enum 사용
+- DB는 **설계서 03**의 drizzle-orm 스키마 그대로 사용
+- UI는 **설계서 03**의 컴포넌트 Props/상태 명세 준수
+- 팝업은 **설계서 03**의 HTML/CSS/애니메이션 수학 공식 준수
+
+## 완료 조건
+- 모든 태스크 completed
+- `npm run typecheck` 통과
+- `npm run test` 통과
+- CLAUDE.md "현재 상태" 업데이트됨

.claude/skills/review-phase/SKILL.md

@@ -0,0 +1,27 @@
+---
+name: review-phase
+description: 완료된 페이즈를 검토하고 다음 페이즈 준비 상태를 판단. 페이즈 번호를 인자로 전달.
+argument-hint: "[phase number, e.g. 1]"
+allowed-tools: Read Glob Grep Bash Agent
+---
+
+# Phase Review
+
+완료된 페이즈를 검토합니다.
+
+## 검토 항목
+
+1. **요구사항 충족**: `docs/phases/phase-$ARGUMENTS.md` 대비 구현 완성도
+2. **Speakly 패턴 적용**: RE 노하우가 제대로 반영되었는지
+   - 상태 머신 설계가 Speakly 수준인가?
+   - 에러 처리가 포괄적인가?
+   - 윈도우 관리가 프리로딩 + 2-phase 리사이즈인가?
+3. **코드 품질**: TypeScript strict, 일관된 네이밍, 중복 없음
+4. **테스트 커버리지**: 핵심 서비스에 단위 테스트 존재
+5. **타입 안전성**: `npm run typecheck` 통과
+6. **빌드**: `npm run build` 통과
+
+## 출력
+- 발견된 이슈 목록 (심각도: critical/major/minor)
+- 다음 페이즈 진행 가능 여부 (GO/NO-GO)
+- CLAUDE.md 업데이트 제안

.claude/skills/scaffold-component/SKILL.md

@@ -0,0 +1,31 @@
+---
+name: scaffold-component
+description: D3RO-VOICE 프로젝트 컨벤션에 맞게 새 컴포넌트/서비스를 스캐폴딩. 이름을 인자로 전달.
+argument-hint: "[component or service name]"
+allowed-tools: Read Write Glob
+---
+
+# Scaffold
+
+프로젝트 컨벤션에 맞는 새 모듈을 생성합니다.
+
+## 서비스 스캐폴딩 (메인 프로세스)
+Speakly 패턴 적용:
+- 싱글톤 + EventEmitter
+- 로거 태그 `[ServiceName]`
+- 초기화/종료 메서드
+- IPC 채널 `shared/ipc-channels.ts`에 추가
+
+## React 컴포넌트 스캐폴딩 (렌더러)
+- 함수형 컴포넌트 + TypeScript Props 인터페이스
+- MUI sx prop 기반 스타일링
+- electronAPI IPC 호출 패턴
+
+## Vanilla JS 팝업 스캐폴딩
+Speakly 패턴:
+- 별도 HTML 엔트리포인트
+- 순수 DOM 조작 (React 미사용)
+- 2-phase 리사이즈: prepare(측정) → resize → show
+- mouseenter/leave 이벤트 메인 프로세스 전달
+
+모듈명: $ARGUMENTS

.claude/skills/test-and-commit/SKILL.md

@@ -0,0 +1,32 @@
+---
+name: test-and-commit
+description: 테스트 실행 후 통과하면 커밋. 코드 변경 완료 후 사용.
+allowed-tools: Bash Read
+---
+
+# Test & Commit
+
+1. **타입 체크**
+   ```bash
+   npm run typecheck
+   ```
+
+2. **린트**
+   ```bash
+   npm run lint
+   ```
+
+3. **테스트**
+   ```bash
+   npm run test
+   ```
+
+4. **모두 통과 시 커밋**
+   - git status로 변경 파일 확인
+   - git diff로 변경 내용 확인
+   - 적절한 커밋 메시지 작성 (한글, Conventional Commits)
+   - Co-Authored-By 절대 추가 금지
+
+5. **실패 시**
+   - 에러 내용 분석
+   - 수정 후 재시도