takt 0.1.3 → 0.1.5

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
@@ -18,9 +28,45 @@ steps:
       - Bash
       - WebSearch
       - WebFetch
+    status_rules_prompt: |
+      # ⚠️ 必須: ステータス出力ルール ⚠️
+
+      **このタグがないとワークフローが停止します。**
+      最終出力には必ず以下のルールに従ったステータスタグを含めてください。
+
+      ## 判定基準
+
+      | 状況 | 判定 |
+      |------|------|
+      | 要件が明確で実装可能 | DONE |
+      | 要件が不明確、情報不足 | BLOCKED |
+
+      ## 出力フォーマット
+
+      | 状況 | タグ |
+      |------|------|
+      | 分析完了 | `[PLANNER:DONE]` |
+      | 情報不足 | `[PLANNER:BLOCKED]` |
+
+      ### 出力例
+
+      **DONE の場合:**
+      ```
+      [PLANNER:DONE]
+      ```
+
+      **BLOCKED の場合:**
+      ```
+      [PLANNER:BLOCKED]
+
+      確認事項:
+      - {質問1}
+      - {質問2}
+      ```
     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
@@ -44,7 +90,7 @@ steps:
 
       **レポート出力:** 上記の `Report File` に出力してください。
       - ファイルが存在しない場合: 新規作成
-      - ファイルが存在する場合: `## Iteration {iteration}` セクションを追記
+      - ファイルが存在する場合: `## Iteration {step_iteration}` セクションを追記
 
       **レポートフォーマット:**
       ```markdown
@@ -67,9 +113,6 @@ steps:
       ## 確認事項（あれば）
       - {不明点や確認が必要な点}
       ```
-
-      完了したら [PLANNER:DONE] を出力。
-      要件が不明確な場合は [PLANNER:BLOCKED] を出力。
     pass_previous_response: true
     transitions:
       - condition: done
@@ -88,9 +131,43 @@ steps:
       - Bash
       - WebSearch
       - WebFetch
+    status_rules_prompt: |
+      # ⚠️ 必須: ステータス出力ルール ⚠️
+
+      **このタグがないとワークフローが停止します。**
+      最終出力には必ず以下のルールに従ったステータスタグを含めてください。
+
+      ## 出力フォーマット
+
+      | 状況 | タグ |
+      |------|------|
+      | 実装完了 | `[CODER:DONE]` |
+      | 判断できない/情報不足 | `[CODER:BLOCKED]` |
+
+      **重要**: 迷ったら `[BLOCKED]`。勝手に判断しない。
+
+      ### 出力例
+
+      **DONE の場合:**
+      ```
+      実装完了しました。
+      - 作成: `src/auth/service.ts`, `tests/auth.test.ts`
+      - 変更: `src/routes.ts`
+
+      [CODER:DONE]
+      ```
+
+      **BLOCKED の場合:**
+      ```
+      [CODER:BLOCKED]
+
+      理由: DBスキーマが未定義のため実装できません
+      必要な情報: usersテーブルの構造
+      ```
     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:
@@ -109,7 +186,7 @@ steps:
 
       **レポート出力:** 上記の `Report Files` に出力してください。
       - ファイルが存在しない場合: 新規作成
-      - ファイルが存在する場合: `## Iteration {iteration}` セクションを追記
+      - ファイルが存在する場合: `## Iteration {step_iteration}` セクションを追記
 
       **Scopeレポートフォーマット（実装開始時に作成）:**
       ```markdown
@@ -140,9 +217,6 @@ steps:
       - **検討した選択肢**: {選択肢リスト}
       - **理由**: {選んだ理由}
       ```
-
-      完了時は [CODER:DONE] を含めてください。
-      進行できない場合は [CODER:BLOCKED] を出力し、planに戻ります。
     transitions:
       - condition: done
         next_step: review
@@ -157,9 +231,68 @@ steps:
       - Grep
       - WebSearch
       - WebFetch
