claude-prism 0.4.0 → 0.4.1

package/README.ko.md

@@ -32,6 +32,22 @@ AI 코딩 문제 분해 도구 — Understand, Decompose, Execute, Checkpoint (U
 
 AI 코딩의 가장 비싼 실패는 나쁜 코드가 아니라 — **틀린 것을 만드는 것**이다. AI 에이전트는 이해를 건너뛰고, 분해를 건너뛰고, 30분간 자율 실행한 뒤 사용자가 원하지 않은 것을 만들어냄. Prism은 CLAUDE.md에 방법론 규칙을 주입하여 Claude의 사고방식을 바꾼다.
 
+### v0.4.0 주요 변경
+
+- **태스크 크기 태그** — 모든 태스크에 `[S]`, `[M]`, `[L]` 부여, 적응형 배치 구성 (S+S+M = 1배치, L = 단독)
+- **태스크별 검증 전략** — 플랜 템플릿에 `| 검증: TDD`, `| 검증: Build`, `| 검증: Visual` 명시
+- **사전 분해 체크리스트** — 플랜 작성 전 타입/스키마/의존성 확인 필수화
+- **진행률 대시보드** — 각 체크포인트에 Phase/Batch/Task 퍼센트와 시각적 프로그레스 바
+- **적응형 체크포인트** — 3회 연속 승인 시 남은 Phase 동안 배치 크기 5-8로 확대
+- **Scope Guard 디스크 폴백** — 세션 간 `docs/plans/*.md` 존재를 디스크에서 직접 확인 (거짓 "without a plan" 경고 해결)
+- **20개 테스트 러너 패턴** — bun, pnpm, yarn, deno, rspec, dotnet, mvn, gradle 감지 추가
+- **9개 프레임워크별 결과 감지** — node, jest, vitest, pytest, go, cargo, mocha, rspec, dotnet 정확한 성공/실패 판별
+- **통합 hook 파이프라인** — hook 이벤트당 단일 프로세스 (I/O 감소)
+- **i18n 메시지 시스템** — 모든 hook 메시지 en/ko/ja/zh 지역화
+- **세션 이벤트 로깅** — JSONL 기반 세션별 이벤트 기록
+- **정렬 감지** — 범위 이탈 추적 및 주요 결정 플래깅
+- **커스텀 규칙** — 설정을 통한 사용자 정의 hook 규칙
+
 ## 설치
 
 프로젝트 루트에서:
@@ -65,19 +81,23 @@ npx claude-prism update --global   # 글로벌 스킬도 업데이트
 │   │       ├── help.md          # /claude-prism:help
 │   │       └── update.md        # /claude-prism:update
 │   ├── hooks/                # (선택, --no-hooks 시 생략)
-│   │   ├── commit-guard.mjs
-│   │   ├── debug-loop.mjs
-│   │   ├── test-tracker.mjs
-│   │   └── scope-guard.mjs
+│   │   ├── pre-tool.mjs      # 통합 PreToolUse 러너
+│   │   ├── post-tool.mjs     # 통합 PostToolUse 러너
+│   │   └── user-prompt.mjs   # UserPromptSubmit 러너
 │   ├── rules/                # hook 규칙 로직
 │   │   ├── commit-guard.mjs
 │   │   ├── debug-loop.mjs
 │   │   ├── test-tracker.mjs
-│   │   └── scope-guard.mjs
+│   │   ├── scope-guard.mjs
+│   │   ├── alignment.mjs
+│   │   └── turn-reporter.mjs
 │   ├── lib/                  # hook 의존 모듈
 │   │   ├── adapter.mjs
+│   │   ├── pipeline.mjs
 │   │   ├── state.mjs
+│   │   ├── session.mjs
 │   │   ├── config.mjs
+│   │   ├── messages.mjs
 │   │   └── utils.mjs
 │   └── settings.json         # Claude Code hook 등록
 └── docs/plans/               # /claude-prism:prism 실행 시 계획 파일 생성
@@ -235,7 +255,7 @@ prism stats
 
 출력:
 ```
-  Version:   v0.3.1
+  Version:   v0.4.0
   Language:  ko
   Plans:     2 file(s)
   OMC:       ✅ v4.1.1
@@ -311,16 +331,19 @@ Hook은 선택 사항인 CLI 가드로, 개발 중 규율을 강제합니다. `p
 
 테스트 커맨드 실행을 감지하고 타임스탐프와 성공/실패 상태를 기록합니다. `commit-guard`가 최근 테스트 실행을 확인하는 데 사용합니다.
 
-**감지하는 테스트:**
-- `npm test`, `npm run test`
-- `jest`, `vitest`
-- `node --test`
-- `npx mocha`, `mocha`
-- `pytest`
-- `cargo test`
-- `go test`
+**감지하는 테스트 (20개 패턴):**
+- `npm test`, `pnpm test`, `yarn test`, `bun test`
+- `jest`, `vitest`, `mocha`, `rspec`
+- `node --test`, `deno test`
+- `npx jest`, `npx vitest`, `npx mocha`, `bunx vitest`
+- `pytest`, `cargo test`, `go test`
+- `dotnet test`, `mvn test`, `gradle test`
 - `make test`
 
+**프레임워크별 결과 감지 (9개):**
+- Node test runner, Jest, Vitest, Pytest, Go, Cargo, Mocha, RSpec, dotnet
+- stdout와 stderr를 모두 분석하여 정확한 성공/실패 판별
+
 **설정:**
 ```json
 {
@@ -366,6 +389,7 @@ Hook은 선택 사항인 CLI 가드로, 개발 중 규율을 강제합니다. `p
 - **플랜 인식**: 플랜 파일 생성 시 (`docs/plans/*.md`) 임계값이 자동으로 2배
   - 표준 + 플랜: 8개에서 경고, 14개에서 차단
   - Agent + 플랜: 16개에서 경고, 24개에서 차단
+- **세션 간 지속성**: 현재 세션에서 생성된 플랜뿐만 아니라 디스크에 존재하는 기존 플랜 파일(`docs/plans/*.md`)도 감지. 새 세션에서 작업 재개 시 거짓 "without a plan" 경고 해결.
 
 ## 설정
 
@@ -411,7 +435,7 @@ prism doctor      # 진단 정보에 OMC 감지 표시
 ## 기술 사양
 
 - **패키지명**: `claude-prism`
-- **버전**: 0.3.1
+- **버전**: 0.4.0
 - **CLI 커맨드**: `prism`
 - **Node 버전**: >= 18
 - **의존성**: 0 (순수 ESM 모듈)
@@ -430,10 +454,11 @@ prism doctor      # 진단 정보에 OMC 감지 표시
 
 1. **정보 충분성 판별** — 요청이 명확한가? 질문이 필요한가?
 2. **최대 3라운드 질문** — 한 번에 하나씩, 객관식 우선
-3. **분해 5원칙** — 단위 크기, 테스트 선행, 독립 검증, 파일 명시, 의존성 명시
-4. **적응형 배치 + 체크포인트** — 복잡도별 배치 크기 조절 (단순 5-8 / 일반 3-4 / 복잡 1-2), 배치마다 보고
-5. **컨텍스트 인식 검증** — 파일 경로별 검증 전략 (lib→TDD, components→빌드, config→lint)
-6. **자기 교정** — 같은 파일 3회 편집 시 멈추고 재검토
+3. **분해 5원칙 + 사전 체크** — 단위 크기, 테스트 선행, 독립 검증, 파일 명시, 의존성 명시 + 타입/스키마/교차패키지 확인
+4. **크기 태그 + 적응형 배치** — [S/M/L] 태그 기반 배치 구성, 3회 연속 승인 시 배치 확대
+5. **태스크별 검증 전략** — TDD / Build / Visual 명시, 파일 경로별 자동 선택
+6. **진행률 대시보드** — Phase/Batch/Task % 시각화, 체크포인트마다 보고
+7. **자기 교정** — 같은 파일 3회 편집 시 멈추고 재검토
 
 ## 라이선스
 

package/README.md

@@ -21,6 +21,22 @@ An AI coding problem decomposition tool for Claude Code. Installs the **UDEC** m
 
 **Core philosophy:** Never implement what you haven't understood. Never execute what you haven't decomposed.
 
+### What's New in v0.4.0
+
+- **Task size tags** — Every task gets `[S]`, `[M]`, or `[L]` with adaptive batch composition (S+S+M = 1 batch, L = solo)
+- **Verification strategy per task** — `| Verify: TDD`, `| Verify: Build`, or `| Verify: Visual` in plan templates
+- **Pre-decomposition checklist** — Mandatory type/schema/dependency check before creating plans
+- **Progress dashboard** — Visual progress bar with phase/batch/task percentages at each checkpoint
+- **Adaptive checkpoints** — After 3 consecutive approvals, batch size expands to 5-8 for the rest of the phase
+- **Scope guard disk fallback** — Detects existing `docs/plans/*.md` on disk, not just in-session writes (fixes false "without a plan" warnings across sessions)
+- **20 test runner patterns** — Added bun, pnpm, yarn, deno, rspec, dotnet, mvn, gradle detection
+- **9 framework-specific result detectors** — Accurate pass/fail for node, jest, vitest, pytest, go, cargo, mocha, rspec, dotnet
+- **Unified hook pipeline** — Single process per hook event instead of separate processes per rule (reduced I/O)
+- **i18n message system** — All hook messages localized in en/ko/ja/zh
+- **Session event logging** — JSONL-based per-session event recording
+- **Alignment detection** — Scope drift tracking and major decision flagging
+- **Custom rules** — User-defined hook rules via config
+
 ## The Problem
 
 Without structure, Claude does this:
@@ -66,11 +82,13 @@ After running `prism init`, your project gains:
 - `/claude-prism:update` — Update rules and commands to latest version
 - `/claude-prism:help` — Command reference
 
-**Hooks** (optional, unless `--no-hooks` is set) — Four CLI guards that enforce discipline:
+**Hooks** (optional, unless `--no-hooks` is set) — Six CLI guards that enforce discipline:
 - `commit-guard` — Prevents commits when tests haven't run recently
 - `debug-loop` — Detects divergent editing patterns on the same file (catches infinite debugging loops)
-- `test-tracker` — Detects test command execution (npm test, jest, vitest, pytest, etc.) and records pass/fail state
-- `scope-guard` — Warns at 4 unique files modified, blocks at 7 (agent-aware: warns at 8, blocks at 12)
+- `test-tracker` — Detects test execution (20 patterns, 9 framework-specific result detectors) and records pass/fail
+- `scope-guard` — Warns at 4 unique files modified, blocks at 7 (agent-aware, plan-aware with disk fallback)
+- `alignment` — Detects scope drift (new directories outside base scope) and major decisions (package installs, db migrations, destructive deletes)
+- `turn-reporter` — Tracks turn count, warns at 5 autonomous turns without user input, provides previous turn summary
 
 **Configuration** — `.prism.json` stores language preference and hook settings. Includes OMC (oh-my-claudecode) detection.
 
@@ -91,19 +109,23 @@ your-project/
 │   │       ├── update.md        # /claude-prism:update
 │   │       └── help.md          # /claude-prism:help
 │   ├── hooks/               # (optional, if --no-hooks not set)
-│   │   ├── commit-guard.mjs
-│   │   ├── debug-loop.mjs
-│   │   ├── test-tracker.mjs
-│   │   └── scope-guard.mjs
+│   │   ├── pre-tool.mjs     # Unified PreToolUse runner
+│   │   ├── post-tool.mjs    # Unified PostToolUse runner
+│   │   └── user-prompt.mjs  # UserPromptSubmit runner
 │   ├── rules/               # Hook logic modules
 │   │   ├── commit-guard.mjs
 │   │   ├── debug-loop.mjs
 │   │   ├── test-tracker.mjs
-│   │   └── scope-guard.mjs
+│   │   ├── scope-guard.mjs
+│   │   ├── alignment.mjs
+│   │   └── turn-reporter.mjs
 │   ├── lib/                 # Hook dependencies
 │   │   ├── adapter.mjs
+│   │   ├── pipeline.mjs
 │   │   ├── state.mjs
+│   │   ├── session.mjs
 │   │   ├── config.mjs
+│   │   ├── messages.mjs
 │   │   └── utils.mjs
 │   └── settings.json        # Claude Code hook registration
 └── docs/plans/
@@ -268,16 +290,19 @@ Detects editing patterns on the same file. Distinguishes between **divergent** e
 
 Detects test command execution and records the timestamp and pass/fail state. Used by `commit-guard` to verify tests ran recently.
 
-**Detects:**
-- `npm test`, `npm run test`
-- `jest`, `vitest`
-- `node --test`
-- `npx mocha`, `mocha`
-- `pytest`
-- `cargo test`
-- `go test`
+**Detects (20 patterns):**
+- `npm test`, `pnpm test`, `yarn test`, `bun test`
+- `jest`, `vitest`, `mocha`, `rspec`
+- `node --test`, `deno test`
+- `npx jest`, `npx vitest`, `npx mocha`, `bunx vitest`
+- `pytest`, `cargo test`, `go test`
+- `dotnet test`, `mvn test`, `gradle test`
 - `make test`
 
+**Framework-specific result detection (9 detectors):**
+- Node test runner, Jest, Vitest, Pytest, Go, Cargo, Mocha, RSpec, dotnet
+- Analyzes both stdout and stderr for accurate pass/fail determination
+
 **Configuration:**
 ```json
 {
@@ -323,6 +348,7 @@ Tracks unique source files modified per session. Warns when scope grows without
 - **Plan-aware**: When a plan file is created (`docs/plans/*.md`), thresholds are automatically doubled
   - Standard with plan: warns at 8, blocks at 14
   - Agent with plan: warns at 16, blocks at 24
+- **Cross-session persistence**: Detects existing plan files on disk (`docs/plans/*.md`), not just plans created in the current session. Fixes false "without a plan" warnings when resuming work in a new session.
 
 ## Configuration
 
@@ -412,7 +438,7 @@ prism stats
 
 Output:
 ```
-  Version:   v0.3.1
+  Version:   v0.4.0
   Language:  en
   Plans:     2 file(s)
   OMC:       ✅ v4.1.1

package/hooks/scope-guard.mjs

@@ -6,6 +6,8 @@
 import { readJsonState, writeJsonState } from '../lib/state.mjs';
 import { DEFAULTS, buildSourcePattern, buildTestPattern } from '../lib/config.mjs';
 import { getMessage } from '../lib/messages.mjs';
+import { existsSync, readdirSync } from 'fs';
+import { join } from 'path';
 
 const PLAN_PATTERN = /(?:^|\/)docs\/plans\/.*\.md$|(?:^|\/).*plan.*\.md$/i;
 
@@ -47,7 +49,25 @@ export const scopeGuard = {
     let blockAt = isAgent ? (config.agentBlockAt || 12) : (config.blockAt || 7);
 
     // Active plan → double thresholds (planned work is expected to touch many files)
-    const hasPlan = readJsonState(stateDir, 'scope-has-plan');
+    let hasPlan = readJsonState(stateDir, 'scope-has-plan');
+
+    // Fallback: check disk for existing plan files (survives session restart)
+    if (!hasPlan) {
+      try {
+        const root = config.projectRoot || process.cwd();
+        const plansDir = join(root, 'docs', 'plans');
+        if (existsSync(plansDir)) {
+          const planFiles = readdirSync(plansDir).filter(f => f.endsWith('.md'));
+          if (planFiles.length > 0) {
+            hasPlan = true;
+            writeJsonState(stateDir, 'scope-has-plan', true);
+          }
+        }
+      } catch {
+        // Ignore filesystem errors — fail open
+      }
+    }
+
     if (hasPlan) {
       warnAt *= 2;
       blockAt *= 2;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-prism",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "AI coding problem decomposition tool — Understand, Decompose, Execute, Checkpoint.",
   "type": "module",
   "bin": {

package/templates/commands/claude-prism/checkpoint.md

@@ -22,13 +22,29 @@ When this command is invoked:
 
    ### Progress
 
+   ```
+   Phase: [current phase] | Batch: [N/M] | Tasks: [done/total] ([%])
+   [████████░░] 80% — Next: [next batch name]
+   ```
+
    - Batches complete: N/M
    - Current batch: [name] — [X/Y tasks done]
    - Remaining: [batch names]
    - Blockers: [any issues encountered]
 
+   ### Task Size Distribution
+
+   | Size | Count | Done |
+   |------|-------|------|
+   | [S] Small | N | N |
+   | [M] Medium | N | N |
+   | [L] Large | N | N |
+
 4. **Show summary**:
    - Files created/modified so far
    - Tests added and their status
    - Commits made
-5. **Ask**: "Continue with the current plan, adjust, or stop?"
+5. **Checkpoint policy check**:
+   - If 3+ consecutive approvals → suggest expanding batch size to 5-8
+   - If phase boundary → always stop
+6. **Ask**: "Continue with the current plan, adjust, or stop?"

package/templates/commands/claude-prism/prism.md

@@ -42,8 +42,15 @@ When this command is invoked, follow the UDEC framework strictly:
    - Independent verification: each unit has a pass criterion
    - Files specified: list files to create/modify per unit
    - Dependencies noted: mark if unit depends on a previous one
-9. **Save plan** to `docs/plans/YYYY-MM-DD-<topic>.md`
-10. **Get approval**: "Proceed with this plan?"
+9. **Assign size tags** to every task: [S] <30 LOC, [M] 30-100 LOC, [L] >100 LOC
+   - Batch composition: S+S+M = 1 batch, L = 1 batch alone
+10. **Assign verification strategy** per task: `| Verify: TDD` or `| Verify: Build` or `| Verify: Visual`
+11. **Pre-decomposition checklist**:
+    - Required types/interfaces have the necessary fields?
+    - External package APIs behave as expected?
+    - Cross-package dependencies identified and noted as prerequisites?
+12. **Save plan** to `docs/plans/YYYY-MM-DD-<topic>.md`
+13. **Get approval**: "Proceed with this plan?"
 
 ## E — EXECUTE
 
@@ -70,15 +77,21 @@ When this command is invoked, follow the UDEC framework strictly:
 
 ## C — CHECKPOINT
 
-17. After each batch, report using this format:
+20. After each batch, report using this format:
 
     | Item | Before | After |
     |------|--------|-------|
     | [what changed] | [old behavior] | [new behavior] |
 
-18. Include: verification results, files modified, tests status
-19. Ask: "Continue to next batch?"
-20. User can redirect, adjust scope, or stop at any checkpoint
+    ```
+    Phase: [current] | Batch: [N/M] | Tasks: [done/total] ([%])
+    [████████░░] 80% — Next: [next batch name]
+    ```
+
+21. Include: verification results, files modified, tests status
+22. **Checkpoint policy**: after 3 consecutive approvals, increase batch size to 5-8 for the rest of the phase
+23. Ask: "Continue to next batch?"
+24. User can redirect, adjust scope, or stop at any checkpoint
 
 ## OMC Integration
 

package/templates/rules.en.md

@@ -105,11 +105,16 @@ One sentence: what we're building and why.
 Tech stack, key decisions, 2-3 sentences max.
 
 ## Batch 1: [Name]
-- [ ] Task 1.1: [description] → `path/to/file`
+- [ ] Task 1.1: [S] [description] | Verify: Build → `path/to/file`
+  - Pass criterion: [specific assertion]
+- [ ] Task 1.2: [M] [description] | Verify: TDD → `path/to/file`
+  - Prerequisite: Task 1.1
+  - Test: `path/to/test` — [what it verifies]
+  - Pass criterion: [specific assertion]
+- [ ] Task 1.3: [L] [description] | Verify: TDD → `path/to/file`
+  - Prerequisite: Task 1.1, Task 1.2
   - Test: `path/to/test` — [what it verifies]
   - Pass criterion: [specific assertion]
-- [ ] Task 1.2: ...
-- [ ] Task 1.3: ...
 
 ## Batch 2: [Name]
 - [ ] Task 2.1: ...
@@ -118,6 +123,20 @@ Tech stack, key decisions, 2-3 sentences max.
 - [Known unknowns or potential blockers]
 ```
 
+### 2-6. Task Sizing and Pre-Decomposition Check
+
+**Size Tags (assign to every task):**
+- **[S]** Small: <30 LOC, config/style/single-function changes
+- **[M]** Medium: 30-100 LOC, feature implementation, component creation
+- **[L]** Large: >100 LOC, multi-file rewrite, new module/architecture
+
+**Batch composition by size**: S+S+M = 1 batch, L = 1 batch alone, S+S+S+S = 1 batch
+
+**Pre-decomposition checklist (before creating plan):**
+- [ ] Required types/interfaces have the necessary fields?
+- [ ] External package APIs behave as expected?
+- [ ] Cross-package dependencies identified and noted as prerequisites?
+
 ---
 
 ## 3. EXECUTE — Execution Protocol
@@ -212,6 +231,17 @@ After each batch:
 - Preview next batch
 - "Continue?"
 
+**Checkpoint frequency policy:**
+- **Phase boundary**: always stop (mandatory)
+- **Batch boundary**: stop by default → after 3 consecutive approvals, increase batch size to 5-8 for the remainder of the phase
+- **Blocker encountered**: always stop (mandatory)
+
+**Progress dashboard (include at each checkpoint):**
+```
+Phase: [current phase] | Batch: [N/M] | Tasks: [done/total] ([%])
+[████████░░] 80% — Next: [next batch name]
+```
+
 ### 4-2. Direction Change
 
 User says "change direction" → return to UNDERSTAND

package/templates/rules.ja.md

@@ -105,11 +105,16 @@ DECOMPOSEに進む前に確認:
 技術スタック、主要決定事項、2-3文。
 
 ## Batch 1: [名前]
-- [ ] Task 1.1: [説明] → `path/to/file`
+- [ ] Task 1.1: [S] [説明] | 検証: Build → `path/to/file`
+  - 合格基準: [具体的なアサーション]
+- [ ] Task 1.2: [M] [説明] | 検証: TDD → `path/to/file`
+  - 前提: Task 1.1
+  - テスト: `path/to/test` — [検証内容]
+  - 合格基準: [具体的なアサーション]
+- [ ] Task 1.3: [L] [説明] | 検証: TDD → `path/to/file`
+  - 前提: Task 1.1, Task 1.2
   - テスト: `path/to/test` — [検証内容]
   - 合格基準: [具体的なアサーション]
-- [ ] Task 1.2: ...
-- [ ] Task 1.3: ...
 
 ## Batch 2: [名前]
 - [ ] Task 2.1: ...
@@ -118,6 +123,20 @@ DECOMPOSEに進む前に確認:
 - [既知の不確実性や潜在的ブロッカー]
 ```
 
+### 2-6. タスクサイズ見積もりと事前分解チェック
+
+**サイズタグ（すべてのタスクに付与）:**
+- **[S]** Small: <30 LOC、設定/スタイル/単一関数の変更
+- **[M]** Medium: 30-100 LOC、機能実装、コンポーネント作成
+- **[L]** Large: >100 LOC、複数ファイルの書き換え、新規モジュール/アーキテクチャ
+
+**サイズに基づくバッチ構成**: S+S+M = 1バッチ、L = 単独1バッチ、S+S+S+S = 1バッチ
+
+**事前分解チェックリスト（計画作成前に必須）:**
+- [ ] 必要な型/インターフェースに必要なフィールドが存在するか？
+- [ ] 外部パッケージのAPIが期待通りに動作するか？
+- [ ] パッケージ間の依存関係が特定され、前提条件として記録されているか？
+
 ---
 
 ## 3. EXECUTE (実行) — 実行プロトコル
@@ -212,6 +231,17 @@ DECOMPOSEに進む前に確認:
 - 次のバッチをプレビュー
 - 「続行しますか?」
 
+**チェックポイント頻度ポリシー:**
+- **フェーズ境界**: 常に停止（必須）
+- **バッチ境界**: デフォルトで停止 → 3回連続承認後、残りのフェーズはバッチサイズを5-8に拡大
+- **ブロッカー発生**: 常に停止（必須）
+
+**進捗ダッシュボード（各チェックポイントに含める）:**
+```
+Phase: [現在のフェーズ] | Batch: [N/M] | Tasks: [完了/合計] ([%])
+[████████░░] 80% — 次: [次のバッチ名]
+```
+
 ### 4-2. 方向転換
 
 ユーザーが「方向を変える」と言う → UNDERSTANDに戻る

package/templates/rules.ko.md

@@ -105,11 +105,16 @@ DECOMPOSE로 넘어가기 전 확인:
 기술 스택, 주요 결정, 2-3문장.
 
 ## Batch 1: [이름]
-- [ ] Task 1.1: [설명] → `path/to/file`
+- [ ] Task 1.1: [S] [설명] | 검증: Build → `path/to/file`
+  - 통과 기준: [구체적 단언]
+- [ ] Task 1.2: [M] [설명] | 검증: TDD → `path/to/file`
+  - 선행: Task 1.1
+  - 테스트: `path/to/test` — [검증 대상]
+  - 통과 기준: [구체적 단언]
+- [ ] Task 1.3: [L] [설명] | 검증: TDD → `path/to/file`
+  - 선행: Task 1.1, Task 1.2
   - 테스트: `path/to/test` — [검증 대상]
   - 통과 기준: [구체적 단언]
-- [ ] Task 1.2: ...
-- [ ] Task 1.3: ...
 
 ## Batch 2: [이름]
 - [ ] Task 2.1: ...
@@ -118,6 +123,20 @@ DECOMPOSE로 넘어가기 전 확인:
 - [알려진 불확실성 또는 잠재적 블로커]
 ```
 
+### 2-6. 태스크 크기 산정 및 사전 분해 점검
+
+**크기 태그 (모든 태스크에 부여):**
+- **[S]** Small: <30 LOC, 설정/스타일/단일 함수 변경
+- **[M]** Medium: 30-100 LOC, 기능 구현, 컴포넌트 생성
+- **[L]** Large: >100 LOC, 멀티파일 리라이트, 새 모듈/아키텍처
+
+**크기별 배치 구성**: S+S+M = 1배치, L = 단독 1배치, S+S+S+S = 1배치
+
+**사전 분해 체크리스트 (플랜 작성 전 필수):**
+- [ ] 필요한 타입/인터페이스에 요구되는 필드가 존재하는가?
+- [ ] 외부 패키지 API가 예상대로 동작하는가?
+- [ ] 교차 패키지 의존성이 식별되고 선행 조건으로 기록되었는가?
+
 ---
 
 ## 3. EXECUTE — 실행 프로토콜
@@ -212,6 +231,17 @@ DECOMPOSE로 넘어가기 전 확인:
 - 다음 배치 미리보기
 - "계속 진행할까요?"
 
+**체크포인트 빈도 정책:**
+- **Phase 경계**: 항상 멈춤 (필수)
+- **Batch 경계**: 기본 멈춤 → 3회 연속 승인 시 남은 Phase 동안 배치 크기 5-8로 확대
+- **블로커 발생**: 항상 멈춤 (필수)
+
+**진행률 대시보드 (각 체크포인트에 포함):**
+```
+Phase: [현재 페이즈] | Batch: [N/M] | Tasks: [완료/전체] ([%])
+[████████░░] 80% — 다음: [다음 배치 이름]
+```
+
 ### 4-2. 방향 전환
 
 사용자가 "방향 바꾸자" → UNDERSTAND로 돌아감

package/templates/rules.zh.md

@@ -105,11 +105,16 @@
 技术栈、关键决策，2-3 句。
 
 ## Batch 1: [名称]
-- [ ] Task 1.1: [描述] → `path/to/file`
+- [ ] Task 1.1: [S] [描述] | 验证: Build → `path/to/file`
+  - 通过标准: [具体断言]
+- [ ] Task 1.2: [M] [描述] | 验证: TDD → `path/to/file`
+  - 前置: Task 1.1
+  - 测试: `path/to/test` — [验证什么]
+  - 通过标准: [具体断言]
+- [ ] Task 1.3: [L] [描述] | 验证: TDD → `path/to/file`
+  - 前置: Task 1.1, Task 1.2
   - 测试: `path/to/test` — [验证什么]
   - 通过标准: [具体断言]
-- [ ] Task 1.2: ...
-- [ ] Task 1.3: ...
 
 ## Batch 2: [名称]
 - [ ] Task 2.1: ...
@@ -118,6 +123,20 @@
 - [已知的不确定性或潜在阻塞]
 ```
 
+### 2-6. 任务规模评估与分解前检查
+
+**规模标签（为每个任务分配）：**
+- **[S]** Small：<30 LOC，配置/样式/单函数变更
+- **[M]** Medium：30-100 LOC，功能实现，组件创建
+- **[L]** Large：>100 LOC，多文件重写，新模块/架构
+
+**按规模组成批次**：S+S+M = 1批次，L = 单独1批次，S+S+S+S = 1批次
+
+**分解前检查清单（创建计划前必须）：**
+- [ ] 所需的类型/接口是否具有必要的字段？
+- [ ] 外部包的 API 是否按预期工作？
+- [ ] 是否已识别跨包依赖并记录为前置条件？
+
 ---
 
 ## 3. EXECUTE (执行) — 执行协议
@@ -212,6 +231,17 @@
 - 预览下一批次
 - "继续吗？"
 
+**检查点频率策略：**
+- **阶段边界**：始终停止（必须）
+- **批次边界**：默认停止 → 连续3次批准后，剩余阶段的批次大小扩大至5-8
+- **遇到阻塞**：始终停止（必须）
+
+**进度仪表板（在每个检查点包含）：**
+```
+Phase: [当前阶段] | Batch: [N/M] | Tasks: [已完成/总数] ([%])
+[████████░░] 80% — 下一步: [下一批次名称]
+```
+
 ### 4-2. 方向变更
 
 用户说"改变方向" → 返回 UNDERSTAND

package/templates/skills/prism/SKILL.md

@@ -71,8 +71,15 @@ AI agents optimize for speed, not correctness. Without structure, they skip unde
    - Independent verification: each unit has a pass criterion
    - Files specified: list files to create/modify per unit
    - Dependencies noted: mark if unit depends on a previous one
-9. **Save plan** to `docs/plans/YYYY-MM-DD-<topic>.md`
-10. **Get approval**: "Proceed with this plan?"
+9. **Assign size tags** to every task: [S] <30 LOC, [M] 30-100 LOC, [L] >100 LOC
+   - Batch composition: S+S+M = 1 batch, L = 1 batch alone
+10. **Assign verification strategy** per task: `| Verify: TDD` or `| Verify: Build` or `| Verify: Visual`
+11. **Pre-decomposition checklist**:
+    - Required types/interfaces have the necessary fields?
+    - External package APIs behave as expected?
+    - Cross-package dependencies identified and noted as prerequisites?
+12. **Save plan** to `docs/plans/YYYY-MM-DD-<topic>.md`
+13. **Get approval**: "Proceed with this plan?"
 
 ## E — EXECUTE
 
@@ -99,15 +106,21 @@ AI agents optimize for speed, not correctness. Without structure, they skip unde
 
 ## C — CHECKPOINT
 
-17. After each batch, report using this format:
+20. After each batch, report using this format:
 
     | Item | Before | After |
     |------|--------|-------|
     | [what changed] | [old behavior] | [new behavior] |
 
-18. Include: verification results, files modified, tests status
-19. Ask: "Continue to next batch?"
-20. User can redirect, adjust scope, or stop at any checkpoint
+    ```
+    Phase: [current] | Batch: [N/M] | Tasks: [done/total] ([%])
+    [████████░░] 80% — Next: [next batch name]
+    ```
+
+21. Include: verification results, files modified, tests status
+22. **Checkpoint policy**: after 3 consecutive approvals, increase batch size to 5-8 for the rest of the phase
+23. Ask: "Continue to next batch?"
+24. User can redirect, adjust scope, or stop at any checkpoint
 
 ## OMC Integration