takt 0.1.7 → 0.2.1

package/dist/workflow/instruction-builder.js

@@ -4,7 +4,65 @@
  * Builds the instruction string for agent execution by replacing
  * template placeholders with actual values.
  */
+import { join } from 'node:path';
 import { getGitDiff } from '../agents/runner.js';
+/**
+ * Build execution metadata from instruction context.
+ *
+ * Pure function: InstructionContext → ExecutionMetadata.
+ * Sets `projectRoot` only when cwd differs from projectCwd (worktree mode).
+ */
+export function buildExecutionMetadata(context) {
+    const projectRoot = context.projectCwd ?? context.cwd;
+    const isWorktree = context.cwd !== projectRoot;
+    return {
+        workingDirectory: context.cwd,
+        ...(isWorktree ? { projectRoot } : {}),
+        language: context.language ?? 'en',
+    };
+}
+/** Localized strings for execution metadata rendering */
+const METADATA_STRINGS = {
+    en: {
+        heading: '## Execution Context',
+        workingDirectory: 'Working Directory',
+        projectRoot: 'Project Root',
+        mode: 'Mode: worktree (source edits in Working Directory, reports in Project Root)',
+        note: 'Note: This section is metadata. Follow the language used in the rest of the prompt.',
+    },
+    ja: {
+        heading: '## 実行コンテキスト',
+        workingDirectory: '作業ディレクトリ',
+        projectRoot: 'プロジェクトルート',
+        mode: 'モード: worktree（ソース編集は作業ディレクトリ、レポートはプロジェクトルート）',
+        note: '',
+    },
+};
+/**
+ * Render execution metadata as a markdown string.
+ *
+ * Pure function: ExecutionMetadata → string.
+ * Always includes heading + Working Directory.
+ * Adds Project Root and Mode only in worktree mode (when projectRoot is present).
+ * Language determines the output language; 'en' includes a note about language consistency.
+ */
+export function renderExecutionMetadata(metadata) {
+    const strings = METADATA_STRINGS[metadata.language];
+    const lines = [
+        strings.heading,
+        `- ${strings.workingDirectory}: ${metadata.workingDirectory}`,
+    ];
+    if (metadata.projectRoot !== undefined) {
+        lines.push(`- ${strings.projectRoot}: ${metadata.projectRoot}`);
+        lines.push(`- ${strings.mode}`);
+    }
+    if (strings.note) {
+        lines.push('');
+        lines.push(strings.note);
+    }
+    lines.push('');
+    return lines.join('\n');
+}
 /**
  * Escape special characters in dynamic content to prevent template injection.
  */
@@ -47,14 +105,24 @@ export function buildInstruction(step, context) {
     // Replace {user_inputs}
     const userInputsStr = context.userInputs.join('\n');
     instruction = instruction.replace(/\{user_inputs\}/g, escapeTemplateChars(userInputsStr));
-    // Replace {report_dir}
+    // Replace .takt/reports/{report_dir} with absolute path first,
+    // then replace standalone {report_dir} with the directory name.
+    // This ensures agents always use the correct project root for reports,
+    // even when their cwd is a worktree.
     if (context.reportDir) {
+        const projectRoot = context.projectCwd ?? context.cwd;
+        const reportDirFullPath = join(projectRoot, '.takt', 'reports', context.reportDir);
+        instruction = instruction.replace(/\.takt\/reports\/\{report_dir\}/g, reportDirFullPath);
         instruction = instruction.replace(/\{report_dir\}/g, context.reportDir);
     }
     // Append status_rules_prompt if present
     if (step.statusRulesPrompt) {
         instruction = `${instruction}\n\n${step.statusRulesPrompt}`;
     }
+    // Prepend execution context metadata so agents see it first.
+    // Now language-aware, so no need to hide it at the end.
+    const metadata = buildExecutionMetadata(context);
+    instruction = `${renderExecutionMetadata(metadata)}\n${instruction}`;
     return instruction;
 }
 //# sourceMappingURL=instruction-builder.js.map

