takt 0.35.4 → 0.37.0

package/builtins/ja/workflows/audit-architecture-backend.yaml

@@ -5,16 +5,20 @@ initial_step: plan
 
 loop_monitors:
   - cycle: [supervise, review]
-    threshold: 4
+    threshold: 3
     judge:
       persona: supervisor
       instruction: |
         バックエンドのアーキテクチャ監査で supervise → review が {cycle_count} 回繰り返されています。
-        監査の完全性と品質を評価し、現時点の結果を受け入れてよいか判断してください。
+        監査レポートと計画レポートを比較し、以下を判断してください:
+        - 監査スコープが前回サイクルから拡大しているか（新しいモジュールが監査されたか）
+        - 残りの未監査モジュールは合理的なサイクル数で完了可能か
       rules:
-        - condition: Quality is sufficient
+        - condition: 監査品質・スコープが十分
           next: COMPLETE
-        - condition: Quality is insufficient with no prospect of improvement
+        - condition: スコープが拡大しており改善が続いている
+          next: review
+        - condition: スコープが停滞し改善の見込みがない
           next: ABORT
 
 steps:
@@ -78,6 +82,10 @@ steps:
       - architecture
     instruction: architecture-audit-review
     edit: false
+    output_contracts:
+      report:
+        - name: 02-architecture-audit.md
+          format: architecture-audit
     rules:
       - condition: Re-audit complete
         next: supervise

package/builtins/ja/workflows/audit-architecture-dual.yaml

@@ -5,16 +5,20 @@ initial_step: plan
 
 loop_monitors:
   - cycle: [supervise, review]
-    threshold: 4
+    threshold: 3
     judge:
       persona: supervisor
       instruction: |
         デュアルのアーキテクチャ監査で supervise → review が {cycle_count} 回繰り返されています。
-        監査の完全性と品質を評価し、現時点の結果を受け入れてよいか判断してください。
+        監査レポートと計画レポートを比較し、以下を判断してください:
+        - 監査スコープが前回サイクルから拡大しているか（新しいモジュールが監査されたか）
+        - 残りの未監査モジュールは合理的なサイクル数で完了可能か
       rules:
-        - condition: Quality is sufficient
+        - condition: 監査品質・スコープが十分
           next: COMPLETE
-        - condition: Quality is insufficient with no prospect of improvement
+        - condition: スコープが拡大しており改善が続いている
+          next: review
+        - condition: スコープが停滞し改善の見込みがない
           next: ABORT
 
 steps:
@@ -82,6 +86,10 @@ steps:
       - architecture
     instruction: architecture-audit-review
     edit: false
+    output_contracts:
+      report:
+        - name: 02-architecture-audit.md
+          format: architecture-audit
     rules:
       - condition: Re-audit complete
         next: supervise

package/builtins/ja/workflows/audit-architecture-frontend.yaml

@@ -5,16 +5,20 @@ initial_step: plan
 
 loop_monitors:
   - cycle: [supervise, review]
-    threshold: 4
+    threshold: 3
     judge:
       persona: supervisor
       instruction: |
         フロントエンドのアーキテクチャ監査で supervise → review が {cycle_count} 回繰り返されています。
-        監査の完全性と品質を評価し、現時点の結果を受け入れてよいか判断してください。
+        監査レポートと計画レポートを比較し、以下を判断してください:
+        - 監査スコープが前回サイクルから拡大しているか（新しいモジュールが監査されたか）
+        - 残りの未監査モジュールは合理的なサイクル数で完了可能か
       rules:
-        - condition: Quality is sufficient
+        - condition: 監査品質・スコープが十分
           next: COMPLETE
-        - condition: Quality is insufficient with no prospect of improvement
+        - condition: スコープが拡大しており改善が続いている
+          next: review
+        - condition: スコープが停滞し改善の見込みがない
           next: ABORT
 
 steps:
@@ -82,6 +86,10 @@ steps:
       - architecture
     instruction: architecture-audit-review
     edit: false
+    output_contracts:
+      report:
+        - name: 02-architecture-audit.md
+          format: architecture-audit
     rules:
       - condition: Re-audit complete
         next: supervise

package/builtins/ja/workflows/audit-architecture.yaml

