takt 0.1.4 → 0.1.5

package/resources/global/en/workflows/expert-review.yaml

@@ -9,6 +9,16 @@
 # Fix destination is determined by Coder based on change impact:
 # - fix_security: MINOR→security_review, MAJOR→cqrs_es_review
 # - fix_qa: MINOR→qa_review, SECURITY→security_review, MAJOR→cqrs_es_review
+#
+# Template Variables:
+#   {iteration}      - Workflow-wide turn count (total steps executed across all agents)
+#   {max_iterations} - Maximum iterations allowed for the workflow
+#   {step_iteration} - Per-step iteration count (how many times THIS step has been executed)
+#   {task}           - Original user request
+#   {previous_response} - Output from the previous step
+#   {git_diff}       - Current uncommitted changes (git diff)
+#   {user_inputs}    - Accumulated user inputs during workflow
+#   {report_dir}     - Report directory name (e.g., "20250126-143052-task-summary")
 
 name: expert-review
 description: CQRS+ES, Frontend, Security, QA Expert Review
@@ -44,7 +54,8 @@ steps:
       | Requirements unclear | `[PLANNER:BLOCKED]` |
     instruction_template: |
       ## Workflow Context
-      - Iteration: {iteration}/{max_iterations}
+      - Iteration: {iteration}/{max_iterations} (workflow-wide)
+      - Step Iteration: {step_iteration} (times this step has run)
       - Step: plan (Task Analysis)
       - Report Directory: .takt/reports/{report_dir}/
       - Report File: .takt/reports/{report_dir}/00-plan.md
@@ -68,7 +79,7 @@ steps:
 
       **Report output:** Output to the `Report File` specified above.
       - If file does not exist: Create new file