package/dist/workflow/instruction-builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"instruction-builder.js","sourceRoot":"","sources":["../../src/workflow/instruction-builder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAwBjD;;GAEG;AACH,SAAS,mBAAmB,CAAC,GAAW;IACtC,OAAO,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AACrD,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,gBAAgB,CAC9B,IAAkB,EAClB,OAA2B;IAE3B,IAAI,WAAW,GAAG,IAAI,CAAC,mBAAmB,CAAC;IAE3C,iBAAiB;IACjB,WAAW,GAAG,WAAW,CAAC,OAAO,CAAC,WAAW,EAAE,mBAAmB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IAElF,8DAA8D;IAC9D,WAAW,GAAG,WAAW,CAAC,OAAO,CAAC,gBAAgB,EAAE,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;IAC/E,WAAW,GAAG,WAAW,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC;IACxF,WAAW,GAAG,WAAW,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC;IAExF,8BAA8B;IAC9B,IAAI,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAC9B,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;YAC3B,WAAW,GAAG,WAAW,CAAC,OAAO,CAC/B,wBAAwB,EACxB,mBAAmB,CAAC,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CACpD,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,WAAW,GAAG,WAAW,CAAC,OAAO,CAAC,wBAAwB,EAAE,EAAE,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;IAED,qBAAqB;IACrB,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACxC,WAAW,GAAG,WAAW,CAAC,OAAO,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;IAE5D,wBAAwB;IACxB,MAAM,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpD,WAAW,GAAG,WAAW,CAAC,OAAO,CAC/B,kBAAkB,EAClB,mBAAmB,CAAC,aAAa,CAAC,CACnC,CAAC;IAEF,uBAAuB;IACvB,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACtB,WAAW,GAAG,WAAW,CAAC,OAAO,CAAC,iBAAiB,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IAC1E,CAAC;IAED,wCAAwC;IACxC,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAC3B,WAAW,GAAG,GAAG,WAAW,OAAO,IAAI,CAAC,iBAAiB,EAAE,CAAC;IAC9D,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC"}
+{"version":3,"file":"instruction-builder.js","sourceRoot":"","sources":["../../src/workflow/instruction-builder.ts"],"names":[],"mappings":"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"}