@@ -5,16 +5,20 @@ initial_step: plan
 
 loop_monitors:
   - cycle: [supervise, review]
-    threshold: 4
+    threshold: 3
     judge:
       persona: supervisor
       instruction: |
         architecture audit の supervise → review サイクルが {cycle_count} 回繰り返されました。
-        監査の完全性と品質を総合的に判断し、現状の結果で受け入れるか判断してください。
+        監査レポートと計画レポートを比較し、以下を判断してください:
+        - 監査スコープが前回サイクルから拡大しているか（新しいモジュールが監査されたか）
+        - 残りの未監査モジュールは合理的なサイクル数で完了可能か
       rules:
-        - condition: 十分な品質に達している
+        - condition: 監査品質・スコープが十分
           next: COMPLETE
-        - condition: 品質が不十分だが改善の見込みがない
+        - condition: スコープが拡大しており改善が続いている
+          next: review
+        - condition: スコープが停滞し改善の見込みがない
           next: ABORT
 
 steps:
@@ -70,6 +74,10 @@ steps:
     knowledge: architecture
     instruction: architecture-audit-review
     edit: false
+    output_contracts:
+      report:
+        - name: 02-architecture-audit.md
+          format: architecture-audit
     rules:
       - condition: 再監査完了
         next: supervise

package/builtins/ja/workflows/audit-e2e.yaml

@@ -11,16 +11,20 @@ initial_step: plan
 
 loop_monitors:
   - cycle: [supervise, review]
-    threshold: 4
+    threshold: 3
     judge:
       persona: supervisor
       instruction: |
         e2e audit の supervise → review サイクルが {cycle_count} 回繰り返されました。
-        監査の完全性と品質を総合的に判断し、現状の結果で受け入れるか判断してください。
+        監査レポートと計画レポートを比較し、以下を判断してください:
+        - 監査スコープが前回サイクルから拡大しているか（新しいフローが監査されたか）
+        - 残りの未監査フローは合理的なサイクル数で完了可能か
       rules:
-        - condition: 十分な品質に達している
+        - condition: 監査品質・スコープが十分
           next: COMPLETE
-        - condition: 品質が不十分だが改善の見込みがない
+        - condition: スコープが拡大しており改善が続いている
+          next: review
+        - condition: スコープが停滞し改善の見込みがない
           next: ABORT
 
 steps:
@@ -87,6 +91,10 @@ steps:
     knowledge:
       - e2e-testing
     instruction: e2e-audit-review
+    output_contracts:
+      report:
+        - name: 02-e2e-audit.md
+          format: e2e-audit
     rules:
       - condition: 再監査完了
         next: supervise

package/builtins/ja/workflows/audit-security.yaml

@@ -5,16 +5,20 @@ initial_step: plan
 
 loop_monitors:
   - cycle: [supervise, review]
-    threshold: 5
+    threshold: 3
     judge:
       persona: supervisor
       instruction: |
         セキュリティ監査の supervise → review サイクルが {cycle_count} 回繰り返されました。
-        監査の品質と網羅性を総合的に判断し、現状の結果で受け入れるか判断してください。
+        監査レポートを確認し、以下を判断してください:
+        - 監査スコープが前回サイクルから拡大しているか（新しいファイルが監査されたか）
+        - 残りの未監査ファイルは合理的なサイクル数で完了可能か
       rules:
-        - condition: 十分な品質に達している
+        - condition: 監査品質・スコープが十分
           next: COMPLETE
-        - condition: 品質が不十分だが改善の見込みがない
+        - condition: スコープが拡大しており改善が続いている
+          next: review
+        - condition: スコープが停滞し改善の見込みがない
           next: ABORT
 
 steps:
@@ -63,6 +67,10 @@ steps:
     knowledge: security
     instruction: audit-security-review
     edit: false
+    output_contracts:
+      report:
+        - name: 02-audit-security.md
+          format: audit-security
     rules:
       - condition: 再監査完了
         next: supervise

package/builtins/ja/workflows/audit-unit.yaml

@@ -11,16 +11,20 @@ initial_step: plan
 
 loop_monitors:
   - cycle: [supervise, review]
-    threshold: 4
+    threshold: 3
     judge:
       persona: supervisor
       instruction: |
         unit audit の supervise → review サイクルが {cycle_count} 回繰り返されました。