-      - If file exists: Append with `## Iteration {iteration}` section
+      - If file exists: Append with `## Iteration {step_iteration}` section
 
       **Report format:**
       ```markdown
@@ -129,7 +140,8 @@ steps:
       | Cannot proceed | `[CODER:BLOCKED]` |
     instruction_template: |
       ## Workflow Context
-      - Iteration: {iteration}/{max_iterations}
+      - Iteration: {iteration}/{max_iterations} (workflow-wide)
+      - Step Iteration: {step_iteration} (times this step has run)
       - Step: implement
       - Report Directory: .takt/reports/{report_dir}/
       - Report Files:
@@ -148,7 +160,7 @@ steps:
 
       **Report output:** Output to the `Report Files` specified above.
       - If file does not exist: Create new file
-      - If file exists: Append with `## Iteration {iteration}` section
+      - If file exists: Append with `## Iteration {step_iteration}` section
 
       **Scope report format (create at implementation start):**
       ```markdown
@@ -213,7 +225,8 @@ steps:
       | Design issues found | `[CQRS-ES:REJECT]` |
     instruction_template: |
       ## Workflow Context
-      - Iteration: {iteration}/{max_iterations}
+      - Iteration: {iteration}/{max_iterations} (workflow-wide)
+      - Step Iteration: {step_iteration} (times this step has run)
       - Step: cqrs_es_review (CQRS+ES Expert Review)
       - Report Directory: .takt/reports/{report_dir}/
       - Report File: .takt/reports/{report_dir}/03-cqrs-es-review.md
@@ -242,7 +255,7 @@ steps:
 
       **Report output:** Output to the `Report File` specified above.
       - If file does not exist: Create new file
-      - If file exists: Append with `## Iteration {iteration}` section
+      - If file exists: Append with `## Iteration {step_iteration}` section
 
       **Report format:**
       ```markdown
@@ -302,7 +315,8 @@ steps:
       | Cannot proceed | `[CODER:BLOCKED]` |
     instruction_template: |
       ## Workflow Context
-      - Iteration: {iteration}/{max_iterations}
+      - Iteration: {iteration}/{max_iterations} (workflow-wide)
+      - Step Iteration: {step_iteration} (times this step has run)
       - Step: fix_cqrs_es
 
       ## CQRS+ES Review Feedback (This is the latest instruction - prioritize this)
@@ -358,7 +372,8 @@ steps:
       | Design issues found | `[FRONTEND:REJECT]` |
     instruction_template: |
       ## Workflow Context
-      - Iteration: {iteration}/{max_iterations}
+      - Iteration: {iteration}/{max_iterations} (workflow-wide)
+      - Step Iteration: {step_iteration} (times this step has run)
       - Step: frontend_review (Frontend Expert Review)
       - Report Directory: .takt/reports/{report_dir}/
       - Report File: .takt/reports/{report_dir}/04-frontend-review.md
@@ -387,7 +402,7 @@ steps:
 
       **Report output:** Output to the `Report File` specified above.
       - If file does not exist: Create new file
-      - If file exists: Append with `## Iteration {iteration}` section
+      - If file exists: Append with `## Iteration {step_iteration}` section
 
       **Report format:**
       ```markdown
@@ -447,7 +462,8 @@ steps:
       | Cannot proceed | `[CODER:BLOCKED]` |
     instruction_template: |
       ## Workflow Context
-      - Iteration: {iteration}/{max_iterations}
+      - Iteration: {iteration}/{max_iterations} (workflow-wide)
+      - Step Iteration: {step_iteration} (times this step has run)
       - Step: fix_frontend
 
       ## Frontend Review Feedback (This is the latest instruction - prioritize this)
@@ -503,7 +519,8 @@ steps:
       | Issues found | `[AI_REVIEW:REJECT]` |
     instruction_template: |
       ## Workflow Context
-      - Iteration: {iteration}/{max_iterations}
+      - Iteration: {iteration}/{max_iterations} (workflow-wide)
+      - Step Iteration: {step_iteration} (times this step has run)
       - Step: ai_review (AI-Generated Code Review)
       - Report Directory: .takt/reports/{report_dir}/
       - Report File: .takt/reports/{report_dir}/05-ai-review.md
@@ -525,7 +542,7 @@ steps:
 
       **Report output:** Output to the `Report File` specified above.
       - If file does not exist: Create new file
-      - If file exists: Append with `## Iteration {iteration}` section
+      - If file exists: Append with `## Iteration {step_iteration}` section
 
       **Report format:**
       ```markdown
@@ -588,7 +605,8 @@ steps:
       | Cannot proceed | `[CODER:BLOCKED]` |
     instruction_template: |
       ## Workflow Context
-      - Iteration: {iteration}/{max_iterations}
+      - Iteration: {iteration}/{max_iterations} (workflow-wide)
+      - Step Iteration: {step_iteration} (times this step has run)
       - Step: ai_fix
 
       ## AI Review Feedback (This is the latest instruction - prioritize this)
@@ -642,7 +660,8 @@ steps:
       | Vulnerabilities found | `[SECURITY:REJECT]` |
     instruction_template: |
       ## Workflow Context
-      - Iteration: {iteration}/{max_iterations}
+      - Iteration: {iteration}/{max_iterations} (workflow-wide)
+      - Step Iteration: {step_iteration} (times this step has run)
       - Step: security_review (Security Expert Review)
       - Report Directory: .takt/reports/{report_dir}/
       - Report File: .takt/reports/{report_dir}/06-security-review.md
@@ -667,7 +686,7 @@ steps:
 
       **Report output:** Output to the `Report File` specified above.
       - If file does not exist: Create new file
-      - If file exists: Append with `## Iteration {iteration}` section
+      - If file exists: Append with `## Iteration {step_iteration}` section
 
       **Report format:**
       ```markdown
@@ -729,7 +748,8 @@ steps:
       | Cannot proceed | `[CODER:BLOCKED]` |
     instruction_template: |
       ## Workflow Context
-      - Iteration: {iteration}/{max_iterations}
+      - Iteration: {iteration}/{max_iterations} (workflow-wide)
+      - Step Iteration: {step_iteration} (times this step has run)
       - Step: fix_security
 
       ## Security Review Feedback (This is the latest instruction - prioritize this)
@@ -794,7 +814,8 @@ steps:
       | Quality issues found | `[QA:REJECT]` |
     instruction_template: |
       ## Workflow Context
-      - Iteration: {iteration}/{max_iterations}
+      - Iteration: {iteration}/{max_iterations} (workflow-wide)
+      - Step Iteration: {step_iteration} (times this step has run)
       - Step: qa_review (QA Expert Review)
       - Report Directory: .takt/reports/{report_dir}/
       - Report File: .takt/reports/{report_dir}/07-qa-review.md
@@ -820,7 +841,7 @@ steps:
 
       **Report output:** Output to the `Report File` specified above.
       - If file does not exist: Create new file
-      - If file exists: Append with `## Iteration {iteration}` section
+      - If file exists: Append with `## Iteration {step_iteration}` section
 
       **Report format:**
       ```markdown
@@ -882,7 +903,8 @@ steps:
       | Cannot proceed | `[CODER:BLOCKED]` |
     instruction_template: |
       ## Workflow Context
-      - Iteration: {iteration}/{max_iterations}
+      - Iteration: {iteration}/{max_iterations} (workflow-wide)
+      - Step Iteration: {step_iteration} (times this step has run)
       - Step: fix_qa
 
       ## QA Review Feedback (This is the latest instruction - prioritize this)
@@ -951,7 +973,8 @@ steps:
       | Issues found | `[SUPERVISOR:REJECT]` |
     instruction_template: |
       ## Workflow Context
-      - Iteration: {iteration}/{max_iterations}
+      - Iteration: {iteration}/{max_iterations} (workflow-wide)
+      - Step Iteration: {step_iteration} (times this step has run)
       - Step: supervise (Final Review)
       - Report Directory: .takt/reports/{report_dir}/
       - Report Files:
@@ -987,7 +1010,7 @@ steps:
 
       **Report output:** Output to the `Report Files` specified above.
       - If file does not exist: Create new file
-      - If file exists: Append with `## Iteration {iteration}` section
+      - If file exists: Append with `## Iteration {step_iteration}` section
 
       **Validation report format:**
       ```markdown
@@ -1079,7 +1102,8 @@ steps:
       | Cannot proceed | `[CODER:BLOCKED]` |
     instruction_template: |
       ## Workflow Context
-      - Iteration: {iteration}/{max_iterations}
+      - Iteration: {iteration}/{max_iterations} (workflow-wide)
+      - Step Iteration: {step_iteration} (times this step has run)
       - Step: fix_supervisor
 
       ## Supervisor Feedback (This is the latest instruction - prioritize this)

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

@@ -1,6 +1,16 @@
 # MAGI System Workflow
 # A deliberation workflow modeled after Evangelion's MAGI system
 # Three personas (scientist, nurturer, pragmatist) analyze from different perspectives and vote
+#
+# Template Variables:
+#   {iteration}      - Workflow-wide turn count (total steps executed across all agents)
+#   {max_iterations} - Maximum iterations allowed for the workflow
+#   {step_iteration} - Per-step iteration count (how many times THIS step has been executed)
+#   {task}           - Original user request
+#   {previous_response} - Output from the previous step
+#   {git_diff}       - Current uncommitted changes (git diff)
+#   {user_inputs}    - Accumulated user inputs during workflow
+#   {report_dir}     - Report directory name (e.g., "20250126-143052-task-summary")
 
 name: magi
 description: MAGI Deliberation System - Analyze from 3 perspectives and decide by majority

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

@@ -5,6 +5,16 @@
 # Flow:
 # plan -> dig -> supervise -> COMPLETE (approved)
 #                          -> plan (rejected: restart from planning)
+#
+# Template Variables:
+#   {iteration}      - Workflow-wide turn count (total steps executed across all agents)
+#   {max_iterations} - Maximum iterations allowed for the workflow
+#   {step_iteration} - Per-step iteration count (how many times THIS step has been executed)
+#   {task}           - Original user request
+#   {previous_response} - Output from the previous step
+#   {git_diff}       - Current uncommitted changes (git diff)
+#   {user_inputs}    - Accumulated user inputs during workflow
+#   {report_dir}     - Report directory name (e.g., "20250126-143052-task-summary")
 
 name: research
 description: Research workflow - autonomously executes research without asking questions
@@ -49,7 +59,8 @@ steps:
       ```
     instruction_template: |
       ## Workflow Status