package/dist/workflow/transitions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transitions.d.ts","sourceRoot":"","sources":["../../src/workflow/transitions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,YAAY,EACZ,MAAM,EACN,mBAAmB,EACpB,MAAM,oBAAoB,CAAC;AAG5B;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,mBAAmB,GAC7B,OAAO,CAoBT;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,YAAY,EAClB,MAAM,EAAE,cAAc,GACrB,MAAM,CAkCR;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,YAAY,EAClB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,cAAc,GACrB,MAAM,CAoBR;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAkB5D"}
+{"version":3,"file":"transitions.d.ts","sourceRoot":"","sources":["../../src/workflow/transitions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,YAAY,EACZ,MAAM,EACN,mBAAmB,EACpB,MAAM,oBAAoB,CAAC;AAG5B;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,mBAAmB,GAC7B,OAAO,CAqBT;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,YAAY,EAClB,MAAM,EAAE,cAAc,GACrB,MAAM,CAkCR;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,YAAY,EAClB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,cAAc,GACrB,MAAM,CAoBR;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAkB5D"}

package/dist/workflow/transitions.js

@@ -19,6 +19,7 @@ export function matchesCondition(status, condition) {
         approved: ['approved'],
         rejected: ['rejected'],
         improve: ['improve'],
+        answer: ['answer'],
         pending: [],
         in_progress: [],
         cancelled: [],

package/dist/workflow/transitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"transitions.js","sourceRoot":"","sources":["../../src/workflow/transitions.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"transitions.js","sourceRoot":"","sources":["../../src/workflow/transitions.ts"],"names":[],"mappings":"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"}

package/dist/workflow/types.d.ts

@@ -4,7 +4,7 @@
  * Contains types for workflow events, requests, and callbacks
  * used by the workflow execution engine.
  */
-import type { WorkflowStep, AgentResponse, WorkflowState } from '../models/types.js';
+import type { WorkflowStep, AgentResponse, WorkflowState, Language } from '../models/types.js';
 import type { StreamCallback } from '../agents/runner.js';
 import type { PermissionHandler, AskUserQuestionHandler } from '../claude/process.js';
 /** Events emitted by workflow engine */
@@ -63,6 +63,10 @@ export interface WorkflowEngineOptions {
     onIterationLimit?: IterationLimitCallback;
     /** Bypass all permission checks (sacrifice-my-pc mode) */
     bypassPermissions?: boolean;
+    /** Project root directory (where .takt/ lives). Defaults to cwd if not specified. */
+    projectCwd?: string;
+    /** Language for instruction metadata. Defaults to 'en'. */
+    language?: Language;
 }
 /** Loop detection result */
 export interface LoopCheckResult {

package/dist/workflow/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/workflow/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACrF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAEtF,wCAAwC;AACxC,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,CAAC,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9D,eAAe,EAAE,CAAC,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,aAAa,KAAK,IAAI,CAAC;IACvE,cAAc,EAAE,CAAC,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,aAAa,KAAK,IAAI,CAAC;IACtE,iBAAiB,EAAE,CAAC,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IACnE,mBAAmB,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IACpD,gBAAgB,EAAE,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACjE,iBAAiB,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,KAAK,IAAI,CAAC;IACtE,oBAAoB,EAAE,CAAC,IAAI,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9E;AAED,2CAA2C;AAC3C,MAAM,WAAW,gBAAgB;IAC/B,+BAA+B;IAC/B,IAAI,EAAE,YAAY,CAAC;IACnB,0CAA0C;IAC1C,QAAQ,EAAE,aAAa,CAAC;IACxB,2DAA2D;IAC3D,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,8BAA8B;AAC9B,MAAM,WAAW,qBAAqB;IACpC,8BAA8B;IAC9B,gBAAgB,EAAE,MAAM,CAAC;IACzB,6BAA6B;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,wBAAwB;IACxB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,mEAAmE;AACnE,MAAM,MAAM,qBAAqB,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;AAEnF;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,EAAE,qBAAqB,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;AAEhG,kCAAkC;AAClC,MAAM,WAAW,qBAAqB;IACpC,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,kEAAkE;IAClE,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACpE,mEAAmE;IACnE,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,gDAAgD;IAChD,eAAe,CAAC,EAAE,qBAAqB,CAAC;IACxC,mEAAmE;IACnE,mBAAmB,CAAC,EAAE,iBAAiB,CAAC;IACxC,mDAAmD;IACnD,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,8CAA8C;IAC9C,iBAAiB,CAAC,EAAE,sBAAsB,CAAC;IAC3C,+FAA+F;IAC/F,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;IAC1C,0DAA0D;IAC1D,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,4BAA4B;AAC5B,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/workflow/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "takt",
-  "version": "0.1.7",
+  "version": "0.2.1",
   "description": "TAKT: Task Agent Koordination Tool - AI Agent Workflow Orchestration",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -15,7 +15,8 @@
     "test": "vitest run",
     "test:watch": "vitest",
     "lint": "eslint src/",
-    "prepublishOnly": "npm run lint && npm run build && npm run test"
+    "prepublishOnly": "npm run lint && npm run build && npm run test",
+    "postversion": "git push --follow-tags"
   },
   "keywords": [
     "claude",

package/resources/global/en/workflows/default.yaml

@@ -39,6 +39,7 @@ steps:
       | Situation | Judgment |
       |-----------|----------|
       | Requirements clear and implementable | DONE |
+      | User is asking a question (not an implementation task) | ANSWER |
       | Requirements unclear, insufficient info | BLOCKED |
 
       ## Output Format
@@ -46,6 +47,7 @@ steps:
       | Situation | Tag |
       |-----------|-----|
       | Analysis complete | `[PLANNER:DONE]` |
+      | Question answered | `[PLANNER:ANSWER]` |
       | Insufficient info | `[PLANNER:BLOCKED]` |
 
       ### Output Examples
@@ -55,6 +57,13 @@ steps:
       [PLANNER:DONE]
       ```
 
+      **ANSWER case:**
+      ```
+      {Answer to the question}
+
+      [PLANNER:ANSWER]
+      ```
+
       **BLOCKED case:**
       ```
       [PLANNER:BLOCKED]
@@ -80,10 +89,15 @@ steps:
       ## Instructions
       Analyze the task and create an implementation plan.
 
+      **Judgment criteria:**
+      - If the user input is an implementation task → create a plan and output `[PLANNER:DONE]`
+      - If the user input is a question → research, answer, and output `[PLANNER:ANSWER]`
+      - If there is insufficient information → output `[PLANNER:BLOCKED]`
+
       **Note:** If returned from implement step (Previous Response exists),
       review and revise the plan based on that feedback (replan).
 
-      **Tasks:**
+      **Tasks (for implementation tasks):**
       1. Understand the requirements
       2. Identify impact scope
       3. Decide implementation approach
@@ -117,6 +131,8 @@ steps:
     transitions:
       - condition: done
         next_step: implement
+      - condition: answer
+        next_step: COMPLETE
       - condition: blocked
         next_step: ABORT
 
@@ -131,6 +147,7 @@ steps:
       - Bash
       - WebSearch
       - WebFetch
+    permission_mode: acceptEdits
     status_rules_prompt: |
       # ⚠️ REQUIRED: Status Output Rules ⚠️
 
@@ -360,6 +377,7 @@ steps:
       - Bash
       - WebSearch
       - WebFetch
+    permission_mode: acceptEdits
     status_rules_prompt: |
       # ⚠️ REQUIRED: Status Output Rules ⚠️
 
@@ -545,6 +563,7 @@ steps:
       - Bash
       - WebSearch
       - WebFetch
+    permission_mode: acceptEdits
     status_rules_prompt: |
       # ⚠️ REQUIRED: Status Output Rules ⚠️
 
@@ -727,6 +746,7 @@ steps:
       - Bash
       - WebSearch
       - WebFetch
+    permission_mode: acceptEdits
     status_rules_prompt: |
       # ⚠️ REQUIRED: Status Output Rules ⚠️
 
@@ -796,6 +816,7 @@ steps:
       - Bash
       - WebSearch
       - WebFetch
+    permission_mode: acceptEdits
     status_rules_prompt: |
       # ⚠️ REQUIRED: Status Output Rules ⚠️
 

package/resources/global/en/workflows/simple.yaml

@@ -40,6 +40,7 @@ steps:
       | Situation | Judgment |
       |-----------|----------|
       | Requirements clear and implementable | DONE |
+      | User is asking a question (not an implementation task) | ANSWER |
       | Requirements unclear, insufficient info | BLOCKED |
 
       ## Output Format
@@ -47,6 +48,7 @@ steps:
       | Situation | Tag |
       |-----------|-----|
       | Analysis complete | `[PLANNER:DONE]` |
+      | Question answered | `[PLANNER:ANSWER]` |
       | Insufficient info | `[PLANNER:BLOCKED]` |
 
       ### Output Examples
@@ -56,6 +58,13 @@ steps:
       [PLANNER:DONE]
       ```
 
+      **ANSWER case:**
+      ```
+      {Answer to the question}
+
+      [PLANNER:ANSWER]
+      ```
+
       **BLOCKED case:**
       ```
       [PLANNER:BLOCKED]
@@ -81,10 +90,15 @@ steps:
       ## Instructions
       Analyze the task and create an implementation plan.
 
+      **Judgment criteria:**
+      - If the user input is an implementation task → create a plan and output `[PLANNER:DONE]`
+      - If the user input is a question → research, answer, and output `[PLANNER:ANSWER]`
+      - If there is insufficient information → output `[PLANNER:BLOCKED]`
+
       **Note:** If returned from implement step (Previous Response exists),
       review and revise the plan based on that feedback (replan).
 
-      **Tasks:**
+      **Tasks (for implementation tasks):**
       1. Understand the requirements
       2. Identify impact scope
       3. Decide implementation approach
@@ -118,6 +132,8 @@ steps:
     transitions:
       - condition: done
         next_step: implement
+      - condition: answer
+        next_step: COMPLETE
       - condition: blocked
         next_step: ABORT
 
@@ -132,6 +148,7 @@ steps:
       - Bash
       - WebSearch
       - WebFetch
+    permission_mode: acceptEdits
     status_rules_prompt: |
       # ⚠️ REQUIRED: Status Output Rules ⚠️
 

package/resources/global/ja/agents/default/ai-reviewer.md

@@ -51,11 +51,15 @@ AI生成コードには特有の特徴があります:
 | 古いパターン | 学習データからの非推奨アプローチの使用 |
 | 過剰エンジニアリング | タスクに不要な抽象化レイヤーの追加 |
 | 過小エンジニアリング | 現実的なシナリオのエラーハンドリングの欠如 |
+| 配線忘れ | 機構は実装されているが、エントリポイントから渡されていない |
 
 **検証アプローチ:**
 1. このコードは実際にコンパイル/実行できるか？
 2. インポートされたモジュール/関数は存在するか？
 3. このライブラリバージョンでAPIは正しく使用されているか？
+4. 新しいパラメータ/フィールドが追加された場合、呼び出し元から実際に渡されているか？
+   - AIは個々のファイル内では正しく実装するが、ファイル横断の結合を忘れがち
+   - `options.xxx ?? fallback` で常にフォールバックが使われていないか grep で確認
 
 ### 3. コピペパターン検出
 
@@ -96,7 +100,26 @@ AI生成コードには特有の特徴があります:
 
 **原則:** 最良のコードは、問題を解決する最小限のコード。
 
-### 6. 決定トレーサビリティレビュー
+### 6. デッドコード検出
+
+**AIは新しいコードを追加するが、不要になったコードの削除を忘れることが多い。**
+
+| パターン | 例 |
+|---------|-----|
+| 未使用の関数・メソッド | リファクタリング後に残った旧実装 |
+| 未使用の変数・定数 | 条件変更で不要になった定義 |
+| 到達不能コード | 早期returnの後に残った処理、常に真/偽になる条件分岐 |
+| 未使用のインポート・依存 | 削除された機能のimport文やパッケージ依存 |
+| 孤立したエクスポート・公開API | 実体が消えたのにre-exportやindex登録が残っている |
+| 未使用のインターフェース・型定義 | 実装側が変更されたのに残った古い型 |
+| 無効化されたコード | コメントアウトされたまま放置されたコード |
+
+**検証アプローチ:**
+1. 変更・削除されたコードを参照している箇所がないか grep で確認
+2. 公開モジュール（index ファイル等）のエクスポート一覧と実体が一致しているか確認
+3. 新規追加されたコードに対応する古いコードが残っていないか確認
+
+### 7. 決定トレーサビリティレビュー
 
 **Coderの決定ログが妥当か検証する。**
 

package/resources/global/ja/agents/default/architect.md

@@ -264,7 +264,160 @@ function createUser(data: UserData) {
 
 **これらを見つけたら必ず指摘する。** 一時的な対応でも本番に残る。
 
-### 8. 品質特性
+### 7.5. TODOコメントの厳格な禁止
+
+**「将来やる」は決してやらない。今やらないことは永遠にやらない。**
+
+**原則: TODOコメントは即REJECT**
+
+```kotlin
+// ❌ REJECT - 将来を見越したTODO
+// TODO: 施設IDによる認可チェックを追加
+fun deleteCustomHoliday(@PathVariable id: String) {
+    deleteCustomHolidayInputPort.execute(input)
+}
+
+// ✅ APPROVE - 今実装する
+fun deleteCustomHoliday(@PathVariable id: String) {
+    val currentUserFacilityId = getCurrentUserFacilityId()
+    val holiday = findHolidayById(id)
+    require(holiday.facilityId == currentUserFacilityId) {
+        "Cannot delete holiday from another facility"
+    }
+    deleteCustomHolidayInputPort.execute(input)
+}
+```
+
+**TODOが許容される唯一のケース:**
+
+| 条件 | 例 | 判定 |
+|------|-----|------|
+| 外部依存で今は実装不可 + Issue化済み | `// TODO(#123): APIキー取得後に実装` | 許容 |
+| 技術的制約で回避不可 + Issue化済み | `// TODO(#456): ライブラリバグ修正待ち` | 許容 |
+| 「将来実装」「後で追加」 | `// TODO: バリデーション追加` | **REJECT** |
+| 「時間がないので」 | `// TODO: リファクタリング` | **REJECT** |
+
+**判断基準:**
+1. **今実装できるか？** → できるなら今やる。TODOは禁止
+2. **外部要因で不可能か？** → Issue化して番号をコメントに記載。それ以外は禁止
+3. **「後でやる」か？** → それは「やらない」と同義。今やるかコードから削除
+
+**なぜTODOは悪か:**
+- 時間が経つと文脈が失われる
+- 誰も気づかなくなる
+- セキュリティホールや技術的負債として残る
+- Issue管理と二重管理になる
+
+**正しい対処:**
+- 今必要 → 今実装する
+- 今不要 → コードを削除する
+- 外部要因で不可 → Issue化してチケット番号をコメントに入れる
+
+### 7.6. DRY原則の即時適用
+
+**「後でまとめる」は決して実現しない。重複は見つけた瞬間に抽出する。**
+
+**原則: 3回以上の重複を見つけたら即REJECT**
+
+```typescript
+// ❌ REJECT - 3箇所で同じバリデーション
+function createOrder(data: OrderData) {
+    if (!data.customerId) throw new Error('Customer ID required')
+    if (!data.items || data.items.length === 0) throw new Error('Items required')
+    // ...
+}
+
+function updateOrder(id: string, data: OrderData) {
+    if (!data.customerId) throw new Error('Customer ID required')
+    if (!data.items || data.items.length === 0) throw new Error('Items required')
+    // ...
+}
+
+function validateOrder(data: OrderData) {
+    if (!data.customerId) throw new Error('Customer ID required')
+    if (!data.items || data.items.length === 0) throw new Error('Items required')
+    // ...
+}
+
+// ✅ APPROVE - 共通化
+function validateOrderData(data: OrderData) {
+    if (!data.customerId) throw new Error('Customer ID required')
+    if (!data.items || data.items.length === 0) throw new Error('Items required')
+}
+
+function createOrder(data: OrderData) {
+    validateOrderData(data)
+    // ...
+}
+```
+
+**DRY違反の検出:**
+
+| パターン | 判定 |
+|---------|------|
+| 同じロジックが3箇所以上 | **即REJECT** - 関数/メソッドに抽出 |
+| 同じバリデーションが2箇所以上 | **即REJECT** - バリデーター関数に抽出 |
+| 似たようなコンポーネントが3個以上 | **即REJECT** - 共通コンポーネント化 |
+| コピペで派生したコード | **即REJECT** - パラメータ化または抽象化 |
+
+**「後でまとめる」が実現しない理由:**
+1. **気づけない** - 新しいコードを書く人は既存の重複に気づかない
+2. **忘れる** - 「次のタスクでまとめよう」は忘れられる
+3. **コストが増す** - 後から抽出するより今抽出する方が簡単
+4. **バグが増殖** - 重複コードはバグ修正時に修正漏れを生む
+
+**正しい対処:**
+- 2回目の重複を書く時点で「3回目が来る」と予測し、抽出を検討
+- 3回目の重複を見つけたら即座に抽出
+- 「似ているが微妙に違う」場合はパラメータ化を検討
+
+**例外: 抽象化が早すぎる場合**
+
+| 状況 | 対応 |
+|------|------|
+| 2回しか使われていない | 様子見（3回目で抽出） |
+| 偶然似ているだけ | 抽象化しない |
+| ドメインが異なる | 別々に保つ（AHA原則） |
+
+**AHA原則（Avoid Hasty Abstractions）とのバランス:**
+- 2回の重複 → 様子見
+- 3回の重複 → 即抽出
+- ドメインが異なる重複 → 抽象化しない（例: 顧客用バリデーションと管理者用バリデーションは別物）
+
+### 8. 呼び出しチェーン検証
+
+**新しいパラメータ・フィールドが追加された場合、変更ファイル内だけでなく呼び出し元も検証する。**
+
+**検証手順:**
+1. 新しいオプショナルパラメータや interface フィールドを見つけたら、`Grep` で全呼び出し元を検索
+2. 全呼び出し元が新しいパラメータを渡しているか確認
+3. フォールバック値（`?? default`）がある場合、フォールバックが使われるケースが意図通りか確認
+
+**危険パターン:**
+
+| パターン | 問題 | 検出方法 |
+|---------|------|---------|
+| `options.xxx ?? fallback` で全呼び出し元が `xxx` を省略 | 機能が実装されているのに常にフォールバック | grep で呼び出し元を確認 |
+| テストがモックで直接値をセット | 実際の呼び出しチェーンを経由しない | テストの構築方法を確認 |
+| `executeXxx()` が内部で使う `options` を引数で受け取らない | 上位から値を渡す口がない | 関数シグネチャを確認 |
+
+**具体例:**
+
+```typescript
+// ❌ 配線漏れ: projectCwd を受け取る口がない
+export async function executeWorkflow(config, cwd, task) {
+  const engine = new WorkflowEngine(config, cwd, task);  // options なし
+}
+
+// ✅ 配線済み: projectCwd を渡せる
+export async function executeWorkflow(config, cwd, task, options?) {
+  const engine = new WorkflowEngine(config, cwd, task, options);
+}
+```
+
+**このパターンを見つけたら REJECT。** 個々のファイルが正しくても、結合されていなければ機能しない。
+
+### 9. 品質特性
 
 | 特性 | 確認観点 |
 |------|---------|
@@ -272,7 +425,7 @@ function createUser(data: UserData) {
 | Maintainability | 変更・修正が容易か |
 | Observability | ログ・監視が可能な設計か |
 
-### 9. 大局観
+### 10. 大局観
 
 **注意**: 細かい「クリーンコード」の指摘に終始しない。
 
@@ -283,7 +436,7 @@ function createUser(data: UserData) {
 - ビジネス要件と整合しているか
 - 命名がドメインと一貫しているか
 
-### 10. 変更スコープの評価
+### 11. 変更スコープの評価
 
 **変更スコープを確認し、レポートに記載する（ブロッキングではない）。**
 
@@ -302,7 +455,7 @@ function createUser(data: UserData) {
 **提案として記載すること（ブロッキングではない）:**
 - 分割可能な場合は分割案を提示
 
-### 11. 堂々巡りの検出
+### 12. 堂々巡りの検出
 
 レビュー回数が渡される場合（例: 「レビュー回数: 3回目」）、回数に応じて判断を変える。
 

package/resources/global/ja/agents/default/coder.md

@@ -90,6 +90,7 @@
 | 構文エラー | ビルド・コンパイル |
 | テスト | テスト実行 |
 | 要求充足 | 元のタスク要求と照合 |
+| デッドコード | 変更・削除した機能を参照する未使用コードが残っていないか確認（未使用の関数、変数、インポート、エクスポート、型定義、到達不能コード） |
 
 **すべて確認してから `[DONE]` を出力。**