-        監査の完全性と品質を総合的に判断し、現状の結果で受け入れるか判断してください。
+        監査レポートと計画レポートを比較し、以下を判断してください:
+        - 監査スコープが前回サイクルから拡大しているか（新しいファイルや振る舞いが監査されたか）
+        - 残りの未監査項目は合理的なサイクル数で完了可能か
       rules:
-        - condition: 十分な品質に達している
+        - condition: 監査品質・スコープが十分
           next: COMPLETE
-        - condition: 品質が不十分だが改善の見込みがない
+        - condition: スコープが拡大しており改善が続いている
+          next: review
+        - condition: スコープが停滞し改善の見込みがない
           next: ABORT
 
 steps:
@@ -89,6 +93,10 @@ steps:
     knowledge:
       - unit-testing
     instruction: unit-audit-review
+    output_contracts:
+      report:
+        - name: 02-unit-audit.md
+          format: unit-audit
     rules:
       - condition: 再監査完了
         next: supervise

package/builtins/ja/workflows/dual-cqrs-mini.yaml

@@ -61,6 +61,7 @@ steps:
       - coding
       - testing
       - design-fidelity
+      - screen-api
     knowledge:
       - frontend
       - backend
@@ -229,6 +230,7 @@ steps:
       - coding
       - testing
       - design-fidelity
+      - screen-api
     knowledge:
       - frontend
       - backend
@@ -263,6 +265,7 @@ steps:
       - coding
       - testing
       - design-fidelity
+      - screen-api
     knowledge:
       - frontend
       - backend

package/builtins/ja/workflows/dual-cqrs.yaml

@@ -70,6 +70,7 @@ steps:
       - coding
       - testing
       - design-fidelity
+      - screen-api
     session: refresh
     knowledge:
       - frontend
@@ -137,6 +138,7 @@ steps:
       - coding
       - testing
       - design-fidelity
+      - screen-api
     session: refresh
     knowledge:
       - frontend
@@ -283,6 +285,7 @@ steps:
       - coding
       - testing
       - design-fidelity
+      - screen-api
     knowledge:
       - frontend
       - backend
@@ -341,6 +344,7 @@ steps:
       - coding
       - testing
       - design-fidelity
+      - screen-api
     knowledge:
       - frontend
       - backend

package/builtins/ja/workflows/dual-mini.yaml

@@ -60,6 +60,7 @@ steps:
       - coding
       - testing
       - design-fidelity
+      - screen-api
     knowledge:
       - frontend
       - backend
@@ -224,6 +225,7 @@ steps:
       - coding
       - testing
       - design-fidelity
+      - screen-api
     knowledge:
       - frontend
       - backend
@@ -257,6 +259,7 @@ steps:
       - coding
       - testing
       - design-fidelity
+      - screen-api
     knowledge:
       - frontend
       - backend

package/builtins/ja/workflows/dual.yaml

@@ -115,6 +115,7 @@ steps:
       - coding
       - testing
       - design-fidelity
+      - screen-api
     session: refresh
     knowledge:
       - frontend
@@ -201,6 +202,7 @@ steps:
       - coding
       - testing
       - design-fidelity
+      - screen-api
     session: refresh
     knowledge:
       - frontend
@@ -409,6 +411,7 @@ steps:
       - coding
       - testing
       - design-fidelity
+      - screen-api
     knowledge:
       - frontend
       - react

package/builtins/ja/workflows/review-fix-dual-cqrs.yaml

@@ -179,6 +179,7 @@ steps:
       - coding
       - testing
       - design-fidelity
+      - screen-api
     knowledge:
       - frontend
       - backend
@@ -239,6 +240,7 @@ steps:
       - coding
       - testing
       - design-fidelity
+      - screen-api
     knowledge:
       - frontend
       - backend

package/builtins/ja/workflows/review-fix-dual.yaml

@@ -155,6 +155,7 @@ steps:
       - coding
       - testing
       - design-fidelity
+      - screen-api
     knowledge:
       - frontend
       - backend
@@ -214,6 +215,7 @@ steps:
       - coding
       - testing
       - design-fidelity
+      - screen-api
     knowledge:
       - frontend
       - backend

package/builtins/project/dotgitignore