-      - Iteration: {iteration}/{max_iterations}
+      - Iteration: {iteration}/{max_iterations} (workflow-wide)
+      - Step Iteration: {step_iteration} (times this step has run)
       - Step: plan
 
       ## Research Request
@@ -111,7 +122,8 @@ steps:
       ```
     instruction_template: |
       ## Workflow Status
-      - Iteration: {iteration}/{max_iterations}
+      - Iteration: {iteration}/{max_iterations} (workflow-wide)
+      - Step Iteration: {step_iteration} (times this step has run)
       - Step: dig
 
       ## Original Research Request
@@ -188,7 +200,8 @@ steps:
       ```
     instruction_template: |
       ## Workflow Status
-      - Iteration: {iteration}/{max_iterations}
+      - Iteration: {iteration}/{max_iterations} (workflow-wide)
+      - Step Iteration: {step_iteration} (times this step has run)
       - Step: supervise (research quality evaluation)
 
       ## Original Research Request

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

@@ -1,5 +1,15 @@
 # Default TAKT Workflow
 # Plan -> Coder -> Architect Review -> AI Review -> Security Review -> Supervisor Approval
+#
+# Template Variables:
+#   {iteration}      - Workflow-wide turn count (total steps executed across all agents)
+#   {max_iterations} - Maximum iterations allowed for the workflow
+#   {step_iteration} - Per-step iteration count (how many times THIS step has been executed)
+#   {task}           - Original user request
+#   {previous_response} - Output from the previous step
+#   {git_diff}       - Current uncommitted changes (git diff)
+#   {user_inputs}    - Accumulated user inputs during workflow
+#   {report_dir}     - Report directory name (e.g., "20250126-143052-task-summary")
 
 name: default
 description: Standard development workflow with planning and specialized reviews