+    status_rules_prompt: |
+      # ⚠️ 必須: ステータス出力ルール ⚠️
+
+      **このタグがないとワークフローが停止します。**
+      最終出力には必ず以下のルールに従ったステータスタグを含めてください。
+
+      ## 判定基準
+
+      | 状況 | 判定 |
+      |------|------|
+      | 構造に問題がある | REJECT |
+      | 設計原則違反がある | REJECT |
+      | セキュリティ問題がある | REJECT |
+      | テストが不十分 | REJECT |
+      | 改善すべき点がある（軽微） | IMPROVE |
+      | 問題なし | APPROVE |
+
+      **IMPROVE の使い方:**
+      - 設計としては許容範囲だが、改善した方が良い点がある場合
+      - 例: 命名の改善、小さなリファクタリング、コメント追加
+
+      ## 出力フォーマット
+
+      | 状況 | タグ |
+      |------|------|
+      | 問題なし | `[ARCHITECT:APPROVE]` |
+      | 軽微な改善必要 | `[ARCHITECT:IMPROVE]` |
+      | 構造的な修正必要 | `[ARCHITECT:REJECT]` |
+
+      ### 出力例
+
+      **APPROVE の場合:**
+      ```
+      [ARCHITECT:APPROVE]
+
+      良い点:
+      - モジュール分割が適切
+      - 単一責務が守られている
+      ```
+
+      **IMPROVE の場合:**
+      ```
+      [ARCHITECT:IMPROVE]
+
+      改善点:
+      - 命名を改善してください: `data` → `userData`
+      - コメントを追加してください
+      ```
+
+      **REJECT の場合:**
+      ```
+      [ARCHITECT:REJECT]
+
+      問題点:
+      1. ファイルサイズ超過
+         - 場所: `src/services/user.ts` (523行)
+         - 修正案: 3ファイルに分割
+      ```
     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
@@ -175,14 +308,11 @@ steps:
       ## Instructions
       **アーキテクチャと設計**のレビューに集中してください。AI特有の問題はレビューしないでください（次のステップで行います）。
 
-      変更をレビューしてフィードバックを提供してください:
-      - [ARCHITECT:APPROVE] 問題なしの場合
-      - [ARCHITECT:IMPROVE] 改善すべき点がある場合（軽微な修正）
-      - [ARCHITECT:REJECT] 構造的な変更が必要な場合（具体的な問題をリスト）
+      変更をレビューしてフィードバックを提供してください。
 
       **レポート出力:** 上記の `Report File` に出力してください。
       - ファイルが存在しない場合: 新規作成