@@ -7,9 +7,9 @@
 # Project configuration
 !config.yaml
 
-# Facets and pieces (version-controlled)
-!pieces/
-!pieces/**
+# Facets and workflows (version-controlled)
+!workflows/
+!workflows/**
 !facets/
 !facets/personas/
 !facets/personas/**

package/builtins/project/tasks/TASK-FORMAT

@@ -24,15 +24,15 @@ Store task metadata in `.takt/tasks.yaml`, and point to the task directory with
     - name: add-auth-feature
       status: pending
       task_dir: .takt/tasks/20260201-015714-foptng
-      piece: default
+      workflow: default
       created_at: "2026-02-01T01:57:14.000Z"
       started_at: null
       completed_at: null
 
 Fields:
   task_dir   (recommended)  Path to task directory that contains `order.md`
-  content    (legacy)       Inline task text (kept for compatibility)
-  content_file (legacy)     Path to task text file (kept for compatibility)
+  content    Inline task text
+  content_file Path to task text file
 
 ## Command Behavior
 

package/builtins/skill/SKILL.md

@@ -11,7 +11,7 @@ user-invocable: true
 $ARGUMENTS を以下のように解析する:
 
 ```
-/takt {piece} [permission] {task...}
+/takt {workflow} [permission] {task...}
 ```
 
 - **第1トークン**: ワークフロー名または YAML ファイルパス（必須）
@@ -43,7 +43,7 @@ $ARGUMENTS を以下のように解析する:
 
 - **自分で作業するな** — コーディング、レビュー、設計、テスト等は全てチームメイトに委任する
 - **タスクを自分で分析して1つの Task にまとめるな** — step を1つずつ順番に実行せよ
-- **step をスキップするな** — 必ず `initial_step`（または互換の `initial_movement`）から開始し、Rule 評価で決まった次の step に進む
+- **step をスキップするな** — 必ず `initial_step` から開始し、Rule 評価で決まった次の step に進む
 - **"yolo" をワークフロー名と誤解するな** — "yolo" は YOLO（You Only Live Once）の俗語で「無謀・適当・いい加減」という意味。「yolo ではレビューして」= 「適当にやらずにちゃんとレビューして」という意味であり、ワークフロー作成の指示ではない
 
 ### あなたの仕事は4つだけ
@@ -79,13 +79,12 @@ $ARGUMENTS を以下のように解析する:
 1. `.yaml` / `.yml` で終わる、または `/` を含む → ファイルパスとして直接 Read
 2. 名前解決:
    - `~/.takt/workflows/{name}.yaml` （ユーザーカスタム、優先）
-   - 互換: `~/.takt/pieces/{name}.yaml`
    - `~/.claude/skills/takt/workflows/{name}.yaml` （Skill 同梱ビルトイン）
 3. 見つからない場合: 上記ディレクトリを Glob で列挙し、AskUserQuestion で選択させる
 
 YAML から以下を抽出する（→ references/yaml-schema.md 参照）:
-- `name`, `max_movements`, `initial_step`, `steps` 配列（互換: `initial_movement`, `movements`）
-- `workflow_config`（ワークフロー全体の provider / runtime 等。`piece_config` も後方互換で受理）
+- `name`, `max_steps`, `initial_step`, `steps` 配列
+- `workflow_config`（ワークフロー全体の provider / runtime 等）
 - セクションマップ: `personas`, `policies`, `instructions`, `output_contracts`, `knowledge`
 
 ### 手順 2: セクションリソースの事前読み込み
@@ -110,7 +109,7 @@ TeamCreate tool を呼ぶ:
 
 ### 手順 4: 初期化
 
-`initial_step`（なければ `initial_movement`、どちらもなければ `steps` の先頭）の名前を確認し、`steps`（互換: `movements`）から該当する step 定義を取得する。
+`initial_step`（なければ `steps` の先頭）の名前を確認し、`steps` から該当する step 定義を取得する。
 **以下の変数を初期化する:**
 - `iteration = 1`
 - `current_step = 上記 initial の step 定義`
@@ -132,7 +131,7 @@ TeamCreate tool を呼ぶ:
 
 ### 手順 5: チームメイト起動
 
-**iteration が max_movements を超えていたら → 手順 8（ABORT: イテレーション上限）に進む。**
+**iteration が max_steps を超えていたら → 手順 8（ABORT: イテレーション上限）に進む。**
 
 current_step のプロンプトを構築する（→ references/engine.md のプロンプト構築を参照）。
 
@@ -224,7 +223,7 @@ matched_rule の `next` を確認する:
 - **`next` が "ABORT"** → **手順 8（ABORT）** に進む
 - **`next` が step 名** → 以下を実行して **手順 5 に戻る**:
   1. `previous_response` = 直前のチームメイト出力
-  2. `current_step` = `next` で指定された step を `steps`（互換: `movements`）配列から取得
+  2. `current_step` = `next` で指定された step を `steps`（互換: `steps`）配列から取得
   3. `iteration` を +1 する
   4. **手順 5 に戻る**
 

package/builtins/skill/references/engine.md

@@ -84,7 +84,7 @@ Task tool:
 4. ---（区切り線）
 5. 実行コンテキスト情報
 6. ナレッジ（knowledge: で参照される .md の内容）
-7. インストラクション内容（instruction: で参照される .md、または instruction_template のインライン内容）
+7. インストラクション内容（instruction: で参照される .md またはインライン文字列）
 8. ユーザーのタスク（{task} が template に含まれない場合、末尾に自動追加）
 9. 前の step の出力（pass_previous_response: true の場合、自動追加）
 10. レポート出力指示（report フィールドがある場合、自動追加）
@@ -124,7 +124,7 @@ step の `knowledge:` キーからナレッジファイルを解決し、ドメ
 
 ### インストラクション
 
-step の `instruction:` キーから指示テンプレートファイルを解決する。または `instruction_template:` でインライン記述。テンプレート変数（{task}, {previous_response} 等）を展開した上でプロンプトに含める。
+step の `instruction:` キーから指示内容を解決する。テンプレート変数（{task}, {previous_response} 等）を展開した上でプロンプトに含める。
 
 ### 実行コンテキスト情報
 
@@ -133,8 +133,8 @@ step の `instruction:` キーから指示テンプレートファイルを解
 - ワーキングディレクトリ: {cwd}
 - ワークフロー (YAML の name): {workflow_name}
 - Step: {step_name}
-- イテレーション: {iteration} / {max_movements}
-- Step 実行回数（テンプレート変数は {movement_iteration} のまま）: {movement_iteration} 回目
+- イテレーション: {iteration} / {max_steps}
+- Step 実行回数: {step_iteration} 回目
 ```
 
 ### テンプレート変数の展開
@@ -146,8 +146,8 @@ step の `instruction:` キーから指示テンプレートファイルを解
 | `{task}` | ユーザーが入力したタスク内容 |
 | `{previous_response}` | 前の step のチームメイト出力 |
 | `{iteration}` | ワークフロー全体のイテレーション数（1始まり） |
-| `{max_movements}` | ワークフローの max_movements 値 |
-| `{movement_iteration}` | この step が実行された回数（1始まり） |
+| `{max_steps}` | ワークフローの max_steps 値 |
+| `{step_iteration}` | この step が実行された回数（1始まり） |
 | `{report_dir}` | レポートディレクトリパス（`.takt/runs/{slug}/reports`） |
 | `{report:ファイル名}` | 指定レポートファイルの内容（Read で取得） |
 
@@ -317,7 +317,7 @@ parallel のサブステップにも同様にタグ出力指示を注入する
 ### 基本ルール
 
 - 同じ step が連続3回以上実行されたら警告を表示する
-- `max_movements` に到達したら強制終了（ABORT）する
+- `max_steps` に到達したら強制終了（ABORT）する
 
 ### カウンター管理
 
@@ -326,7 +326,7 @@ parallel のサブステップにも同様にタグ出力指示を注入する
 | カウンター | 説明 | リセットタイミング |
 |-----------|------|-------------------|
 | `iteration` | ワークフロー全体の step 実行回数 | リセットしない |
-| `movement_iteration[name]` | 各 step の実行回数 | リセットしない |
+| `step_iteration[name]` | 各 step の実行回数 | リセットしない |
 | `consecutive_count[name]` | 同じ step の連続実行回数 | 別の step に遷移したとき |
 
 ## Loop Monitors
@@ -341,7 +341,7 @@ loop_monitors:
     threshold: 3
     judge:
       persona: supervisor
-      instruction_template: |
+      instruction: |
         サイクルが {cycle_count} 回繰り返されました...
       rules:
         - condition: 健全
@@ -356,7 +356,7 @@ loop_monitors:
 2. 各 loop_monitor の `cycle` パターンが履歴の末尾に `threshold` 回以上連続で出現するかチェックする
 3. 閾値に達した場合:
    a. judge の `persona` キーからペルソナファイルを Read で読み込む
-   b. `instruction_template` の `{cycle_count}` を実際のサイクル回数に置換する
+   b. `instruction` の `{cycle_count}` を実際のサイクル回数に置換する
    c. Task tool でチームメイト（judge）を起動する
    d. judge の出力を judge の `rules` で評価する
    e. マッチした rule の `next` に遷移する（通常のルール評価をオーバーライドする）
@@ -404,7 +404,7 @@ TeamCreate でチーム作成
   ↓
 実行ディレクトリ作成
   ↓
-initial_step を取得（YAML が `initial_movement` のみの場合はそれを使う）
+initial_step を取得
   ↓
 ┌─→ Task tool でチームメイト起動
 │     ├── 通常: 1つの Task tool 呼び出し

package/builtins/skill/references/yaml-schema.md

@@ -1,13 +1,13 @@
 # ワークフローYAML スキーマリファレンス
 
-このドキュメントは workflow YAML（旧称ピースYAML）の構造を定義する。具体的な workflow 定義は含まない。
+このドキュメントは workflow YAML の構造を定義する。具体的な workflow 定義は含まない。
 
 ## トップレベルフィールド
 
 ```yaml
-name: workflow-name           # workflow 名（必須）。カテゴリの workflow_categories 下の workflows でもこの名前を使う（互換: piece_categories / pieces）
+name: workflow-name           # workflow 名（必須）。カテゴリの workflow_categories 下の workflows でもこの名前を使う
 description: 説明テキスト      # 任意
-max_movements: 10            # 最大イテレーション数（省略時デフォルトあり）
+max_steps: 10                 # 最大イテレーション数（省略時デフォルトあり）
 initial_step: plan            # 最初に実行する step 名（省略時は steps の先頭）
 
 # ワークフロー全体の provider / runtime 等
@@ -36,8 +36,6 @@ steps: [...]                  # step 定義の配列（推奨キー名）
 loop_monitors: [...]          # ループ監視設定（任意）。cycle には step 名を並べる
 ```
 
-**互換 alias:** `movements` は `steps` と同義（両方書く場合は内容が一致している必要がある）。`initial_movement` は `initial_step` と同義（両方書く場合は同じ名前である必要がある）。
-
 ### セクションマップの解決
 
 各セクションマップのパスは **workflow YAML ファイルのディレクトリからの相対パス** で解決する。
@@ -89,7 +87,7 @@ step 定義内では**キー名**で参照する（パスを直接書かない
     指示内容...
 ```
 
-**`instruction`（正式） / `instruction_template`（deprecated）**: どちらも同じ参照解決ルート（セクションマップ → パス → 3-layer facet → インライン）を使う。`instruction_template` も互換のため受理されるが、新規定義では `instruction` を使う。
+**`instruction`**: セクションマップ → パス → 3-layer facet → インラインの順で解決する正式フィールド。`instruction_template` は受理されない。
 
 ### Parallel step（親 + `parallel`）
 
@@ -219,8 +217,8 @@ quality_gates:
 | `{task}` | ユーザーのタスク入力（template に含まれない場合は自動追加） |
 | `{previous_response}` | 前の step の出力（pass_previous_response: true 時、自動追加） |
 | `{iteration}` | workflow 全体のイテレーション数 |
-| `{max_movements}` | 最大イテレーション数（テンプレート変数名は従来どおり） |
-| `{movement_iteration}` | この step の実行回数（テンプレート変数名は従来どおり） |
+| `{max_steps}` | 最大イテレーション数 |
+| `{step_iteration}` | この step の実行回数 |
 | `{report_dir}` | レポートディレクトリ名 |
 | `{report:ファイル名}` | 指定レポートファイルの内容を展開 |
 | `{user_inputs}` | 蓄積されたユーザー入力 |