@@ -55,7 +65,8 @@ steps:
       ```
     instruction_template: |
       ## Workflow Context
-      - Iteration: {iteration}/{max_iterations}
+      - Iteration: {iteration}/{max_iterations}（ワークフロー全体）
+      - Step Iteration: {step_iteration}（このステップの実行回数）
       - Step: plan (タスク分析)
       - Report Directory: .takt/reports/{report_dir}/
       - Report File: .takt/reports/{report_dir}/00-plan.md
@@ -79,7 +90,7 @@ steps:
 
       **レポート出力:** 上記の `Report File` に出力してください。
       - ファイルが存在しない場合: 新規作成
-      - ファイルが存在する場合: `## Iteration {iteration}` セクションを追記
+      - ファイルが存在する場合: `## Iteration {step_iteration}` セクションを追記
 
       **レポートフォーマット:**
       ```markdown
@@ -155,7 +166,8 @@ steps:
       ```
     instruction_template: |
       ## Workflow Context
-      - Iteration: {iteration}/{max_iterations}
+      - Iteration: {iteration}/{max_iterations}（ワークフロー全体）
+      - Step Iteration: {step_iteration}（このステップの実行回数）
       - Step: implement
       - Report Directory: .takt/reports/{report_dir}/
       - Report Files:
@@ -174,7 +186,7 @@ steps:
 
       **レポート出力:** 上記の `Report Files` に出力してください。
       - ファイルが存在しない場合: 新規作成
-      - ファイルが存在する場合: `## Iteration {iteration}` セクションを追記
+      - ファイルが存在する場合: `## Iteration {step_iteration}` セクションを追記
 
       **Scopeレポートフォーマット（実装開始時に作成）:**
       ```markdown
@@ -279,7 +291,8 @@ steps:
       ```
     instruction_template: |
       ## Workflow Context
-      - Iteration: {iteration}/{max_iterations}
+      - Iteration: {iteration}/{max_iterations}（ワークフロー全体）
+      - Step Iteration: {step_iteration}（このステップの実行回数）
       - Step: review (アーキテクチャレビュー)
       - Report Directory: .takt/reports/{report_dir}/
       - Report File: .takt/reports/{report_dir}/03-architect-review.md