-      - ファイルが存在する場合: `## Iteration {iteration}` セクションを追記
+      - ファイルが存在する場合: `## Iteration {step_iteration}` セクションを追記
 
       **レポートフォーマット:**
       ```markdown
@@ -230,9 +360,43 @@ steps:
       - Bash
       - WebSearch
       - WebFetch
+    status_rules_prompt: |
+      # ⚠️ 必須: ステータス出力ルール ⚠️
+
+      **このタグがないとワークフローが停止します。**
+      最終出力には必ず以下のルールに従ったステータスタグを含めてください。
+
+      ## 出力フォーマット
+
+      | 状況 | タグ |
+      |------|------|
+      | 改善完了 | `[CODER:DONE]` |
+      | 判断できない/情報不足 | `[CODER:BLOCKED]` |
+
+      **重要**: 迷ったら `[BLOCKED]`。勝手に判断しない。
+
+      ### 出力例
+
+      **DONE の場合:**
+      ```
+      改善を完了しました。
+      - 命名を改善: `data` → `userData`
+      - コメントを追加
+
+      [CODER:DONE]
+      ```
+
+      **BLOCKED の場合:**
+      ```
+      [CODER:BLOCKED]
+
+      理由: 改善の意図が不明確です
+      必要な情報: 具体的な改善内容
+      ```
     instruction_template: |
       ## Workflow Context
-      - Iteration: {iteration}/{max_iterations}
+      - Iteration: {iteration}/{max_iterations}（ワークフロー全体）
+      - Step Iteration: {step_iteration}（このステップの実行回数）
       - Step: improve
 
       ## Architect Feedback (これが最新の指示です - 優先して対応してください)
@@ -253,9 +417,6 @@ steps:
       - 小さなリファクタリング
       - コメントの追加・修正
       - コードの整理
-
-      完了時は [CODER:DONE] を含めてください。
-      進行できない場合は [CODER:BLOCKED] を含めてください。
     pass_previous_response: true
     transitions:
       - condition: done
@@ -271,9 +432,52 @@ steps:
       - Grep
       - WebSearch
       - WebFetch
+    status_rules_prompt: |
+      # ⚠️ 必須: ステータス出力ルール ⚠️
+
+      **このタグがないとワークフローが停止します。**
+      最終出力には必ず以下のルールに従ったステータスタグを含めてください。
+
+      ## 判定基準
+
+      | 状況 | 判定 |
+      |------|------|
+      | 仮定が間違っている（動作に影響） | REJECT |
+      | もっともらしいが間違っているコード | REJECT |
+      | コードベースの文脈に重大な不整合 | REJECT |
+      | スコープクリープ | APPROVE（警告を付記） |
+      | 軽微なスタイルの逸脱のみ | APPROVE |
+      | コードが文脈に合い動作する | APPROVE |
+
+      **注意:** スコープクリープは警告として記載するが、それだけでREJECTしない。
+
+      ## 出力フォーマット
+
+      | 状況 | タグ |
+      |------|------|
+      | AI特有の問題なし | `[AI_REVIEW:APPROVE]` |
+      | 問題あり | `[AI_REVIEW:REJECT]` |
+
+      ### 出力例
+
+      **APPROVE の場合:**
+      ```
+      [AI_REVIEW:APPROVE]
+
+      検証結果: 問題なし
+      ```
+
+      **REJECT の場合:**
+      ```
+      [AI_REVIEW:REJECT]
+
+      問題点:
+      1. 存在しないAPIを使用: `fetch.json()` → `response.json()`
+      ```
     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
@@ -293,13 +497,9 @@ steps:
       - 既存コードベースとの適合性
       - スコープクリープの検出
 
-      以下を含めてください:
-      - [AI_REVIEW:APPROVE] AI特有の問題が見つからない場合
-      - [AI_REVIEW:REJECT] 問題が検出された場合（具体的な問題をリスト）
-
       **レポート出力:** 上記の `Report File` に出力してください。
       - ファイルが存在しない場合: 新規作成
-      - ファイルが存在する場合: `## Iteration {iteration}` セクションを追記
+      - ファイルが存在する場合: `## Iteration {step_iteration}` セクションを追記
 
       **レポートフォーマット:**
       ```markdown
@@ -344,9 +544,42 @@ steps:
       - Bash
       - WebSearch
       - WebFetch
+    status_rules_prompt: |
+      # ⚠️ 必須: ステータス出力ルール ⚠️
+
+      **このタグがないとワークフローが停止します。**
+      最終出力には必ず以下のルールに従ったステータスタグを含めてください。
+
+      ## 出力フォーマット
+
+      | 状況 | タグ |
+      |------|------|
+      | AI問題の修正完了 | `[CODER:DONE]` |
+      | 判断できない/情報不足 | `[CODER:BLOCKED]` |
+
+      **重要**: 迷ったら `[BLOCKED]`。勝手に判断しない。
+
+      ### 出力例
+
+      **DONE の場合:**
+      ```
+      AI Reviewerの指摘を修正しました。
+      - 存在しないAPIを修正: `fetch.json()` → `response.json()`
+
+      [CODER:DONE]
+      ```
+
+      **BLOCKED の場合:**
+      ```
+      [CODER:BLOCKED]
+
+      理由: 指摘された問題の修正方法が不明確です
+      必要な情報: 代替APIの仕様
+      ```
     instruction_template: |
       ## Workflow Context
-      - Iteration: {iteration}/{max_iterations}
+      - Iteration: {iteration}/{max_iterations}（ワークフロー全体）
+      - Step Iteration: {step_iteration}（このステップの実行回数）
       - Step: ai_fix
 
       ## AI Review Feedback (これが最新の指示です - 優先して対応してください)
@@ -365,9 +598,6 @@ steps:
       - もっともらしいが間違っている実装の修正
       - 既存コードベースのパターンとの整合
       - スコープクリープの除去
-
-      完了時は [CODER:DONE] を含めてください。
-      進行できない場合は [CODER:BLOCKED] を含めてください。
     pass_previous_response: true
     transitions:
       - condition: done
@@ -383,9 +613,49 @@ steps:
       - Grep
       - WebSearch
       - WebFetch
+    status_rules_prompt: |
+      # ⚠️ 必須: ステータス出力ルール ⚠️
+
+      **このタグがないとワークフローが停止します。**
+      最終出力には必ず以下のルールに従ったステータスタグを含めてください。
+
+      ## 判定基準
+
+      | 状況 | 判定 |
+      |------|------|
+      | 重大な脆弱性 | REJECT |
+      | 中程度の脆弱性 | REJECT |
+      | 軽微な問題・警告のみ | APPROVE（警告を付記） |
+      | セキュリティ問題なし | APPROVE |
+
+      ## 出力フォーマット
+
+      | 状況 | タグ |
+      |------|------|
+      | セキュリティ問題なし | `[SECURITY:APPROVE]` |
+      | 脆弱性があり修正が必要 | `[SECURITY:REJECT]` |
+
+      ### 出力例
+
+      **APPROVE の場合:**
+      ```
+      [SECURITY:APPROVE]
+
+      セキュリティ問題は検出されませんでした。
+      ```
+
+      **REJECT の場合:**
+      ```
+      [SECURITY:REJECT]
+
+      脆弱性:
+      1. SQLインジェクション: `src/db.ts:42`
+         修正案: パラメータ化クエリを使用
+      ```
     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
@@ -405,13 +675,9 @@ steps:
       - データ露出リスク
       - 暗号化の弱点
 
-      以下を含めてください:
-      - [SECURITY:APPROVE] セキュリティ問題がない場合
-      - [SECURITY:REJECT] 脆弱性が検出された場合（具体的な問題をリスト）
-
       **レポート出力:** 上記の `Report File` に出力してください。
       - ファイルが存在しない場合: 新規作成
-      - ファイルが存在する場合: `## Iteration {iteration}` セクションを追記
+      - ファイルが存在する場合: `## Iteration {step_iteration}` セクションを追記
 
       **レポートフォーマット:**
       ```markdown
@@ -459,9 +725,42 @@ steps:
       - Bash
       - WebSearch
       - WebFetch
+    status_rules_prompt: |
+      # ⚠️ 必須: ステータス出力ルール ⚠️
+
+      **このタグがないとワークフローが停止します。**
+      最終出力には必ず以下のルールに従ったステータスタグを含めてください。
+
+      ## 出力フォーマット
+
+      | 状況 | タグ |
+      |------|------|
+      | セキュリティ修正完了 | `[CODER:DONE]` |
+      | 判断できない/情報不足 | `[CODER:BLOCKED]` |
+
+      **重要**: セキュリティの問題は最優先で対応が必要です。
+
+      ### 出力例
+
+      **DONE の場合:**
+      ```
+      セキュリティの指摘を修正しました。
+      - SQLインジェクション対策: パラメータ化クエリに変更
+
+      [CODER:DONE]
+      ```
+
+      **BLOCKED の場合:**
+      ```
+      [CODER:BLOCKED]
+
+      理由: 修正方法が不明確です
+      必要な情報: 認証ライブラリの仕様
+      ```
     instruction_template: |
       ## Workflow Context
-      - Iteration: {iteration}/{max_iterations}
+      - Iteration: {iteration}/{max_iterations}（ワークフロー全体）
+      - Step Iteration: {step_iteration}（このステップの実行回数）
       - Step: security_fix
 
       ## Security Review Feedback (これが最新の指示です - 優先して対応してください)
@@ -476,9 +775,6 @@ steps:
       ## Instructions
       **重要**: セキュリティレビューで指摘された脆弱性を修正してください。
       セキュリティの問題は最優先で対応が必要です。
-
-      完了時は [CODER:DONE] を含めてください。
-      進行できない場合は [CODER:BLOCKED] を含めてください。
     pass_previous_response: true
     transitions:
       - condition: done
@@ -497,9 +793,43 @@ steps:
       - Bash
       - WebSearch
       - WebFetch
+    status_rules_prompt: |
+      # ⚠️ 必須: ステータス出力ルール ⚠️
+
+      **このタグがないとワークフローが停止します。**
+      最終出力には必ず以下のルールに従ったステータスタグを含めてください。
+
+      ## 出力フォーマット
+
+      | 状況 | タグ |
+      |------|------|
+      | Architectの指摘を修正完了 | `[CODER:DONE]` |
+      | 判断できない/情報不足 | `[CODER:BLOCKED]` |
+
+      **重要**: 迷ったら `[BLOCKED]`。勝手に判断しない。
+
+      ### 出力例
+
+      **DONE の場合:**
+      ```
+      Architectの指摘を修正しました。
+      - ファイル分割: 3ファイルに分割
+      - 型定義を追加
+
+      [CODER:DONE]
+      ```
+
+      **BLOCKED の場合:**
+      ```
+      [CODER:BLOCKED]
+
+      理由: 修正方針が不明確です
+      必要な情報: 分割の具体的な方法
+      ```
     instruction_template: |
       ## Workflow Context
-      - Iteration: {iteration}/{max_iterations}
+      - Iteration: {iteration}/{max_iterations}（ワークフロー全体）
+      - Step Iteration: {step_iteration}（このステップの実行回数）
       - Step: fix
 
       ## Architect Feedback (これが最新の指示です - 優先して対応してください)
@@ -515,9 +845,6 @@ steps:
       **重要**: Architectのフィードバックに対応してください。
       「Original User Request」は参考情報であり、最新の指示ではありません。
       セッションの会話履歴を確認し、Architectの指摘事項を修正してください。
-
-      完了時は [CODER:DONE] を含めてください。
-      進行できない場合は [CODER:BLOCKED] を含めてください。
     pass_previous_response: true
     transitions:
       - condition: done
@@ -534,9 +861,55 @@ steps:
       - Bash
       - WebSearch
       - WebFetch
+    status_rules_prompt: |
+      # ⚠️ 必須: ステータス出力ルール ⚠️
+
+      **このタグがないとワークフローが停止します。**
+      最終出力には必ず以下のルールに従ったステータスタグを含めてください。
+
+      ## 判定基準
+
+      | 状況 | 判定 |
+      |------|------|
+      | 要求が満たされていない | REJECT |
+      | テストが失敗する | REJECT |
+      | ビルドが通らない | REJECT |
+      | その場しのぎが残っている | REJECT |
+      | すべて問題なし | APPROVE |
+
+      **原則**: 疑わしきは REJECT。曖昧な承認はしない。
+
+      ## 出力フォーマット
+
+      | 状況 | タグ |
+      |------|------|
+      | 最終承認 | `[SUPERVISOR:APPROVE]` |
+      | 差し戻し | `[SUPERVISOR:REJECT]` |
+
+      ### 出力例
+
+      **APPROVE の場合:**
+      ```
+      [SUPERVISOR:APPROVE]
+
+      検証結果:
+      - テスト: ✅ 全件パス
+      - ビルド: ✅ 成功
+      - 要求充足: ✅
+      ```
+
+      **REJECT の場合:**
+      ```
+      [SUPERVISOR:REJECT]
+
+      問題点:
+      1. テストが失敗: `npm test` で 2 件失敗
+      2. 元の要求を満たしていない: ログイン機能が未実装
+      ```
     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:
@@ -564,7 +937,7 @@ steps:
 
       **レポート出力:** 上記の `Report Files` に出力してください。
       - ファイルが存在しない場合: 新規作成
-      - ファイルが存在する場合: `## Iteration {iteration}` セクションを追記
+      - ファイルが存在する場合: `## Iteration {step_iteration}` セクションを追記
 
       **Validationレポートフォーマット:**
       ```markdown
@@ -619,10 +992,6 @@ steps:
       npm run build
       ```
       ```
-
-      出力:
-      - [SUPERVISOR:APPROVE] すべて完了、マージ可能
-      - [SUPERVISOR:REJECT] 問題あり（具体的な問題を記載）
     transitions:
       - condition: approved
         next_step: COMPLETE