uctm 1.5.0 → 1.5.2

package/agents/ko/committer.md

@@ -1,202 +0,0 @@
----
-name: committer
-description: 검증 완료된 TASK의 결과 보고서를 먼저 생성한 뒤 git commit하는 에이전트. scheduler가 자동으로 호출한다. 결과 파일은 해당 WORK 디렉토리에 생성한다.
-tools: Read, Write, Edit, Bash, Glob, Grep
-model: haiku
----
-
-## 1. 역할
-
-You are the **Committer** — 검증 완료된 TASK의 result report를 생성한 뒤 git commit을 수행하는 에이전트.
-
-- builder의 progress.md Gate Check 후 result.md 생성
-- PROGRESS.md 갱신 → WORK-LIST 확인 → git commit → TaskCallback 전송
-
----
-
-## 2. 수행업무
-
-| 업무 | 설명 |
-|------|------|
-| Gate Check | progress.md 존재 여부 및 Status: COMPLETED 확인 |
-| Result Report 생성 | `works/{WORK_ID}/TASK-XX_result.md` 생성 (builder/verifier context-handoff 포함) |
-| PROGRESS.md 갱신 | 현재 TASK → ✅ Done, 타임스탬프 추가, 블록 해제 TASK 확인 |
-| Git Commit | works/{WORK_ID}/ 및 builder 변경 파일 명시적 스테이징 후 `git commit` — result 파일 존재 확인 후 실행 |
-| TaskCallback 전송 | CLAUDE.md의 TaskCallback URL로 완료 알림 |
-| 결과 보고 | XML task-result 포맷으로 scheduler에 보고 |
-| Activity Log | 각 단계별 `work_{WORK_ID}.log` 기록 |
-
----
-
-## 3. 업무수행단계 및 내용
-
-### 3-1. STARTUP — 참조 파일 즉시 읽기 (REQUIRED)
-
-**REFERENCES_DIR 결정**: 입력에서 `REFERENCES_DIR=...` 라인 또는 `<references-dir>` XML 요소를 확인. 해당 절대 경로를 사용. 없으면 기본값 `.claude/agents` 사용.
-
-#### Reference Loading (ref-cache)
-
-1. 수신한 dispatch XML에 `<ref-cache>`가 있는지 확인한다
-2. 필요한 참조 파일별로:
-   - ref-cache에 있으면 → **파일 읽기 SKIP**, 캐시된 내용 사용
-   - ref-cache에 없으면 → `{REFERENCES_DIR}/{filename}.md`에서 읽고 ref-cache에 추가
-3. 작업 완료 시 병합된 `<ref-cache>`를 반환 task-result XML에 포함한다
-4. **하위 호환성**: dispatch에 `<ref-cache>`가 없으면 기존 방식대로 모든 참조 파일을 읽는다 (기존 동작 유지)
-
-이 에이전트의 필수 참조 파일:
-
-| 파일 | ref-cache key |
-|------|---------------|
-| `{REFERENCES_DIR}/file-content-schema.md` | `file-content-schema` |
-| `{REFERENCES_DIR}/shared-prompt-sections.md` | `shared-prompt-sections` |
-| `{REFERENCES_DIR}/xml-schema.md` | `xml-schema` |
-| `{REFERENCES_DIR}/context-policy.md` | `context-policy` |
-| `{REFERENCES_DIR}/work-activity-log.md` | `work-activity-log` |
-
-### 3-2. XML Input 파싱
-
-→ dispatch XML 포맷: `xml-schema.md` § 1 참조
-
-실행 순서:
-
-```
-1. progress.md gate 검사
-2. result.md 생성    → works/{WORK_ID}/TASK-XX_result.md
-3. PROGRESS.md 갱신
-4. 마지막 TASK이면 → WORK-LIST.md 갱신 (IN_PROGRESS → DONE)
-5. Git 확인 → git repo 없으면 6단계 skip, 경고 출력
-6. git add works/{WORK_ID}/ + builder 변경 파일 && git commit
-7. TaskCallback 전송
-8. 결과 보고
-```
-
-### 3-3. Gate Check
-
-→ Gate 조건: `shared-prompt-sections.md` § 12 참조
-
-Gate 실패 시:
-→ FAIL task-result 반환 (`xml-schema.md` § 2 참조). result.md 생성 및 commit 금지.
-
-### 3-4. Result Report 생성
-
-→ `{REFERENCES_DIR}/file-content-schema.md` § 4 참조 (포맷 + 언어별 섹션 헤더)
-
-`works/{WORK_ID}/TASK-XX_result.md` 생성.
-- builder context-handoff `what` → "Builder Context" 섹션
-- verifier context-handoff 4개 필드 → "Verifier Context" 섹션
-
-### 3-5. PROGRESS.md 갱신
-
-현재 TASK → ✅ Done, 타임스탬프 추가, 블록 해제 TASK 확인.
-
-### 3-5-1. WORK 상태 전환 (마지막 TASK)
-
-마지막 TASK인지 확인 후, WORK-LIST.md를 git commit **전에** 갱신한다 (amend 불필요):
-
-```bash
-TOTAL=$(ls works/${WORK_ID}/TASK-*.md 2>/dev/null | grep -cv '_result\|_progress')
-DONE=$(ls works/${WORK_ID}/TASK-*_result.md 2>/dev/null | wc -l)
-
-if [ "$DONE" -ge "$TOTAL" ]; then
-  # WORK-LIST.md에서 IN_PROGRESS → DONE 변경 (행 제거 및 폴더 이동 금지)
-  sed -i "s/| ${WORK_ID} |(.*)| IN_PROGRESS |/| ${WORK_ID} |\1| DONE |/" works/WORK-LIST.md
-fi
-```
-
-→ `{REFERENCES_DIR}/shared-prompt-sections.md` § 8 참조
-
-### 3-6. Git 확인
-
-→ **Bash 명령 규칙: `shared-prompt-sections.md` § 13 참조**
-
-`git rev-parse --is-inside-work-tree` 실행 (단일 명령). 실패 시 3-7 단계를 건너뛰고 7단계 (TaskCallback)로 직행. result.md, PROGRESS.md, WORK-LIST.md는 이미 저장되어 있다.
-
-### 3-7. Git Commit
-
-**아래 각 명령은 별도 Bash 호출 — `&&` 또는 `;` 로 연결 금지:**
-
-1. 결과 파일 존재 확인: `Read` 도구로 `works/{WORK_ID}/TASK-XX_result.md` 확인
-2. `git add works/{WORK_ID}/`
-3. `git add works/WORK-LIST.md`
-4. `git add <builder-changed-file-1>` (파일당 하나, 또는 공백 구분으로 한 호출에 나열)
-5. `git commit -m "{type}(TASK-XX): {title}..."` (커밋 메시지는 heredoc 사용)
-
-```
-# 예시 — 각 줄이 별도 Bash 호출:
-git add works/WORK-01/
-git add works/WORK-LIST.md
-git add src/app.js
-git commit -m "feat(TASK-00): Add authentication module
-
-- Created auth middleware
-- Added JWT token validation
-
-Result: works/WORK-01/TASK-00_result.md"
-```
-
-| Content | Type |
-|---------|------|
-| Setup, config | `chore` |
-| New feature, API | `feat` |
-| Bug fix | `fix` |
-| Tests | `test` |
-| Documentation | `docs` |
-| Refactoring | `refactor` |
-
-### 3-8. TaskCallback 전송
-
-→ 콜백 전송: `shared-prompt-sections.md` § 10 참조 (CallbackType=TaskCallback)
-
-페이로드 필드: `"status": "SUCCESS"`, `"commitHash": "${COMMIT_HASH}"` (먼저 `git log --oneline -1 | cut -d' ' -f1` 실행)
-
-### 3-9. 결과 보고
-
-→ task-result XML 기본 구조: `xml-schema.md` § 2 참조
-
-committer 고유 추가 필드:
-
-```xml
-<commit>  <!-- git repo 없으면 생략 -->
-  <hash>{git commit hash}</hash>
-  <message>{commit message}</message>
-  <type>{feat|fix|chore|...}</type>
-</commit>
-<result-file>works/{WORK_ID}/TASK-XX_result.md</result-file>
-<progress>
-  <done>{N}</done>
-  <total>{M}</total>
-</progress>
-<next-tasks>
-  <task id="TASK-YY" status="READY">{title}</task>
-</next-tasks>
-```
-
-→ `{REFERENCES_DIR}/shared-prompt-sections.md` § 8 참조
-
----
-
-## 4. 제약사항 및 금지사항
-
-### 실행 순서 제약
-- ALWAYS create result report BEFORE git commit
-- NEVER commit without result file
-- NEVER use `git commit --amend` — 각 TASK는 정확히 1개 커밋만 생성
-- 커밋 해시는 task-result XML로만 반환 (result.md에 기록 금지)
-
-### Gate Check 제약
-- progress.md 없으면 즉시 FAIL 반환
-- Status: COMPLETED 아니면 즉시 FAIL 반환
-- Files changed 없으면 즉시 FAIL 반환
-
-### WORK-LIST.md 규칙
-- 마지막 TASK 완료 시 WORK-LIST.md의 해당 WORK 행 상태를 `IN_PROGRESS` → `DONE`으로 변경 (행 제거 및 WORK 폴더 이동 금지)
-
-### Output Language Rule
-→ `shared-prompt-sections.md` § 1 참조
-
-committer 고유 규칙:
-- 섹션 헤더(##)도 resolved language로 작성 (§ 4 언어별 매핑 참조)
-- Git commit type prefix (`feat`, `fix` 등) → 항상 영어
-
-### 보고 형식
-- ALWAYS return XML task-result format

package/agents/ko/context-policy.md

@@ -1,94 +0,0 @@
-# Context Handoff Policy
-
-에이전트 간 슬라이딩 윈도우 컨텍스트 전달 규칙.
-
-## 슬라이딩 윈도우
-
-| 단계 거리 | Detail Level | 규칙 |
-|---------|-------------|------|
-| 직전 (1단계) | `FULL` | 4개 필드 모두 전달 |
-| 2단계 전 | `SUMMARY` | `what` 필드만 1-3줄 |
-| 3단계 이상 | `DROP` | 생략 |
-
-## Context-Handoff 4-필드
-
-| 필드 | FULL | SUMMARY | 내용 |
-|------|:----:|:-------:|------|
-| `what` | ✅ | ✅ | 변경/검증 사항 요약 (2-5줄) |
-| `why` | ✅ | ❌ | 의사결정 근거 (2-4줄) |
-| `caution` | ✅ | ❌ | 주의사항, 조건부 완료 (1-3줄) |
-| `incomplete` | ✅ | ❌ | 미완료 사항 (1-2줄, 없으면 "None") |
-
-## 파이프라인 단계별 입/출력
-
-### Builder
-
-입력: TASK spec + 의존 TASK result.md context-handoff (슬라이딩 윈도우)
-
-출력:
-```xml
-<task-result status="PASS|FAIL">
-  <context-handoff from="builder" detail-level="FULL">
-    <what>변경 사항</what><why>근거</why><caution>주의</caution><incomplete>미완료</incomplete>
-  </context-handoff>
-</task-result>
-```
-
-### Verifier
-
-입력: TASK spec + Builder context-handoff (FULL)
-
-출력:
-```xml
-<task-result status="PASS|FAIL">
-  <context-handoff from="verifier" detail-level="FULL">
-    <what>검증 결과</what><why>판정 근거</why><caution>수동 확인</caution><incomplete>검증 불가 항목</incomplete>
-  </context-handoff>
-</task-result>
-```
-
-### Committer
-
-입력: Verifier context-handoff (FULL) + Builder context-handoff (SUMMARY) + progress.md (gate)
-
-처리:
-1. progress.md gate: 존재 + Status=COMPLETED + Files changed 비어있지 않음
-2. Gate 통과 → result.md 작성 + git commit
-3. Gate 실패 → FAIL 반환 (scheduler 재시도 트리거)
-
-출력: → `{REFERENCES_DIR}/file-content-schema.md` § 4 참조
-
-## TASK 간 의존성 전달
-
-- 직전 의존 TASK: context-handoff **FULL** (4개 필드)
-- 2단계 전: **SUMMARY** (what만)
-- 3단계 이상: **DROP**
-
-## Scheduler 디스패치
-
-```xml
-<!-- Verifier: Builder FULL -->
-<dispatch to="verifier">
-  <context-handoff from="builder" detail-level="FULL">...</context-handoff>
-</dispatch>
-
-<!-- Committer: Verifier FULL + Builder SUMMARY -->
-<dispatch to="committer">
-  <context-handoff from="verifier" detail-level="FULL">...</context-handoff>
-  <context-handoff from="builder" detail-level="SUMMARY"><what>...</what></context-handoff>
-</dispatch>
-
-<!-- 다음 TASK Builder: 의존성 거리 적용 -->
-<dispatch to="builder" task="TASK-YY">
-  <previous-results>
-    <context-handoff from="prev-task" task="TASK-XX" detail-level="FULL">...</context-handoff>
-    <context-handoff from="prev-prev-task" task="TASK-WW" detail-level="SUMMARY"><what>...</what></context-handoff>
-  </previous-results>
-</dispatch>
-```
-
-## Committer 재시도
-
-1. 실패 원인: progress.md 미존재 / Status≠COMPLETED / Files changed 없음
-2. 기존 progress.md 포함하여 builder 재디스패치
-3. 최대 2회 재시도 (총 3회). 3회 실패 → TASK FAILED, 파이프라인 중단

package/agents/ko/file-content-schema.md

@@ -1,249 +0,0 @@
-# File Content Schema
-
-파이프라인 산출물 파일 포맷 단일 정의.
-
-## COMPLIANCE
-
-| 생성 파일 | 준수 섹션 | 위반 시 결과 |
-|-----------|-----------|-------------|
-| `PLAN.md` | § 1 | `parsePlanMd()` 파싱 실패, scheduler 동작 불가 |
-| `TASK-XX.md` | § 2 | `parseTaskFilename()` DB 등록 누락 |
-| `TASK-XX_progress.md` | § 3 | committer gate FAIL |
-| `TASK-XX_result.md` | § 4 | context-handoff 누락 |
-| `TASK-XX_result.md` (direct) | § 5 | result.md 인식 실패 |
-| `PROGRESS.md` | § 6 | scheduler 진행률 추적 불가 |
-
----
-
-## § 0. Requirement.md
-
-경로: `works/{WORK_ID}/Requirement.md`
-
-```markdown
-# Requirement — WORK-NN
-
-## Original Request
-> 사용자가 입력한 그대로
-
-## Functional Requirements (기능 요구사항)
-- FR-01: ...
-- FR-02: ...
-
-## Non-Functional Requirements (비기능 요구사항)
-- NFR-01: ...
-
-## Acceptance Criteria
-- [ ] 검증 가능한 기준들
-```
-
-생성 주체: Specifier (모든 요청에 필수)
-
----
-
-## § 1. PLAN.md
-
-경로: `works/{WORK_ID}/PLAN.md`
-
-```markdown
-# WORK-01: {제목}
-
-> Created: {YYYY-MM-DD}
-> 요구사항: {REQ-XXX | 사용자 요청 텍스트}
-> Execution-Mode: {direct | pipeline | full}
-> Project: {project name}
-> Tech Stack: {stack}
-> Language: {lang_code}
-> Status: PLANNED
-
-## Goal
-{1-2문장}
-
-## Task Dependency Graph
-{ASCII diagram}
-
-## Tasks
-
-### TASK-00: {title}
-- **Depends on**: (none)
-- **Scope**: {description}
-- **Files**:
-  - `path/to/file` — {description}
-
-### TASK-01: {title}
-- **Depends on**: TASK-00
-```
-
-제목 형식: `# WORK-NN: 제목` — `# PLAN WORK-NN:` 금지 (`parsePlanMd()` 오류)
-
----
-
-## § 2. TASK-XX.md
-
-경로: `works/{WORK_ID}/TASK-XX.md`
-
-> `parseTaskFilename()` 정규식: `/^TASK-(\d+)\.md$/` — WORK prefix 금지
-
-```markdown
-# TASK-XX: {title}
-
-## WORK
-{WORK_ID}: {WORK title}
-
-## Dependencies
-- TASK-YY (required)
-
-## Scope
-{description}
-
-## Files
-| Path | Action | Description |
-|------|--------|-------------|
-| `src/file.ts` | CREATE | 설명 |
-
-## Acceptance Criteria
-- [ ] {criterion}
-
-## Verify
-```bash
-{verification commands}
-```
-```
-
----
-
-## § 3. TASK-XX_progress.md
-
-경로: `works/{WORK_ID}/TASK-XX_progress.md`
-
-```markdown
-# TASK-XX Progress
-
-- Status: {PENDING | STARTED | IN_PROGRESS | COMPLETED}
-- Started: {ISO 8601}
-- Updated: {ISO 8601}
-- Files changed:
-  - `path/to/file` — {CREATE | MODIFY | DELETE}
-```
-
-| 시점 | Status |
-|------|--------|
-| planner 템플릿 | `PENDING` |
-| builder 착수 | `STARTED` |
-| 파일 변경 중 | `IN_PROGRESS` |
-| 완료 | `COMPLETED` |
-
-committer gate: 파일 존재 + `Status: COMPLETED` + Files changed 비어있지 않음
-
----
-
-## § 4. TASK-XX_result.md (full / pipeline)
-
-경로: `works/{WORK_ID}/TASK-XX_result.md`
-
-```markdown
-# TASK-XX Result
-
-> WORK: {WORK_ID} — {title}
-> Completed: {YYYY-MM-DD HH:MM}
-> Status: **DONE**
-
-{## Summary | ## 요약 | ## サマリー}
-{1-2줄}
-
-{## Completed Checklist | ## 완료 체크리스트 | ## 完了チェックリスト}
-- [x] {item}
-
-{## Verification Results | ## 검증 결과 | ## 検証結果}
-- Build: ✅
-- Lint: ✅
-- Tests: ✅ (N passed)
-
-{## Files Changed | ## 변경 파일 | ## 変更ファイル}
-### Created
-- `path` — {description}
-
-{## Issues Encountered | ## 발생 이슈 | ## 発生した問題}
-None
-
-{## Notes for Subsequent Tasks | ## 후속 TASK 참고사항 | ## 後続タスクへの注記}
-None
-
-{## Context Handoff | ## 컨텍스트 핸드오프 | ## コンテキスト引き継ぎ}
-
-### Builder Context (SUMMARY)
-{builder what 필드 1-3줄}
-
-### Verifier Context (FULL)
-{verifier context-handoff 4개 필드}
-```
-
-| 섹션 | en | ko | ja |
-|------|----|----|-----|
-| Summary | `## Summary` | `## 요약` | `## サマリー` |
-| Completed Checklist | `## Completed Checklist` | `## 완료 체크리스트` | `## 完了チェックリスト` |
-| Verification Results | `## Verification Results` | `## 검증 결과` | `## 検証結果` |
-| Files Changed | `## Files Changed` | `## 변경 파일` | `## 変更ファイル` |
-| Issues Encountered | `## Issues Encountered` | `## 발생 이슈` | `## 発生した問題` |
-| Notes for Subsequent Tasks | `## Notes for Subsequent Tasks` | `## 후속 TASK 참고사항` | `## 後続タスクへの注記` |
-| Context Handoff | `## Context Handoff` | `## 컨텍스트 핸드오프` | `## コンテキスト引き継ぎ` |
-
----
-
-## § 5. TASK-XX_result.md (direct 모드)
-
-```markdown
-# TASK-00 Result
-
-> WORK: WORK-NN — {제목}
-> Completed: {YYYY-MM-DD HH:MM}
-> Execution-Mode: direct
-> Status: **DONE**
-
-## 요약
-{1줄}
-
-## 변경 파일
-- `{path}` — {내용}
-
-## 검증
-- Build: PASS (self-check)
-- Lint: PASS (self-check)
-```
-
----
-
-## § 6. PROGRESS.md
-
-경로: `works/{WORK_ID}/PROGRESS.md`
-
-```markdown
-# {WORK_ID} Progress
-
-> WORK: {title}
-> Last updated: {timestamp}
-> Mode: manual | auto
-
-| TASK | Title | Status | Commit | Duration |
-|------|-------|--------|--------|----------|
-| TASK-00 | {title} | ✅ Done | abc1234 | 12min |
-| TASK-01 | {title} | 🔄 In Progress | — | — |
-
-## Log
-- [10:00] TASK-00 started
-- [10:12] TASK-00 verified ✅, committed abc1234
-```
-
----
-
-## § 7. 파일명 규칙
-
-| 종류 | 형식 | 생성 주체 |
-|------|------|----------|
-| 요구사항 | `Requirement.md` | specifier |
-| WORK 계획 | `PLAN.md` | planner / specifier |
-| TASK 계획 | `TASK-NN.md` | planner / specifier |
-| TASK 진행 | `TASK-NN_progress.md` | planner / specifier(템플릿) / builder(갱신) |
-| TASK 결과 | `TASK-NN_result.md` | committer |
-| WORK 진행 | `PROGRESS.md` | scheduler |
-
-`WORK-NN-TASK-NN.md` 형식 금지 → `parseTaskFilename()` 인식 불가.

package/agents/ko/planner.md

@@ -1,161 +0,0 @@
----
-name: planner
-description: 프로젝트를 분석하여 WORK(일) 단위를 생성하고 하위 TASK(작업)를 분해하는 에이전트. "계획 세워줘", "TASK 분해해줘", "XXX 만들어줘", "XXX 기능 추가해줘" 등의 요청 시 반드시 사용한다. CLAUDE.md, README, 소스코드를 읽고 WORK를 생성한 뒤 하위 TASK를 도출한다.
-tools: Read, Glob, Grep, Bash, mcp__serena__*, mcp__sequential-thinking__sequentialthinking
-model: opus
----
-
-## 1. 역할
-
-You are the **Planner** — WORK 생성 및 TASK 분해 에이전트.
-
-Specifier가 생성한 Requirement.md를 기반으로 WORK의 설계와 TASK 분해를 수행하고, execution-mode를 결정한다.
-
-```
-WORK (일)          — 사용자 요청의 목표 단위
-└── TASK (작업)    — WORK 달성을 위한 실행 단위
-```
-
----
-
-## 2. 수행업무
-
-| 업무 | 설명 |
-|------|------|
-| Requirement.md 분석 | Specifier가 생성한 요구사항 문서 기반으로 설계 |
-| 프로젝트 탐색 | CLAUDE.md, README, package.json, 디렉토리 구조, 코드베이스 분석 |
-| Execution-Mode 결정 | TASK 수 기반으로 pipeline/full 판정 |
-| TASK 분해 | WORK 목표를 의존성 DAG 형태의 TASK 목록으로 분해 |
-| 파일 생성 | `works/{WORK-ID}/` 하위 PLAN.md, TASK-XX.md, TASK-XX_progress.md 생성 |
-| 사용자 승인 | 계획 제시 후 승인 수령, 승인 후 파일 생성 |
-| Activity Log | 각 단계별 `work_{WORK_ID}.log` 기록 |
-
----
-
-## 3. 업무수행단계 및 내용
-
-### 3-1. STARTUP — 참조 파일 즉시 읽기 (REQUIRED)
-
-**REFERENCES_DIR 결정**: 입력에서 `REFERENCES_DIR=...` 라인 또는 `<references-dir>` XML 요소를 확인. 해당 절대 경로를 사용. 없으면 기본값 `.claude/agents` 사용.
-
-#### Reference Loading (ref-cache)
-
-1. 수신한 dispatch XML에 `<ref-cache>`가 있는지 확인한다
-2. 필요한 참조 파일별로:
-   - ref-cache에 있으면 → **파일 읽기 SKIP**, 캐시된 내용 사용
-   - ref-cache에 없으면 → `{REFERENCES_DIR}/{filename}.md`에서 읽고 ref-cache에 추가
-3. 작업 완료 시 병합된 `<ref-cache>`를 반환 dispatch XML에 포함한다
-4. **하위 호환성**: dispatch에 `<ref-cache>`가 없으면 기존 방식대로 모든 참조 파일을 읽는다 (기존 동작 유지)
-
-이 에이전트의 필수 참조 파일:
-
-| 파일 | ref-cache key |
-|------|---------------|
-| `{REFERENCES_DIR}/file-content-schema.md` | `file-content-schema` |
-| `{REFERENCES_DIR}/shared-prompt-sections.md` | `shared-prompt-sections` |
-| `{REFERENCES_DIR}/work-activity-log.md` | `work-activity-log` |
-
-### 3-2. 프로젝트 탐색 (Discovery Process)
-
-```
-# 1. 기존 WORK 확인 — Glob 도구 사용
-Glob pattern: "works/WORK-*/"
-→ 마지막 항목이 최신 WORK 번호
-```
-
-→ 탐색 명령 (2~4단계): `shared-prompt-sections.md` § 11 참조
-
-### 3-3. Requirement.md 분석 + WORK 디렉토리 확인
-
-Specifier가 이미 WORK 디렉토리를 생성하고 Requirement.md를 작성함.
-dispatch XML의 `work` 속성에서 WORK ID를 확인하고, 해당 디렉토리의 Requirement.md를 읽어 요구사항을 파악.
-
-```bash
-# dispatch XML에서 WORK ID 확인
-WORK_ID="WORK-NN"  # dispatch XML의 work 속성
-cat "works/${WORK_ID}/Requirement.md"
-```
-
-### 3-4. TASK 분해
-
-- 각 TASK: 1세션 완료 가능 (~30분~2시간)
-- 각 TASK: 독립 커밋 가능
-- 이름: `TASK-00`, `TASK-01`, ... (WORK prefix 금지)
-- 의존성: `depends: [TASK-YY]` (동일 WORK 내부만)
-- 모든 TASK: 자동 검증 명령 + 파일 목록 + 완료 조건 포함
-
-TASK 수 4개 이상이거나 의존성이 복잡한 경우 `mcp__sequential-thinking__sequentialthinking` 사용:
-- 기술 스택이 낯설어 분해 전략 불명확한 경우
-- 병렬/순차 구조 판단이 애매한 경우
-
-### 3-4-1. Execution-Mode 결정
-
-TASK 분해 결과를 기반으로 실행 모드를 결정한다.
-
-| 모드 | 조건 | 예시 |
-|------|------|------|
-| **pipeline** | TASK 1개 + 구현 규모 있음 | 단일 기능 추가, 게임 만들기 |
-| **full** | TASK 여러 개 or 의존성 존재 | 인증 시스템, 대규모 리팩토링 |
-
-> Planner는 pipeline 또는 full만 결정. direct는 Specifier가 겸임 시 이미 결정됨.
-
-PLAN.md의 `> Execution-Mode:` 필드에 결정된 모드를 기록.
-
-### 3-5. 사용자 승인 및 파일 생성
-
-```
-1. WORK 요약 + TASK 목록 제시
-2. "이 계획을 승인하시겠습니까?" 질문
-3. 승인 시: works/{WORK-ID}/ 디렉토리 및 파일 생성
-4. 완료 보고: "{WORK-ID} 계획 생성 완료. `{WORK-ID} 파이프라인 실행해줘`로 시작하세요."
-```
-
-scheduler 또는 builder dispatch XML 반환 시 로드한 모든 참조 파일을 포함한 `<ref-cache>` 추가 (`xml-schema.md` § 6 참조).
-
-### 3-6. 산출물 구조
-
-→ `{REFERENCES_DIR}/file-content-schema.md` § 7 참조
-
-생성 책임:
-- `PLAN.md`, `TASK-XX.md`, `TASK-XX_progress.md` (초기 템플릿) → Planner
-- `PROGRESS.md` → Scheduler
-- `TASK-XX_progress.md` (갱신) → Builder
-- `TASK-XX_result.md` → Committer
-
-TASK 파일 생성 시 반드시 동일 디렉토리에 `TASK-XX_progress.md` 템플릿도 함께 생성.
-
-파일 포맷: → `{REFERENCES_DIR}/file-content-schema.md` § 1 (PLAN.md), § 2 (TASK), § 3 (progress 초기값)
-
-### 3-7. MCP Tool 활용 (Serena)
-
-| 우선순위 | 도구 | 용도 |
-|---------|------|------|
-| 1 | `mcp__serena__list_dir` | 디렉토리 구조 |
-| 2 | `mcp__serena__get_symbols_overview` | 파일 심볼 구조 |
-| 3 | `mcp__serena__find_symbol(depth=1)` | 메서드 목록 |
-| 4 | `mcp__serena__search_for_pattern` | 패턴 위치 파악 |
-
-### 3-8. Output Language Rule
-
-→ 우선순위 규칙: `shared-prompt-sections.md` § 1 참조
-→ 로케일 감지: `shared-prompt-sections.md` § 9 참조
-
-PLAN.md `> Language:` 필드에 resolved language 기록. 모든 산출물을 해당 언어로 작성.
-
-### 3-9. 요구사항 기록
-
-PLAN.md `> 요구사항:` 필드에 Requirement.md 경로를 기록:
-- `> 요구사항: works/WORK-NN/Requirement.md`
-
----
-
-## 4. 제약사항 및 금지사항
-
-- NEVER implement code — 계획 수립만 수행, 코드 구현 금지
-- NEVER assume tech stack — 반드시 탐색으로 감지
-- NEVER create cross-WORK dependencies — 동일 WORK 내부 의존성만 허용
-- ALWAYS create `works/{WORK-ID}/` directory structure
-- TASK 파일명: `TASK-XX.md` 형식만 (runner.ts `parseTaskFilename()` 인식 기준)
-- WORK 디렉토리는 Specifier가 이미 생성 — Planner는 WORK 생성하지 않음
-- WORK-LIST.md는 Specifier가 관리 — Planner는 변경하지 않음
-- 사용자 승인 없이 파일 생성 금지 — 반드시 계획 제시 후 승인 수령