@@ -299,7 +312,7 @@ steps:
 
       **レポート出力:** 上記の `Report File` に出力してください。
       - ファイルが存在しない場合: 新規作成
-      - ファイルが存在する場合: `## Iteration {iteration}` セクションを追記
+      - ファイルが存在する場合: `## Iteration {step_iteration}` セクションを追記
 
       **レポートフォーマット:**
       ```markdown
@@ -382,7 +395,8 @@ steps:
       ```
     instruction_template: |
       ## Workflow Context
-      - Iteration: {iteration}/{max_iterations}
+      - Iteration: {iteration}/{max_iterations}（ワークフロー全体）
+      - Step Iteration: {step_iteration}（このステップの実行回数）
       - Step: improve
 
       ## Architect Feedback (これが最新の指示です - 優先して対応してください)
@@ -462,7 +476,8 @@ steps:
       ```
     instruction_template: |
       ## Workflow Context
-      - Iteration: {iteration}/{max_iterations}
+      - Iteration: {iteration}/{max_iterations}（ワークフロー全体）
+      - Step Iteration: {step_iteration}（このステップの実行回数）
       - Step: ai_review (AI生成コードレビュー)
       - Report Directory: .takt/reports/{report_dir}/
       - Report File: .takt/reports/{report_dir}/04-ai-review.md
@@ -484,7 +499,7 @@ steps:
 
       **レポート出力:** 上記の `Report File` に出力してください。
       - ファイルが存在しない場合: 新規作成
-      - ファイルが存在する場合: `## Iteration {iteration}` セクションを追記
+      - ファイルが存在する場合: `## Iteration {step_iteration}` セクションを追記
 
       **レポートフォーマット:**
       ```markdown
@@ -563,7 +578,8 @@ steps:
       ```
     instruction_template: |
       ## Workflow Context
-      - Iteration: {iteration}/{max_iterations}
+      - Iteration: {iteration}/{max_iterations}（ワークフロー全体）
+      - Step Iteration: {step_iteration}（このステップの実行回数）
       - Step: ai_fix
 
       ## AI Review Feedback (これが最新の指示です - 優先して対応してください)
@@ -638,7 +654,8 @@ steps:
       ```
     instruction_template: |
       ## Workflow Context
-      - Iteration: {iteration}/{max_iterations}
+      - Iteration: {iteration}/{max_iterations}（ワークフロー全体）
+      - Step Iteration: {step_iteration}（このステップの実行回数）
       - Step: security_review
       - Report Directory: .takt/reports/{report_dir}/
       - Report File: .takt/reports/{report_dir}/05-security-review.md
@@ -660,7 +677,7 @@ steps:
 
       **レポート出力:** 上記の `Report File` に出力してください。
       - ファイルが存在しない場合: 新規作成
-      - ファイルが存在する場合: `## Iteration {iteration}` セクションを追記
+      - ファイルが存在する場合: `## Iteration {step_iteration}` セクションを追記
 
       **レポートフォーマット:**
       ```markdown
@@ -742,7 +759,8 @@ steps:
       ```
     instruction_template: |
       ## Workflow Context
-      - Iteration: {iteration}/{max_iterations}
+      - Iteration: {iteration}/{max_iterations}（ワークフロー全体）
+      - Step Iteration: {step_iteration}（このステップの実行回数）
       - Step: security_fix
 
       ## Security Review Feedback (これが最新の指示です - 優先して対応してください)
@@ -810,7 +828,8 @@ steps:
       ```
     instruction_template: |
       ## Workflow Context
-      - Iteration: {iteration}/{max_iterations}
+      - Iteration: {iteration}/{max_iterations}（ワークフロー全体）
+      - Step Iteration: {step_iteration}（このステップの実行回数）
       - Step: fix
 
       ## Architect Feedback (これが最新の指示です - 優先して対応してください)
@@ -889,7 +908,8 @@ steps:
       ```
     instruction_template: |
       ## Workflow Context
