claude-prism 0.4.0 → 0.5.0

package/README.md

@@ -21,6 +21,21 @@ 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)
+- **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:
@@ -36,10 +51,7 @@ Without structure, Claude does this:
 ## Installation
 
 ```bash
-npx claude-prism init              # English, with hooks
-npx claude-prism init --lang=ko    # Korean
-npx claude-prism init --lang=ja    # Japanese
-npx claude-prism init --lang=zh    # Chinese
+npx claude-prism init              # Install with hooks
 npx claude-prism init --no-hooks   # Rules only, no hooks
 npx claude-prism init --global     # Install as global skill (available in all projects)
 npx claude-prism update            # Update rules and commands to latest
@@ -66,13 +78,15 @@ 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.
+**Configuration** — `.claude-prism.json` stores hook settings. Includes OMC (oh-my-claudecode) detection.
 
 ## File Structure After Installation
 
@@ -91,19 +105,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/
@@ -140,7 +158,7 @@ your-project/
 | `/claude-prism:plan` | Manage plan files | List, create, or view plans |
 | `/claude-prism:checkpoint` | Mid-project | Check batch progress, preview next batch |
 | `/claude-prism:doctor` | Installation issues | Diagnose health, suggest fixes |
-| `/claude-prism:stats` | Check current state | Version, hooks, language, plan progress |
+| `/claude-prism:stats` | Check current state | Version, hooks, plan progress |
 | `/claude-prism:update` | After `npm update` | Update rules and commands to latest |
 | `/claude-prism:help` | Forgot commands | Quick reference |
 
@@ -199,7 +217,7 @@ User request arrives
 **Pattern 4: Quick Troubleshooting**
 ```
 /claude-prism:doctor → Check installation health
