wrap-up

dding-dong 세션 마무리

소스코드를 진실의 원천(source of truth)으로 삼아 README.md와 CLAUDE.md를 자동 동기화합니다.

사용 시점

• 소스코드를 변경한 후 문서를 동기화할 때
• 코딩 세션을 마무리할 때
• 새 커맨드/이벤트/설정을 추가한 후

사용하지 말 것

• 소스코드 변경 없이 문서만 직접 편집할 때
• 새 기능 설계/구현 도중 (구현 완료 후 실행)

인수 처리

$ARGUMENTS를 파싱하여 동작을 결정합니다:

인수	동작
(없음)	README.md + CLAUDE.md 모두 동기화
--readme-only	README.md만 동기화
--claude-only	CLAUDE.md만 동기화

---

워크플로우

3단계 Task 기반 서브에이전트 워크플로우를 실행합니다. 진행 상황을 한국어로 안내합니다.

Stage 1: 소스코드 분석 (Explorer)

"소스코드를 분석하고 있습니다..." 를 출력하고 Task를 스폰합니다.

아래 프롬프트로 하나의 Task(explorer)를 실행합니다:

Task(prompt=<아래 프롬프트>, description="dding-dong 소스코드 분석")

Explorer 프롬프트:

dding-dong 프로젝트의 소스코드를 분석하여 문서 동기화에 필요한 데이터를 추출합니다.
프로젝트 루트: (현재 작업 디렉토리)

아래 소스 파일들을 Read로 읽고, 각 항목별로 구조화된 분석 결과를 반환하세요.

## 분석 대상

| 소스 파일 | 추출 대상 |
|-----------|-----------|
| scripts/core/config.mjs | DEFAULT_CONFIG 객체 전체, 환경변수 오버라이드 목록(DDING_DONG_*), 설정 경로 상수(CONFIG_DIR, CONFIG_FILE, STATE_FILE), 스코프 병합 순서 |
| scripts/core/platform.mjs | detectPlatform() 반환값 목록, detectAudioPlayer() 플랫폼별 우선순위, detectNotifier() 플랫폼별 우선순위 |
| scripts/core/player.mjs | resolveSound() 팩 탐색 경로 순서(사용자 팩 -> 내장 팩), 플랫폼별 재생 명령어와 인수, rotation 모드별 동작(random vs sequential), _linuxArgs() 플레이어별 인수 |
| scripts/core/notifier.mjs | 플랫폼별 알림 전송 분기(macOS/Linux/WSL), WSL 폴백 체인(wsl-notify-send -> WinRT PowerShell -> terminal bell) |
| scripts/core/messages.mjs | 지원 언어 목록, 이벤트별 메시지 키-값 |
| hooks/hooks.json | 등록된 훅 이벤트 타입과 timeout 값, 각 훅의 command 경로 |
| hooks/*.mjs | 훅 파일 목록, 각 훅이 매핑하는 이벤트 타입, _common.mjs의 runHook() 동작 흐름 |
| sounds/default/manifest.json | manifest 스키마(필수/선택 필드), 이벤트별 파일 매핑, rotation 모드 |
| commands/*.md | 모든 커맨드 이름과 description (frontmatter에서 추출) |

## 출력 형식

아래 섹션별로 정리하여 반환하세요. 각 섹션은 마크다운 헤딩으로 구분합니다.

### 1. 설정 (Config)
- DEFAULT_CONFIG 객체 (JSON 그대로)
- 환경변수 오버라이드 테이블 (변수명 | 설명)
- 설정 파일 경로 테이블 (파일 | 경로)
- 스코프 병합 순서: Default <- Global <- Project <- Project Local <- ENV

### 2. 크로스 플랫폼
- 플랫폼별 사운드 재생 테이블 (플랫폼 | 도구 | 비고)
- 플랫폼별 알림 전송 테이블 (플랫폼 | 도구 | 폴백)
- Linux 오디오 플레이어 우선순위 체인

### 3. 사운드 팩
- manifest.json 필드 테이블 (필드 | 필수 | 설명)
- 팩 탐색 순서 (사용자 팩 경로 -> 내장 팩 경로)
- rotation 모드 테이블 (모드 | 동작)

### 4. 이벤트 & 훅
- 이벤트 타입 목록
- 훅 파일 -> 이벤트 매핑 테이블
- hooks.json 구조 요약

### 5. 메시지
- 지원 언어
- 이벤트별 메시지 테이블 (이벤트 | 한국어 | 영어)

### 6. 커맨드
- 커맨드 목록 테이블 (커맨드 | description)

### 7. Data Flow
- notify.mjs의 전체 흐름: Hook event -> hooks/*.mjs -> _common.mjs runHook() -> notify() -> loadConfig() -> isQuietHours() -> isCoolingDown() -> playSound() + sendNotification() -> saveState()
- _common.mjs의 stdin 파싱 -> notify() 호출 -> optional stdout 응답 흐름

### 8. 디렉토리 구조
- Glob으로 프로젝트 전체 파일 트리를 확인하고, 주요 디렉토리/파일 목록을 트리 형태로 출력
- .claude-plugin/, commands/, hooks/, scripts/, sounds/ 각 디렉토리의 역할 한 줄 설명

### 9. Critical Design Rules
- hooks/*.mjs에서 발견되는 패턴: stop hook MUST respond, exit(0) on error, detached+unref
- ESM only (.mjs), No npm dependencies, env var overrides, sound pack resolution order