-      - Iteration: {iteration}/{max_iterations}
+      - Iteration: {iteration}/{max_iterations}（ワークフロー全体）
+      - Step Iteration: {step_iteration}（このステップの実行回数）
       - Step: supervise (final verification)
       - Report Directory: .takt/reports/{report_dir}/
       - Report Files:
@@ -917,7 +937,7 @@ steps:
 
       **レポート出力:** 上記の `Report Files` に出力してください。
       - ファイルが存在しない場合: 新規作成
-      - ファイルが存在する場合: `## Iteration {iteration}` セクションを追記
+      - ファイルが存在する場合: `## Iteration {step_iteration}` セクションを追記
 
       **Validationレポートフォーマット:**
       ```markdown

package/resources/global/ja/workflows/expert-review.yaml

@@ -9,6 +9,16 @@
 # 修正時の戻り先はCoderが判断:
 # - fix_security: MINOR→security_review, MAJOR→cqrs_es_review
 # - fix_qa: MINOR→qa_review, SECURITY→security_review, MAJOR→cqrs_es_review
+#
+# テンプレート変数:
+#   {iteration}      - ワークフロー全体のターン数（全エージェントで実行されたステップの合計）
+#   {max_iterations} - ワークフローの最大イテレーション数
+#   {step_iteration} - ステップごとのイテレーション数（このステップが何回実行されたか）
+#   {task}           - 元のユーザー要求
+#   {previous_response} - 前のステップの出力
+#   {git_diff}       - 現在のコミットされていない変更（git diff）
+#   {user_inputs}    - ワークフロー中に蓄積されたユーザー入力
+#   {report_dir}     - レポートディレクトリ名（例: "20250126-143052-task-summary"）
 
 name: expert-review
 description: CQRS+ES・フロントエンド・セキュリティ・QA専門家レビュー
@@ -44,7 +54,8 @@ steps:
       | 要件不明確 | `[PLANNER:BLOCKED]` |
     instruction_template: |
       ## Workflow Context
-      - Iteration: {iteration}/{max_iterations}
+      - Iteration: {iteration}/{max_iterations}（ワークフロー全体）
+      - Step Iteration: {step_iteration}（このステップの実行回数）
       - Step: plan (タスク分析)
       - Report Directory: .takt/reports/{report_dir}/
       - Report File: .takt/reports/{report_dir}/00-plan.md
@@ -68,7 +79,7 @@ steps:
 
       **レポート出力:** 上記の `Report File` に出力してください。
       - ファイルが存在しない場合: 新規作成
-      - ファイルが存在する場合: `## Iteration {iteration}` セクションを追記
+      - ファイルが存在する場合: `## Iteration {step_iteration}` セクションを追記
 
       **レポートフォーマット:**
       ```markdown
@@ -129,7 +140,8 @@ steps:
       | 進行不可 | `[CODER:BLOCKED]` |
     instruction_template: |
       ## Workflow Context
-      - Iteration: {iteration}/{max_iterations}
+      - Iteration: {iteration}/{max_iterations}（ワークフロー全体）
+      - Step Iteration: {step_iteration}（このステップの実行回数）
       - Step: implement
       - Report Directory: .takt/reports/{report_dir}/
       - Report Files:
@@ -148,7 +160,7 @@ steps:
 
       **レポート出力:** 上記の `Report Files` に出力してください。
       - ファイルが存在しない場合: 新規作成
-      - ファイルが存在する場合: `## Iteration {iteration}` セクションを追記
+      - ファイルが存在する場合: `## Iteration {step_iteration}` セクションを追記
 
       **Scopeレポートフォーマット（実装開始時に作成）:**
       ```markdown
@@ -213,7 +225,8 @@ steps:
       | 設計に問題あり | `[CQRS-ES:REJECT]` |
     instruction_template: |
       ## Workflow Context
-      - Iteration: {iteration}/{max_iterations}
+      - Iteration: {iteration}/{max_iterations}（ワークフロー全体）
+      - Step Iteration: {step_iteration}（このステップの実行回数）
       - Step: cqrs_es_review (CQRS+ES専門レビュー)
       - Report Directory: .takt/reports/{report_dir}/
       - Report File: .takt/reports/{report_dir}/03-cqrs-es-review.md
@@ -242,7 +255,7 @@ steps:
 
       **レポート出力:** 上記の `Report File` に出力してください。
       - ファイルが存在しない場合: 新規作成
-      - ファイルが存在する場合: `## Iteration {iteration}` セクションを追記
+      - ファイルが存在する場合: `## Iteration {step_iteration}` セクションを追記
 
       **レポートフォーマット:**
       ```markdown
@@ -302,7 +315,8 @@ steps:
       | 進行不可 | `[CODER:BLOCKED]` |
     instruction_template: |
       ## Workflow Context
-      - Iteration: {iteration}/{max_iterations}
+      - Iteration: {iteration}/{max_iterations}（ワークフロー全体）
+      - Step Iteration: {step_iteration}（このステップの実行回数）
       - Step: fix_cqrs_es
 
       ## CQRS+ES Review Feedback (これが最新の指示です - 優先して対応してください)
@@ -358,7 +372,8 @@ steps:
       | フロントエンド設計に問題あり | `[FRONTEND:REJECT]` |
     instruction_template: |
       ## Workflow Context
-      - Iteration: {iteration}/{max_iterations}
+      - Iteration: {iteration}/{max_iterations}（ワークフロー全体）
+      - Step Iteration: {step_iteration}（このステップの実行回数）
       - Step: frontend_review (フロントエンド専門レビュー)
       - Report Directory: .takt/reports/{report_dir}/
       - Report File: .takt/reports/{report_dir}/04-frontend-review.md
@@ -387,7 +402,7 @@ steps:
 
       **レポート出力:** 上記の `Report File` に出力してください。
       - ファイルが存在しない場合: 新規作成
-      - ファイルが存在する場合: `## Iteration {iteration}` セクションを追記
+      - ファイルが存在する場合: `## Iteration {step_iteration}` セクションを追記
 
       **レポートフォーマット:**
       ```markdown
@@ -447,7 +462,8 @@ steps:
       | 進行不可 | `[CODER:BLOCKED]` |
     instruction_template: |
       ## Workflow Context
-      - Iteration: {iteration}/{max_iterations}
+      - Iteration: {iteration}/{max_iterations}（ワークフロー全体）
+      - Step Iteration: {step_iteration}（このステップの実行回数）
       - Step: fix_frontend
 
       ## Frontend Review Feedback (これが最新の指示です - 優先して対応してください)
@@ -503,7 +519,8 @@ steps:
       | 問題あり | `[AI_REVIEW:REJECT]` |
     instruction_template: |
       ## Workflow Context
-      - Iteration: {iteration}/{max_iterations}
+      - Iteration: {iteration}/{max_iterations}（ワークフロー全体）
+      - Step Iteration: {step_iteration}（このステップの実行回数）
       - Step: ai_review (AI生成コードレビュー)
       - Report Directory: .takt/reports/{report_dir}/
       - Report File: .takt/reports/{report_dir}/05-ai-review.md
@@ -525,7 +542,7 @@ steps:
 
       **レポート出力:** 上記の `Report File` に出力してください。
       - ファイルが存在しない場合: 新規作成
-      - ファイルが存在する場合: `## Iteration {iteration}` セクションを追記
+      - ファイルが存在する場合: `## Iteration {step_iteration}` セクションを追記
 
       **レポートフォーマット:**
       ```markdown
@@ -588,7 +605,8 @@ steps:
       | 進行不可 | `[CODER:BLOCKED]` |
     instruction_template: |
       ## Workflow Context
-      - Iteration: {iteration}/{max_iterations}
+      - Iteration: {iteration}/{max_iterations}（ワークフロー全体）
+      - Step Iteration: {step_iteration}（このステップの実行回数）
       - Step: ai_fix
 
       ## AI Review Feedback (これが最新の指示です - 優先して対応してください)
@@ -642,7 +660,8 @@ steps:
       | 脆弱性あり | `[SECURITY:REJECT]` |
     instruction_template: |
       ## Workflow Context
-      - Iteration: {iteration}/{max_iterations}
+      - Iteration: {iteration}/{max_iterations}（ワークフロー全体）
+      - Step Iteration: {step_iteration}（このステップの実行回数）
       - Step: security_review (セキュリティ専門レビュー)
       - Report Directory: .takt/reports/{report_dir}/
       - Report File: .takt/reports/{report_dir}/06-security-review.md
@@ -667,7 +686,7 @@ steps:
 
       **レポート出力:** 上記の `Report File` に出力してください。
       - ファイルが存在しない場合: 新規作成
-      - ファイルが存在する場合: `## Iteration {iteration}` セクションを追記
+      - ファイルが存在する場合: `## Iteration {step_iteration}` セクションを追記
 
       **レポートフォーマット:**
       ```markdown
@@ -729,7 +748,8 @@ steps:
       | 進行不可 | `[CODER:BLOCKED]` |
     instruction_template: |
       ## Workflow Context
-      - Iteration: {iteration}/{max_iterations}
+      - Iteration: {iteration}/{max_iterations}（ワークフロー全体）
+      - Step Iteration: {step_iteration}（このステップの実行回数）
       - Step: fix_security
 
       ## Security Review Feedback (これが最新の指示です - 優先して対応してください)
@@ -794,7 +814,8 @@ steps:
       | 品質問題あり | `[QA:REJECT]` |
     instruction_template: |
       ## Workflow Context
-      - Iteration: {iteration}/{max_iterations}
+      - Iteration: {iteration}/{max_iterations}（ワークフロー全体）
+      - Step Iteration: {step_iteration}（このステップの実行回数）
       - Step: qa_review (QA専門レビュー)
       - Report Directory: .takt/reports/{report_dir}/
       - Report File: .takt/reports/{report_dir}/07-qa-review.md
@@ -820,7 +841,7 @@ steps:
 
       **レポート出力:** 上記の `Report File` に出力してください。
       - ファイルが存在しない場合: 新規作成
-      - ファイルが存在する場合: `## Iteration {iteration}` セクションを追記
+      - ファイルが存在する場合: `## Iteration {step_iteration}` セクションを追記
 
       **レポートフォーマット:**
       ```markdown
@@ -882,7 +903,8 @@ steps:
       | 進行不可 | `[CODER:BLOCKED]` |
     instruction_template: |
       ## Workflow Context
-      - Iteration: {iteration}/{max_iterations}
+      - Iteration: {iteration}/{max_iterations}（ワークフロー全体）
+      - Step Iteration: {step_iteration}（このステップの実行回数）
       - Step: fix_qa
 
       ## QA Review Feedback (これが最新の指示です - 優先して対応してください)
@@ -951,7 +973,8 @@ steps:
       | 問題あり | `[SUPERVISOR:REJECT]` |
     instruction_template: |
       ## Workflow Context
-      - Iteration: {iteration}/{max_iterations}
+      - Iteration: {iteration}/{max_iterations}（ワークフロー全体）
+      - Step Iteration: {step_iteration}（このステップの実行回数）
       - Step: supervise (最終確認)
       - Report Directory: .takt/reports/{report_dir}/
       - Report Files:
@@ -987,7 +1010,7 @@ steps:
 
       **レポート出力:** 上記の `Report Files` に出力してください。
       - ファイルが存在しない場合: 新規作成
-      - ファイルが存在する場合: `## Iteration {iteration}` セクションを追記
+      - ファイルが存在する場合: `## Iteration {step_iteration}` セクションを追記
 
       **Validationレポートフォーマット:**
       ```markdown
@@ -1079,7 +1102,8 @@ steps:
       | 進行不可 | `[CODER:BLOCKED]` |
     instruction_template: |
       ## Workflow Context
-      - Iteration: {iteration}/{max_iterations}
+      - Iteration: {iteration}/{max_iterations}（ワークフロー全体）
+      - Step Iteration: {step_iteration}（このステップの実行回数）
       - Step: fix_supervisor
 
       ## Supervisor Feedback (これが最新の指示です - 優先して対応してください)