-/claude-prism:stats  → Verify hooks, language, OMC status
+/claude-prism:stats  → Verify hooks, OMC status
 ```
 
 ### Before & After
@@ -268,16 +286,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 +344,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
 
@@ -330,7 +352,6 @@ Edit `.claude-prism.json` to customize behavior:
 
 ```json
 {
-  "language": "en",
   "hooks": {
     "commit-guard": { "enabled": true, "maxTestAge": 300 },
     "debug-loop": { "enabled": true, "warnAt": 3, "blockAt": 5 },
@@ -341,7 +362,6 @@ Edit `.claude-prism.json` to customize behavior:
 ```
 
 **Settings:**
-- `language` — Rule language: `en` (English), `ko` (Korean), `ja` (Japanese), `zh` (Chinese)
 - `hooks.*` — Enable/disable individual hooks or customize thresholds
 - `hooks.commit-guard.maxTestAge` — Seconds before test is considered stale (default: 300)
 - `hooks.debug-loop.warnAt/blockAt` — Edit counts that trigger warnings/blocks
@@ -404,7 +424,7 @@ If issues are found:
 
 ### prism stats
 
-Show installation summary including version, language, hook status, plan file count, and OMC detection:
+Show installation summary including version, hook status, plan file count, and OMC detection:
 
 ```bash
 prism stats
@@ -412,8 +432,7 @@ prism stats
 
 Output:
 ```
-  Version:   v0.3.1
-  Language:  en
+  Version:   v0.4.0
   Plans:     2 file(s)
   OMC:       ✅ v4.1.1
   Hooks:
@@ -446,23 +465,6 @@ npx claude-prism uninstall
 
 This removes CLAUDE.md rules, slash commands, and hooks.
 
-## Languages
-
-Supported languages for UDEC rules:
-
-- **en** — English (default)
-- **ko** — Korean
-- **ja** — Japanese
-- **zh** — Chinese
-
-Change language (or re-install with different language):
-
-```bash
-npx claude-prism init --lang=ko    # Install Korean rules
-npx claude-prism init --lang=ja    # Install Japanese rules
-npx claude-prism init --lang=zh    # Install Chinese rules
-```
-
 ## OMC (oh-my-claudecode) Integration
 
 Prism auto-detects if [oh-my-claudecode](https://github.com/raidenppl/oh-my-claudecode) is installed in your environment. When OMC is present:

package/bin/cli.mjs

@@ -2,7 +2,7 @@
 
 /**
  * claude-prism CLI
- * Usage: prism init [--lang=ko] [--no-hooks]
+ * Usage: prism init [--no-hooks]
  *        prism check [--ci]
  *        prism doctor
  *        prism stats
@@ -16,11 +16,6 @@ import { init, check, uninstall, update, doctor, stats, reset, initGlobal, unins
 const args = process.argv.slice(2);
 const command = args[0];
 
-function getFlag(name) {
-  const flag = args.find(a => a.startsWith(`--${name}=`));
-  return flag ? flag.split('=')[1] : null;
-}
-
 function hasFlag(name) {
   return args.includes(`--${name}`) || args.includes(`-${name}`);
 }
@@ -47,12 +42,11 @@ switch (command) {
       break;
     }
 
-    const language = getFlag('lang') || 'en';
     const hooks = !hasFlag('no-hooks');
 
     if (hasFlag('dry-run')) {
       const { dryRun } = await import('../lib/installer.mjs');
-      const result = dryRun(cwd, { language, hooks });
+      const result = dryRun(cwd, { hooks });
       console.log('🌈 claude-prism init --dry-run\n');
       console.log('  Files that would be created/updated:\n');
       for (const action of result.actions) {
@@ -64,7 +58,7 @@ switch (command) {
     }
 
     console.log('🌈 claude-prism init\n');
-    await init(cwd, { language, hooks });
+    await init(cwd, { hooks });
 
     console.log('✅ Rules injected → CLAUDE.md');
     console.log('✅ Commands installed → /prism, /checkpoint');
@@ -121,7 +115,6 @@ switch (command) {
     const result = stats(cwd);
     console.log('🌈 claude-prism stats\n');
     console.log(`  Version:   v${result.version}`);
-    console.log(`  Language:  ${result.language}`);
     console.log(`  Plans:     ${result.planFiles} file(s)`);
     console.log(`  OMC:       ${result.omc.detected ? `✅ v${result.omc.version || 'unknown'}` : '⏭️  not detected'}`);
     console.log('  Hooks:');
@@ -182,7 +175,7 @@ switch (command) {
     console.log(`🌈 claude-prism — AI coding problem decomposition tool
 
 Usage:
-  prism init [--lang=XX] [--no-hooks]   Install prism in current project
+  prism init [--no-hooks]                Install prism in current project
   prism init --global                    Install globally (~/.claude/) + OMC skill
   prism check [--ci]                     Verify installation
   prism doctor                           Diagnose issues with fix suggestions
@@ -194,7 +187,6 @@ Usage:
   prism uninstall --global               Remove global commands + OMC skill
 
 Options:
-  --lang=XX    Language: en (default), ko, ja, zh
   --no-hooks   Skip enforcement hooks
   --dry-run    Show what init would do without making changes
   --global     Install/uninstall globally (all projects)

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/lib/config.mjs

@@ -7,7 +7,6 @@ import { readFileSync, existsSync } from 'fs';
 import { join } from 'path';
 
 const DEFAULTS = {
-  language: 'en',
   sourceExtensions: ['ts', 'tsx', 'js', 'jsx', 'py', 'go', 'rs', 'java', 'c', 'cpp', 'h', 'svelte', 'vue', 'rb', 'kt', 'swift', 'php', 'cs', 'scala', 'ex', 'clj', 'zig', 'lua', 'dart'],
   testPatterns: ['test', 'spec', '_test'],
   customRules: [],
@@ -39,7 +38,6 @@ export function getHookConfig(hookName, projectRoot) {
   const config = loadConfig(projectRoot);
   const hookConfig = config.hooks?.[hookName] || DEFAULTS.hooks[hookName] || { enabled: true };
   // Include top-level fields needed by hooks
-  hookConfig.language = config.language || DEFAULTS.language;
   hookConfig.sourceExtensions = config.sourceExtensions || DEFAULTS.sourceExtensions;
   hookConfig.testPatterns = config.testPatterns || DEFAULTS.testPatterns;
   return hookConfig;

package/lib/installer.mjs

@@ -16,11 +16,10 @@ const TEMPLATES_DIR = join(__dirname, '..', 'templates');
  * Initialize prism in a project
  * @param {string} projectDir - Project root
  * @param {Object} options
- * @param {string} options.language - 'en' | 'ko'
  * @param {boolean} options.hooks - Install enforcement hooks
  */
 export async function init(projectDir, options = {}) {
-  const { language = 'en', hooks = true } = options;
+  const { hooks = true } = options;
 
   // 1. Create directories
   const claudeDir = join(projectDir, '.claude');
@@ -78,13 +77,12 @@ export async function init(projectDir, options = {}) {
   }
 
   // 4. Inject rules into CLAUDE.md
-  injectRules(projectDir, language);
+  injectRules(projectDir);
 
   // 5. Create .claude-prism.json config
   const configPath = join(projectDir, '.claude-prism.json');
   if (!existsSync(configPath)) {
     writeFileSync(configPath, JSON.stringify({
-      language,
       hooks: {
         'commit-guard': { enabled: true, maxTestAge: 300 },
         'debug-loop': { enabled: true, warnAt: 3, blockAt: 5 },
@@ -216,12 +214,10 @@ export async function update(projectDir) {
   }
 
   const configPath = newConfigPath;
-  let language = 'en';
   let hooks = true;
 
   if (existsSync(configPath)) {
     const config = JSON.parse(readFileSync(configPath, 'utf8'));
-    language = config.language || 'en';
     hooks = config.hooks?.['commit-guard']?.enabled !== false;
   }
 
@@ -241,7 +237,7 @@ export async function update(projectDir) {
   // Remove old config so init creates a fresh one
   if (existsSync(configPath)) rmSync(configPath);
 
-  await init(projectDir, { language, hooks });
+  await init(projectDir, { hooks });
 }
 
 /**
@@ -356,7 +352,7 @@ export function doctor(projectDir, options = {}) {
  * @param {string} projectDir
  * @param {Object} [options]
  * @param {string} [options.homeDir] - Override home dir (for testing)
- * @returns {{ version: string, language: string, hooks: Object, planFiles: number, omc: Object }}
+ * @returns {{ version: string, hooks: Object, planFiles: number, omc: Object }}
  */
 export function stats(projectDir, options = {}) {
   // Read version from package.json
@@ -365,12 +361,10 @@ export function stats(projectDir, options = {}) {
 
   // Read config
   const configPath = join(projectDir, '.claude-prism.json');
-  let language = 'en';
   let hookConfig = {};
 
   if (existsSync(configPath)) {
     const config = JSON.parse(readFileSync(configPath, 'utf8'));
-    language = config.language || 'en';
     if (config.hooks) {
       for (const [name, cfg] of Object.entries(config.hooks)) {
         hookConfig[name] = cfg.enabled !== false;
@@ -390,7 +384,6 @@ export function stats(projectDir, options = {}) {
 
   return {
     version: pkg.version,
-    language,
     hooks: hookConfig,
     planFiles,
     omc
@@ -463,7 +456,7 @@ export function uninstallGlobal(options = {}) {
  * @returns {{ actions: Array<{type: string, path: string, status: string}> }}
  */
 export function dryRun(projectDir, options = {}) {
-  const { language = 'en', hooks = true } = options;
+  const { hooks = true } = options;
   const claudeDir = join(projectDir, '.claude');
   const actions = [];
 
@@ -531,16 +524,10 @@ export function dryRun(projectDir, options = {}) {
 
 // ─── internal helpers ───
 
-function injectRules(projectDir, language) {
+function injectRules(projectDir) {
   const claudeMdPath = join(projectDir, 'CLAUDE.md');
-  const rulesFile = `rules.${language}.md`;
-  let rulesPath = join(TEMPLATES_DIR, rulesFile);
-
-  // Fallback to English if requested language not available
-  if (!existsSync(rulesPath)) {
-    rulesPath = join(TEMPLATES_DIR, 'rules.en.md');
-    if (!existsSync(rulesPath)) return;
-  }
+  const rulesPath = join(TEMPLATES_DIR, 'rules.md');
+  if (!existsSync(rulesPath)) return;
 
   const rules = readFileSync(rulesPath, 'utf8');
 

package/lib/messages.mjs

@@ -1,60 +1,21 @@
 /**
  * claude-prism — Hook Message Templates
- * Provides localized messages for hook output
  */
 
 const MESSAGES = {
-  en: {
-    'commit-guard.block.failed': '🌈 Prism ✋ Commit blocked: last test run FAILED. Fix tests before committing.',
-    'commit-guard.warn.no-test': '🌈 Prism > No test run detected this session. Run tests before committing.',
-    'commit-guard.warn.stale': '🌈 Prism > Last test run was {minutes}min ago. Run tests before committing.',
-    'debug-loop.block.divergent': '🌈 Prism ✋ Debug Loop blocked: {name} edited {count} times on same area. Discuss approach with user before continuing.',
-    'debug-loop.warn.divergent': '🌈 Prism > Debug Loop: {name} edited {count} times on same area. Stop and investigate root cause.',
-    'debug-loop.warn.convergent': '🌈 Prism > Debug Loop: {name} edited {count} times (different areas). Consider if this is expected.',
-    'scope-guard.block': '🌈 Prism ✋ Scope Guard: {count} unique files modified without a plan. Run /prism to decompose before continuing.',
-    'scope-guard.warn': '🌈 Prism > Scope Guard: {count} unique files modified. Consider running /prism to decompose the task.',
-    'scope-guard.plan-detected': '🌈 Prism 📋 Plan file detected. Scope thresholds raised.',
-    'test-tracker.warn.failed': '🌈 Prism 📊 Tests FAILED. Fix before committing.',
-  },
-  ko: {
-    'commit-guard.block.failed': '🌈 Prism ✋ 커밋 차단: 마지막 테스트 실패. 테스트를 수정한 후 커밋하세요.',
-    'commit-guard.warn.no-test': '🌈 Prism > 이 세션에서 테스트 실행 이력이 없습니다. 커밋 전에 테스트를 실행하세요.',
-    'commit-guard.warn.stale': '🌈 Prism > 마지막 테스트가 {minutes}분 전입니다. 커밋 전에 테스트를 실행하세요.',
-    'debug-loop.block.divergent': '🌈 Prism ✋ 디버그 루프 차단: {name}이 같은 영역에서 {count}회 수정됨. 사용자와 접근 방식을 논의하세요.',
-    'debug-loop.warn.divergent': '🌈 Prism > 디버그 루프: {name}이 같은 영역에서 {count}회 수정됨. 멈추고 근본 원인을 조사하세요.',
-    'debug-loop.warn.convergent': '🌈 Prism > 디버그 루프: {name}이 {count}회 수정됨 (다른 영역). 예상된 작업인지 확인하세요.',
-    'scope-guard.block': '🌈 Prism ✋ 스코프 가드: 계획 없이 {count}개 고유 파일 수정됨. /prism으로 분해 후 계속하세요.',
-    'scope-guard.warn': '🌈 Prism > 스코프 가드: {count}개 고유 파일 수정됨. /prism으로 작업을 분해하는 것을 고려하세요.',
-    'scope-guard.plan-detected': '🌈 Prism 📋 계획 파일 감지됨. 스코프 임계값이 상향 조정되었습니다.',
-    'test-tracker.warn.failed': '🌈 Prism 📊 테스트 실패. 커밋 전에 수정하세요.',
-  },
-  ja: {
-    'commit-guard.block.failed': '🌈 Prism ✋ コミットブロック: 最後のテストが失敗しました。テストを修正してからコミットしてください。',
-    'commit-guard.warn.no-test': '🌈 Prism > このセッションでテスト実行が検出されません。コミット前にテストを実行してください。',
-    'commit-guard.warn.stale': '🌈 Prism > 最後のテスト実行は{minutes}分前です。コミット前にテストを実行してください。',
-    'debug-loop.block.divergent': '🌈 Prism ✋ デバッグループブロック: {name}が同じ領域で{count}回編集されました。ユーザーとアプローチを議論してください。',
-    'debug-loop.warn.divergent': '🌈 Prism > デバッグループ: {name}が同じ領域で{count}回編集されました。停止して根本原因を調査してください。',
-    'debug-loop.warn.convergent': '🌈 Prism > デバッグループ: {name}が{count}回編集されました（異なる領域）。想定通りか確認してください。',
-    'scope-guard.block': '🌈 Prism ✋ スコープガード: 計画なしに{count}個のファイルが変更されました。/prismで分解してから続行してください。',
-    'scope-guard.warn': '🌈 Prism > スコープガード: {count}個のファイルが変更されました。/prismでタスクの分解を検討してください。',
-    'scope-guard.plan-detected': '🌈 Prism 📋 計画ファイルを検出。スコープ閾値を引き上げました。',
-    'test-tracker.warn.failed': '🌈 Prism 📊 テスト失敗。コミット前に修正してください。',
-  },
-  zh: {
-    'commit-guard.block.failed': '🌈 Prism ✋ 提交被阻止：上次测试失败。请修复测试后再提交。',
-    'commit-guard.warn.no-test': '🌈 Prism > 本次会话未检测到测试运行。请在提交前运行测试。',
-    'commit-guard.warn.stale': '🌈 Prism > 上次测试运行在{minutes}分钟前。请在提交前运行测试。',
-    'debug-loop.block.divergent': '🌈 Prism ✋ 调试循环阻止：{name}在同一区域被编辑了{count}次。请与用户讨论方法。',
-    'debug-loop.warn.divergent': '🌈 Prism > 调试循环：{name}在同一区域被编辑了{count}次。停止并调查根本原因。',
-    'debug-loop.warn.convergent': '🌈 Prism > 调试循环：{name}被编辑了{count}次（不同区域）。请确认这是否是预期行为。',
-    'scope-guard.block': '🌈 Prism ✋ 范围守卫：未制定计划就修改了{count}个文件。请运行/prism分解后再继续。',
-    'scope-guard.warn': '🌈 Prism > 范围守卫：已修改{count}个文件。请考虑运行/prism来分解任务。',
-    'scope-guard.plan-detected': '🌈 Prism 📋 检测到计划文件。范围阈值已提高。',
-    'test-tracker.warn.failed': '🌈 Prism 📊 测试失败。请在提交前修复。',
-  },
+  'commit-guard.block.failed': '🌈 Prism ✋ Commit blocked: last test run FAILED. Fix tests before committing.',
+  'commit-guard.warn.no-test': '🌈 Prism > No test run detected this session. Run tests before committing.',
+  'commit-guard.warn.stale': '🌈 Prism > Last test run was {minutes}min ago. Run tests before committing.',
+  'debug-loop.block.divergent': '🌈 Prism ✋ Debug Loop blocked: {name} edited {count} times on same area. Discuss approach with user before continuing.',
+  'debug-loop.warn.divergent': '🌈 Prism > Debug Loop: {name} edited {count} times on same area. Stop and investigate root cause.',
+  'debug-loop.warn.convergent': '🌈 Prism > Debug Loop: {name} edited {count} times (different areas). Consider if this is expected.',
+  'scope-guard.block': '🌈 Prism ✋ Scope Guard: {count} unique files modified without a plan. Run /prism to decompose before continuing.',
+  'scope-guard.warn': '🌈 Prism > Scope Guard: {count} unique files modified. Consider running /prism to decompose the task.',
+  'scope-guard.plan-detected': '🌈 Prism 📋 Plan file detected. Scope thresholds raised.',
+  'test-tracker.warn.failed': '🌈 Prism 📊 Tests FAILED. Fix before committing.',
 };
 
-export function getMessage(lang, key, params = {}) {
-  const template = MESSAGES[lang]?.[key] || MESSAGES.en[key] || key;
+export function getMessage(_lang, key, params = {}) {
+  const template = MESSAGES[key] || key;
   return template.replace(/\{(\w+)\}/g, (_, k) => params[k] ?? `{${k}}`);
 }

package/lib/pipeline.mjs

@@ -80,7 +80,6 @@ export function runPipeline(rules, hookEventName) {
   for (const { name, rule } of rules) {
     // Build hook-specific config (same as getHookConfig but without re-reading file)
     const hookConfig = fullConfig.hooks?.[name] || { enabled: true };
-    hookConfig.language = fullConfig.language || 'en';
     hookConfig.sourceExtensions = fullConfig.sourceExtensions;
     hookConfig.testPatterns = fullConfig.testPatterns;
 
@@ -157,7 +156,6 @@ export async function runPipelineAsync(builtInRules, hookEventName) {
 
   for (const { name, rule } of rules) {
     const hookConfig = fullConfig.hooks?.[name] || { enabled: true };
-    hookConfig.language = fullConfig.language || 'en';
     hookConfig.sourceExtensions = fullConfig.sourceExtensions;
     hookConfig.testPatterns = fullConfig.testPatterns;
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-prism",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "AI coding problem decomposition tool — Understand, Decompose, Execute, Checkpoint.",
   "type": "module",
   "bin": {
@@ -33,8 +33,7 @@
     "lib/",
     "hooks/",
     "templates/",
-    "README.md",
-    "README.ko.md"
+    "README.md"
   ],
   "repository": {
     "type": "git",

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