takt 0.33.2 → 0.35.0

package/builtins/skill-codex/SKILL.md

@@ -1,11 +1,11 @@
 ---
 name: takt
 description: >
-  TAKT ピースエンジン。codex exec でサブエージェントを起動し、ピース YAML ワークフローに従って
+  TAKT ワークフローエンジン。codex exec でサブエージェントを起動し、ワークフロー YAML（steps / initial_step）に従って
   マルチエージェントオーケストレーションを実行する。
 ---
 
-# TAKT Piece Engine
+# TAKT Workflow Engine
 
 ## 引数の解析
 
@@ -15,7 +15,7 @@ $ARGUMENTS を以下のように解析する:
 $takt {piece} [permission] {task...}
 ```
 
-- **第1トークン**: ピース名またはYAMLファイルパス（必須）
+- **第1トークン**: ワークフロー名または YAML ファイルパス（必須）
 - **第2トークン**: 権限モード（任意）。以下のキーワードの場合は権限モードとして解釈する:
   - `--permit-full` - `codex exec --sandbox danger-full-access`
   - `--permit-edit` - `codex exec --full-auto`
@@ -24,8 +24,8 @@ $takt {piece} [permission] {task...}
 - **権限モード省略時のデフォルト**: `default`（`codex exec (オプションなし)`）
 
 例:
-- `$takt coding FizzBuzzを作って` → coding ピース、default 権限
-- `$takt coding --permit-full FizzBuzzを作って` → coding ピース、danger-full-access
+- `$takt coding FizzBuzzを作って` → coding ワークフロー、default 権限
+- `$takt coding --permit-full FizzBuzzを作って` → coding ワークフロー、danger-full-access
 - `$takt /path/to/custom.yaml 実装して` → カスタムYAML、default 権限
 
 ## 事前準備: リファレンスの読み込み
@@ -33,26 +33,26 @@ $takt {piece} [permission] {task...}
 手順を開始する前に、以下の2ファイルを **Read tool で読み込む**:
 
 1. `~/.agents/skills/takt/references/engine.md` - プロンプト構築、レポート管理、ループ検出の詳細
-2. `~/.agents/skills/takt/references/yaml-schema.md` - ピースYAMLの構造定義
+2. `~/.agents/skills/takt/references/yaml-schema.md` - ワークフロー YAML の構造定義
 
 ## あなたの役割: Team Lead
 
 あなたは **Team Lead（オーケストレーター）** である。
-ピースYAMLに定義されたワークフロー（状態遷移マシン）に従って movement を実行する。
+ワークフロー YAML に定義された状態遷移に従って step を実行する。
 
 ### 禁止事項
 
 - **自分で作業するな** - コーディング、レビュー、設計、テスト等は全てサブエージェントに委任する
-- **タスクを自分で分析して1つの実装にまとめるな** - movement を1つずつ順番に実行せよ
-- **movement をスキップするな** - 必ず initial_movement から開始し、Rule 評価で決まった次の movement に進む
-- **"yolo" をピース名と誤解するな** - "yolo" は YOLO（You Only Live Once）の俗語で「無謀・適当・いい加減」という意味。「yolo ではレビューして」= 「適当にやらずにちゃんとレビューして」という意味であり、ピース作成の指示ではない
+- **タスクを自分で分析して1つの実装にまとめるな** - step を1つずつ順番に実行せよ
+- **step をスキップするな** - 必ず `initial_step`（または互換の `initial_movement`）から開始し、Rule 評価で決まった次の step に進む
+- **"yolo" をワークフロー名と誤解するな** - "yolo" は YOLO（You Only Live Once）の俗語で「無謀・適当・いい加減」という意味。「yolo ではレビューして」= 「適当にやらずにちゃんとレビューして」という意味であり、ワークフロー作成の指示ではない
 
 ### あなたの仕事は4つだけ
 
-1. ピースYAML を読んでワークフローを理解する
-2. 各 movement のプロンプトを構築する（references/engine.md 参照）
+1. ワークフロー YAML を読んで遷移を理解する
+2. 各 step のプロンプトを構築する（references/engine.md 参照）
 3. **Write tool + Bash tool (`codex exec`)** でサブエージェントを起動して作業を委任する
-4. サブエージェントの出力から Rule 評価を行い、次の movement を決定する
+4. サブエージェントの出力から Rule 評価を行い、次の step を決定する
 
 **重要**: ユーザーが明示的に指示するまで git commit を実行してはならない。実装完了 ≠ コミット許可。
 
@@ -60,50 +60,52 @@ $takt {piece} [permission] {task...}
 
 | やること | 使うツール | 説明 |
 |---------|-----------|------|
-| プロンプト一時保存 | **Write** tool | movement名を含めない安全なランダム名（例: `/tmp/takt-prompt-{timestamp}-{uuid}.md`）で書き出す |
+| プロンプト一時保存 | **Write** tool | step 名を含めない安全なランダム名（例: `/tmp/takt-prompt-{timestamp}-{uuid}.md`）で書き出す |
 | サブエージェント起動 | **Bash** tool | `codex exec {権限オプション} - < /tmp/...` を実行 |
 
 ## 手順（この順序で厳密に実行せよ）
 
-### 手順 1: ピース解決と読み込み
+### 手順 1: ワークフロー解決と読み込み
 
-引数の第1トークンからピースYAMLファイルを特定して Read で読む。
+引数の第1トークンからワークフロー YAML ファイルを特定して Read で読む。
 
-**第1トークンがない場合（ピース名未指定）:**
-→ ユーザーに「ピース名を指定してください。例: `$takt coding タスク内容`」と伝えて終了する。
+**第1トークンがない場合（ワークフロー名未指定）:**
+→ ユーザーに「ワークフロー名を指定してください。例: `$takt coding タスク内容`」と伝えて終了する。
 
-**ピースYAMLの検索順序:**
+**ワークフロー YAML の検索順序:**
 1. `.yaml` / `.yml` で終わる、または `/` を含む → ファイルパスとして直接 Read
-2. ピース名として検索:
-   - `~/.takt/pieces/{name}.yaml` （ユーザーカスタム、優先）
-   - `~/.agents/skills/takt/pieces/{name}.yaml` （Skill同梱ビルトイン）
-3. 見つからない場合: 上記2ディレクトリを Glob で列挙し、AskUserQuestion で選択させる
-
-YAMLから以下を抽出する（→ references/yaml-schema.md 参照）:
-- `name`, `max_movements`, `initial_movement`, `movements` 配列
+2. 名前解決:
+   - `~/.takt/workflows/{name}.yaml` （ユーザーカスタム、優先）
+   - 互換: `~/.takt/pieces/{name}.yaml`
+   - `~/.agents/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` も後方互換で受理）
 - セクションマップ: `personas`, `policies`, `instructions`, `output_contracts`, `knowledge`
 
 ### 手順 2: セクションリソースの事前読み込み
 
-ピースYAMLのセクションマップ（`personas:`, `policies:`, `instructions:`, `output_contracts:`, `knowledge:`）から全ファイルパスを収集する。
-パスは **ピースYAMLファイルのディレクトリからの相対パス** で解決する。
+ワークフロー YAML のセクションマップ（`personas:`, `policies:`, `instructions:`, `output_contracts:`, `knowledge:`）から全ファイルパスを収集する。
+パスは **ワークフロー YAML ファイルのディレクトリからの相対パス** で解決する。
 
-例: ピースが `~/.agents/skills/takt/pieces/default.yaml` にあり、`personas:` に `coder: ../facets/personas/coder.md` がある場合
+例: ワークフローが `~/.agents/skills/takt/workflows/default.yaml` にあり、`personas:` に `coder: ../facets/personas/coder.md` がある場合
 → 絶対パスは `~/.agents/skills/takt/facets/personas/coder.md`
 
 重複を除いて Read で全て読み込む。読み込んだ内容はサブエージェントへのプロンプト構築に使う。
 
 ### 手順 3: 初期化
 
-`initial_movement` の名前を確認し、`movements` 配列から該当する movement を取得する。
+`initial_step`（なければ `initial_movement`、どちらもなければ `steps` の先頭）の名前を確認し、`steps`（互換: `movements`）から該当する step 定義を取得する。
 **以下の変数を初期化する:**
 - `iteration = 1`
-- `current_movement = initial_movement の movement 定義`
+- `current_step = 上記 initial の step 定義`
 - `previous_response = ""`
 - `permission_mode = コマンドで解析された権限モード（"danger-full-access" / "full-auto" / "default"）`
-- `movement_history = []`（遷移履歴。Loop Monitor 用）
+- `step_history = []`（遷移履歴。Loop Monitor 用）
 
-**実行ディレクトリ**: いずれかの movement に `report` フィールドがある場合、`.takt/runs/{YYYYMMDD-HHmmss}-{slug}/` を作成し、以下を配置する。
+**実行ディレクトリ**: いずれかの step に `report` フィールドがある場合、`.takt/runs/{YYYYMMDD-HHmmss}-{slug}/` を作成し、以下を配置する。
 - `reports/`（レポート出力）
 - `context/knowledge/`（Knowledge スナップショット）
 - `context/policy/`（Policy スナップショット）
@@ -119,20 +121,20 @@ YAMLから以下を抽出する（→ references/yaml-schema.md 参照）:
 
 **iteration が max_movements を超えていたら → 手順 7（ABORT: イテレーション上限）に進む。**
 
-current_movement のプロンプトを構築する（→ references/engine.md のプロンプト構築を参照）。
+current_step のプロンプトを構築する（→ references/engine.md のプロンプト構築を参照）。
 
 プロンプト構築の要素:
 1. **ペルソナ**: `persona:` キー → `personas:` セクション → .md ファイル内容
 2. **ポリシー**: `policy:` キー → `policies:` セクション → .md ファイル内容（複数可、末尾にリマインダー再掲）
-3. **実行コンテキスト**: cwd, ピース名, movement名, イテレーション情報
+3. **実行コンテキスト**: cwd, ワークフロー名, step 名, イテレーション情報
 4. **ナレッジ**: `knowledge:` キー → `knowledge:` セクション → .md ファイル内容
 5. **インストラクション**: `instruction:` キー → `instructions:` セクション → .md ファイル内容（テンプレート変数展開済み）
 6. **タスク/前回出力/レポート指示/タグ指示**: 自動注入
 
-**通常 movement の場合（parallel フィールドなし）:**
+**通常 step の場合（parallel フィールドなし）:**
 
 1. Write tool でプロンプトを一時ファイルに保存する。
-   - movement名やsubstep名をファイル名に含めず、`/tmp/takt-prompt-{timestamp}-{uuid}.md` のような安全なランダム名を使う
+   - step 名や substep 名をファイル名に含めず、`/tmp/takt-prompt-{timestamp}-{uuid}.md` のような安全なランダム名を使う
 2. Bash tool で `codex exec` を実行する。
    - `--permit-full` の場合: `codex exec --sandbox danger-full-access - < "$tmp_prompt_file"`
    - `--permit-edit` の場合: `codex exec --full-auto - < "$tmp_prompt_file"`
@@ -140,7 +142,7 @@ current_movement のプロンプトを構築する（→ references/engine.md
 3. `stdout` をサブエージェント出力として扱う。
 4. **手順 5** に進む。
 
-**parallel movement の場合:**
+**parallel step の場合:**
 
 1. parallel 配列の各サブステップ用プロンプトをそれぞれ安全なランダム名（例: `/tmp/takt-parallel-{timestamp}-{uuid}.md`）で保存する。
 2. **1つのメッセージで**、サブステップ数分の Bash tool (`codex exec`) を並列実行する。
@@ -154,12 +156,12 @@ codex exec --full-auto - < "$tmp_prompt_file_2"
 
 ### 手順 5: レポート抽出と Loop Monitor
 
-**レポート抽出**（current_movement に `report` フィールドがある場合のみ）:
+**レポート抽出**（current_step に `report` フィールドがある場合のみ）:
 サブエージェント出力から ```markdown ブロックを抽出し、Write tool で `{report_dir}/{ファイル名}` に保存する。
 詳細は references/engine.md の「レポートの抽出と保存」を参照。
 
-**Loop Monitor チェック**（ピースに `loop_monitors` がある場合のみ）:
-`movement_history` に current_movement の名前を追加する。
+**Loop Monitor チェック**（ワークフローに `loop_monitors` がある場合のみ）:
+`step_history` に current_step の名前を追加する。
 遷移履歴が loop_monitor の `cycle` パターンに `threshold` 回以上マッチした場合、judge サブエージェントを起動して遷移先をオーバーライドする。
 詳細は references/engine.md の「Loop Monitors」を参照。
 
@@ -167,15 +169,15 @@ codex exec --full-auto - < "$tmp_prompt_file_2"
 
 `codex exec` から返ってきたサブエージェント出力から matched_rule を決定する。
 
-**通常 movement:**
+**通常 step:**
 1. 出力に `[STEP:N]` タグがあるか探す（複数ある場合は最後のタグを採用）
 2. タグがあれば → rules[N] を選択（0始まりインデックス）
 3. タグがなければ → 出力全体を読み、全 condition と比較して最も近いものを選択
 
-**parallel movement:**
+**parallel step:**
 1. 各サブステップの `codex exec` 出力に対して、サブステップの rules で条件マッチを判定
 2. マッチした condition 文字列を記録
-3. 親 movement の rules で aggregate 評価:
+3. 親 step の rules で aggregate 評価:
    - `all("X")`: 全サブステップが "X" にマッチしたら true
    - `any("X")`: いずれかのサブステップが "X" にマッチしたら true
    - `all("X", "Y")`: サブステップ1が "X"、サブステップ2が "Y" にマッチしたら true
@@ -184,7 +186,7 @@ codex exec --full-auto - < "$tmp_prompt_file_2"
 matched_rule が決まったら次に進む。
 - `next = COMPLETE` → **手順 7（COMPLETE）**
 - `next = ABORT` → **手順 7（ABORT）**
-- `next = movement 名` → `previous_response` 更新、`iteration += 1`、次 movement を取得して **手順 4** に戻る
+- `next = step 名` → `previous_response` 更新、`iteration += 1`、次 step を `steps`（互換: `movements`）から取得して **手順 4** に戻る
 
 どの rule にもマッチしなかったら → **手順 7（ABORT: ルール不一致）** に進む。
 
@@ -200,4 +202,4 @@ matched_rule が決まったら次に進む。
 | ファイル | 内容 |
 |---------|------|
 | `references/engine.md` | プロンプト構築、レポート管理、ループ検出の詳細 |
-| `references/yaml-schema.md` | ピースYAMLの構造定義とフィールド説明 |
+| `references/yaml-schema.md` | ワークフロー YAML の構造定義とフィールド説明 |

package/builtins/skill-codex/references/engine.md

@@ -2,14 +2,14 @@
 
 ## サブエージェントの起動方法
 
-全ての movement は `codex exec` でサブエージェントを起動して実行する。
+全ての step は `codex exec` でサブエージェントを起動して実行する。
 **あなた（Team Lead）が直接作業することは禁止。**
 
 ### 実行フロー（Write + Bash）
 
 1. プロンプト全文を一時ファイルへ保存する
 2. Bash tool で `codex exec` を実行する
-3. `stdout` を movement の出力として扱う
+3. `stdout` を step の出力として扱う
 
 ```bash
 # 例
@@ -30,27 +30,27 @@ codex exec --full-auto - < "$tmp_prompt_file"
   - `permission_mode = "default"`
   - 実行: `codex exec - < /tmp/...`
 
-## 通常 Movement の実行
+## 通常 step の実行
 
-通常の movement（`parallel` フィールドなし）は、`codex exec` を1回実行する。
+通常の step（`parallel` フィールドなし）は、`codex exec` を1回実行する。
 
 1. プロンプトを構築する（後述の「プロンプト構築」参照）
-2. movement名を含めない安全なランダム名（例: `/tmp/takt-prompt-{timestamp}-{uuid}.md`）で保存する
+2. step 名を含めない安全なランダム名（例: `/tmp/takt-prompt-{timestamp}-{uuid}.md`）で保存する
 3. `codex exec {権限オプション} - < /tmp/...` を実行する
-4. `stdout` を受け取り Rule 評価で次 movement を決定する
+4. `stdout` を受け取り Rule 評価で次の step を決定する
 
-## Parallel Movement の実行
+## Parallel step の実行
 
-`parallel` フィールドを持つ movement は、複数サブステップを並列実行する。
+`parallel` フィールドを持つ step は、複数サブステップを並列実行する。
 
 ### 実行手順
 
 1. parallel 配列の各サブステップごとにプロンプトを構築する
-2. 各プロンプトを substep名を含めない安全なランダム名で保存する
+2. 各プロンプトをサブステップ名を含めない安全なランダム名で保存する
 3. **1つのメッセージで** サブステップ数分の Bash tool（`codex exec`）を並列実行する
 4. 各 `stdout` を収集する
 5. 各サブステップの `rules` で条件マッチを判定する
-6. 親 movement の `rules` で aggregate 評価（`all()` / `any()`）を行う
+6. 親 step の `rules` で aggregate 評価（`all()` / `any()`）を行う
 
 ### サブステップ条件マッチ判定
 
@@ -59,32 +59,32 @@ codex exec --full-auto - < "$tmp_prompt_file"
 1. `[STEP:N]` タグがあればインデックスで照合（最後のタグを採用）
 2. タグがなければ出力全文と条件文の意味一致で判定
 
-マッチした condition 文字列を記録し、親 movement の aggregate 評価に使う。
+マッチした condition 文字列を記録し、親 step の aggregate 評価に使う。
 
 ## セクションマップの解決
 
-ピースYAMLトップレベルの `personas:`, `policies:`, `instructions:`, `output_contracts:`, `knowledge:` はキーとファイルパスの対応表。movement 内ではキー名で参照する。
+ワークフロー YAML トップレベルの `personas:`, `policies:`, `instructions:`, `output_contracts:`, `knowledge:` はキーとファイルパスの対応表。step 定義内ではキー名で参照する。
 
 ### 解決手順
 
-1. ピースYAMLを読み込む
-2. 各セクションマップのパスを、**ピースYAMLファイルのディレクトリ基準**で絶対パスへ変換する
-3. movement のキー参照（例: `persona: coder`）から実ファイルを Read で取得する
+1. ワークフロー YAML を読み込む
+2. 各セクションマップのパスを、**ワークフロー YAML ファイルのディレクトリ基準**で絶対パスへ変換する
+3. step のキー参照（例: `persona: coder`）から実ファイルを Read で取得する
 
-例: ピースが `~/.agents/skills/takt/pieces/default.yaml` の場合
+例: ワークフロー YAML が `~/.agents/skills/takt/workflows/default.yaml` にある場合
 - `personas.coder: ../facets/personas/coder.md` → `~/.agents/skills/takt/facets/personas/coder.md`
 - `policies.coding: ../facets/policies/coding.md` → `~/.agents/skills/takt/facets/policies/coding.md`
 - `instructions.plan: ../facets/instructions/plan.md` → `~/.agents/skills/takt/facets/instructions/plan.md`
 
 ## プロンプト構築
 
-各 movement 実行時、以下を上から順に結合してプロンプトを作る。
+各 step 実行時、以下を上から順に結合してプロンプトを作る。
 
 1. ペルソナ（`persona:` 参照先 .md 全文）
 2. 区切り線 `---`
 3. ポリシー（`policy:` 参照先 .md。複数可）
 4. 区切り線 `---`
-5. 実行コンテキスト（cwd / piece / movement / iteration）
+5. 実行コンテキスト（cwd / workflow name / step / iteration）
 6. ナレッジ（`knowledge:` 参照先 .md）
 7. インストラクション（`instruction:` または `instruction_template:`）
 8. タスク（`{task}` 未使用時は末尾に自動追加）
@@ -98,16 +98,16 @@ codex exec --full-auto - < "$tmp_prompt_file"
 インストラクション内のプレースホルダーを置換する。
 
 - `{task}`: ユーザー入力タスク
-- `{previous_response}`: 前 movement 出力
-- `{iteration}`: ピース全体イテレーション
+- `{previous_response}`: 前 step 出力
+- `{iteration}`: ワークフロー全体イテレーション
 - `{max_movements}`: 最大イテレーション数
-- `{movement_iteration}`: 当該 movement 実行回数
+- `{movement_iteration}`: 当該 step 実行回数（変数名は従来どおり）
 - `{report_dir}`: `.takt/runs/{slug}/reports`
 - `{report:ファイル名}`: 指定レポート内容（存在しない場合は `（レポート未作成）`）
 
 ## レポート出力指示と保存
 
-movement がレポートを要求する場合、プロンプト末尾に必須指示を注入する。
+step がレポートを要求する場合、プロンプト末尾に必須指示を注入する。
 
 ### 形式1: name + format
 
@@ -144,7 +144,7 @@ report:
 
 ## ステータスタグ出力指示
 
-movement に `rules` がある場合、最後に1つだけタグを出力するよう指示する。
+step に `rules` がある場合、最後に1つだけタグを出力するよう指示する。
 
 ```text
 [STEP:0] = {rules[0].condition}
@@ -157,13 +157,13 @@ movement に `rules` がある場合、最後に1つだけタグを出力する
 
 ## Rule 評価
 
-### 通常 Movement
+### 通常 step
 
 1. 出力中の `[STEP:N]` を検出（複数なら最後を採用）
 2. 該当 index の rule を採用
 3. タグがない場合は全文を読み condition と意味照合して最も近い rule を採用
 
-### Parallel Movement（Aggregate）
+### Parallel step（Aggregate）
 
 - `all("X")`: 全サブステップが `X` に一致
 - `any("X")`: いずれかが `X` に一致
@@ -179,20 +179,20 @@ movement に `rules` がある場合、最後に1つだけタグを出力する
 
 ### 基本
 
-- 同じ movement が連続3回以上なら警告
+- 同じ step が連続3回以上なら警告
 - `max_movements` 到達で ABORT
 
 ### カウンター
 
 - `iteration`: 全体実行回数
-- `movement_iteration[name]`: movement 別実行回数
+- `movement_iteration[name]`: step 別実行回数
 - `consecutive_count[name]`: 連続実行回数
 
 ## Loop Monitors
 
 `loop_monitors` がある場合、指定サイクルを監視する。
 
-1. movement 遷移履歴を記録する
+1. step 遷移履歴を記録する
 2. `cycle` が `threshold` 回以上連続出現したら judge を実行する
 3. judge は `persona` + `instruction_template` + `rules` でプロンプト構築する
 4. judge も同じく `codex exec` で起動する
@@ -203,13 +203,13 @@ movement に `rules` がある場合、最後に1つだけタグを出力する
 ```text
 [開始]
   ↓
-ピースYAML読み込み + セクションマップ解決
+ワークフロー YAML 読み込み + セクションマップ解決
   ↓
 実行ディレクトリ作成
   ↓
-initial_movement 取得
+initial_step 取得（YAML が `initial_movement` のみならそれを使う）
   ↓
-┌─→ codex exec で movement 実行（通常/parallel）
+┌─→ codex exec で step 実行（通常/parallel）
 │   ↓
 │   出力受信
 │   ↓
@@ -222,7 +222,7 @@ initial_movement 取得
 │   next 決定
 │     ├── COMPLETE → 終了報告
 │     ├── ABORT → エラー報告
-│     └── movement名 → 次 movement
+│     └── step名 → 次の step
 │                      ↓
 └──────────────────────┘
 ```

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

@@ -1,14 +1,20 @@
-# ピースYAML スキーマリファレンス
+# ワークフローYAML スキーマリファレンス
 
-このドキュメントはピースYAMLの構造を定義する。具体的なピース定義は含まない。
+このドキュメントは workflow YAML（旧称ピースYAML）の構造を定義する。具体的な workflow 定義は含まない。
 
 ## トップレベルフィールド
 
 ```yaml
-name: piece-name              # ピース名（必須）
-description: 説明テキスト      # ピースの説明（任意）
-max_movements: 10            # 最大イテレーション数（必須）
-initial_movement: plan        # 最初に実行する movement 名（必須）
+name: workflow-name           # workflow 名（必須）。カテゴリの workflow_categories 下の workflows でもこの名前を使う（互換: piece_categories / pieces）
+description: 説明テキスト      # 任意
+max_movements: 10            # 最大イテレーション数（省略時デフォルトあり）
+initial_step: plan            # 最初に実行する step 名（省略時は steps の先頭）
+
+# ワークフロー全体の provider / runtime 等
+workflow_config:
+  provider_options:
+    codex:
+      network_access: true
 
 # セクションマップ（キー → ファイルパスの対応表）
 policies:                     # ポリシー定義（任意）
@@ -26,25 +32,27 @@ report_formats:               # レポートフォーマット定義（任意）
 knowledge:                    # ナレッジ定義（任意）
   architecture: ../knowledge/architecture.md
 
-movements: [...]              # movement 定義の配列（必須）
-loop_monitors: [...]          # ループ監視設定（任意）
+steps: [...]                  # step 定義の配列（推奨キー名）
+loop_monitors: [...]          # ループ監視設定（任意）。cycle には step 名を並べる
 ```
 
+**互換 alias:** `movements` は `steps` と同義（両方書く場合は内容が一致している必要がある）。`initial_movement` は `initial_step` と同義（両方書く場合は同じ名前である必要がある）。
+
 ### セクションマップの解決
 
-各セクションマップのパスは **ピースYAMLファイルのディレクトリからの相対パス** で解決する。
-movement 内では**キー名**で参照する（パスを直接書かない）。
+各セクションマップのパスは **workflow YAML ファイルのディレクトリからの相対パス** で解決する。
+step 定義内では**キー名**で参照する（パスを直接書かない）。
 
-例: ピースが `~/.claude/skills/takt/pieces/coding.yaml` にあり、`personas:` セクションに `coder: ../personas/coder.md` がある場合
-→ 絶対パスは `~/.claude/skills/takt/personas/coder.md`
-→ movement では `persona: coder` で参照
+例: workflow が `{スキルルート}/workflows/coding.yaml` にあり、`personas:` セクションに `coder: ../personas/coder.md` がある場合
+→ 絶対パスは `{スキルルート}/personas/coder.md`（`スキルルート` は Claude Code では `~/.claude/skills/takt`、Codex では `~/.agents/skills/takt` など、インストール先に応じて置き換える）
+→ step では `persona: coder` で参照
 
-## Movement 定義
+## Step 定義（`steps` の各要素）
 
-### 通常 Movement
+### 通常の step
 
 ```yaml
-- name: movement-name          # movement 名（必須、一意）
+- name: step-name              # step 名（必須、workflow 内で一意）
   persona: coder               # ペルソナキー（personas マップを参照、任意）
   policy: coding               # ポリシーキー（policies マップを参照、任意）
   instruction: implement       # 指示（instructions マップのキー参照、またはインライン、任意）
@@ -62,32 +70,32 @@ movement 内では**キー名**で参照する（パスを直接書かない）
 複数ポリシー指定（配列）:
 
 ```yaml
-- name: movement-name
+- name: step-name
   policy: [coding, testing]
 ```
 
 参照形式:
 
 ```yaml
-- name: movement-name
+- name: step-name
   instruction: implement
 ```
 
 インライン形式:
 
 ```yaml
-- name: movement-name
+- name: step-name
   instruction: |
     指示内容...
 ```
 
 **`instruction`（正式） / `instruction_template`（deprecated）**: どちらも同じ参照解決ルート（セクションマップ → パス → 3-layer facet → インライン）を使う。`instruction_template` も互換のため受理されるが、新規定義では `instruction` を使う。
 
-### Parallel Movement
+### Parallel step（親 + `parallel`）
 
 ```yaml
-- name: reviewers              # 親 movement 名（必須）
-  parallel:                    # 並列サブステップ配列（これがあると parallel movement）
+- name: reviewers              # 親 step 名（必須）
+  parallel:                    # 並列サブステップ配列（これがあると parallel step）
     - name: arch-review
       persona: architecture-reviewer
       policy: review
@@ -125,7 +133,7 @@ movement 内では**キー名**で参照する（パスを直接書かない）
 ```yaml
 rules:
   - condition: 条件テキスト      # マッチ条件（必須）
-    next: next-movement         # 遷移先 movement 名（必須、サブステップでは任意）
+    next: next-step             # 遷移先 step 名（必須、parallel 子では任意）
     requires_user_input: true   # ユーザー入力が必要（任意）
     interactive_only: true      # インタラクティブモードのみ（任意）
     appendix: |                 # 追加情報（任意）
@@ -146,13 +154,13 @@ rules:
 
 | 値 | 意味 |
 |---|------|
-| `COMPLETE` | ピース成功終了 |
-| `ABORT` | ピース失敗終了 |
-| movement 名 | 指定された movement に遷移 |
+| `COMPLETE` | workflow 成功終了 |
+| `ABORT` | workflow 失敗終了 |
+| step 名 | 指定された step に遷移 |
 
 ## Output Contracts 定義
 
-Movement の出力契約（レポート定義）。`output_contracts.report` 配列形式で指定する。
+Step の出力契約（レポート定義）。`output_contracts.report` 配列形式で指定する。
 
 ### 形式1: name + format（フォーマット参照）
 
@@ -191,7 +199,7 @@ output_contracts:
 
 ## Quality Gates 定義
 
-Movement 完了時の品質要件を AI への指示として定義する。自動検証は行わない。
+Step 完了時の品質要件を AI への指示として定義する。自動検証は行わない。
 
 ```yaml
 quality_gates:
@@ -200,7 +208,7 @@ quality_gates:
   - ESLint 違反がないこと
 ```
 
-配列で複数の品質基準を指定できる。エージェントはこれらの基準を満たしてから Movement を完了する必要がある。
+配列で複数の品質基準を指定できる。エージェントはこれらの基準を満たしてから step を完了する必要がある。
 
 ## テンプレート変数
 
@@ -209,10 +217,10 @@ quality_gates:
 | 変数 | 説明 |
 |-----|------|
 | `{task}` | ユーザーのタスク入力（template に含まれない場合は自動追加） |
-| `{previous_response}` | 前の movement の出力（pass_previous_response: true 時、自動追加） |
-| `{iteration}` | ピース全体のイテレーション数 |
-| `{max_movements}` | 最大イテレーション数 |
-| `{movement_iteration}` | この movement の実行回数 |
+| `{previous_response}` | 前の step の出力（pass_previous_response: true 時、自動追加） |
+| `{iteration}` | workflow 全体のイテレーション数 |
+| `{max_movements}` | 最大イテレーション数（テンプレート変数名は従来どおり） |
+| `{movement_iteration}` | この step の実行回数（テンプレート変数名は従来どおり） |
 | `{report_dir}` | レポートディレクトリ名 |
 | `{report:ファイル名}` | 指定レポートファイルの内容を展開 |
 | `{user_inputs}` | 蓄積されたユーザー入力 |
@@ -222,7 +230,7 @@ quality_gates:
 
 ```yaml
 loop_monitors:
-  - cycle: [movement_a, movement_b]   # 監視対象の movement サイクル
+  - cycle: [step_a, step_b]           # 監視対象の step 名のサイクル
     threshold: 3                       # 発動閾値（サイクル回数）
     judge:
       persona: supervisor              # ペルソナキー参照
@@ -231,13 +239,13 @@ loop_monitors:
         健全性を判断してください。
       rules:
         - condition: 健全（進捗あり）
-          next: movement_a
+          next: step_a
         - condition: 非生産的（改善なし）
-          next: alternative_movement
+          next: alternative_step
 ```
 
-特定の movement 間のサイクルが閾値に達した場合、judge が介入して遷移先を判断する。
+特定の step 間のサイクルが閾値に達した場合、judge が介入して遷移先を判断する。
 
 ## allowed_tools について
 
-`allowed_tools` は TAKT 本体のエージェントプロバイダーで使用されるフィールド。Claude Code の Skill として実行する場合、Task tool のエージェントが使用可能なツールは Claude Code の設定に従う。このフィールドは参考情報として扱い、`edit` フィールドの方を権限制御に使用する。
+`allowed_tools` は TAKT 本体のエージェントプロバイダーで使用されるフィールド。Skill 経由で実行する場合、実際に利用可能なツールはホスト側の設定（Claude Code の Task tool 設定や Codex のサンドボックス設定など）に従う。このフィールドは参考情報として扱い、`edit` フィールドの方を権限制御に使用する。

package/dist/agents/decompose-task-usecase.d.ts

@@ -1,4 +1,5 @@
 import type { Language, PartDefinition } from '../core/models/types.js';
+import type { ProviderType } from '../core/piece/types.js';
 import { type StreamCallback } from './runner.js';
 export interface DecomposeTaskOptions {
     cwd: string;
@@ -6,7 +7,7 @@ export interface DecomposeTaskOptions {
     personaPath?: string;
     language?: Language;
     model?: string;
-    provider?: 'claude' | 'codex' | 'opencode' | 'cursor' | 'copilot' | 'mock';
+    provider?: ProviderType;
     onStream?: StreamCallback;
     onPromptResolved?: (promptParts: {
         systemPrompt: string;
@@ -18,6 +19,7 @@ export interface MorePartsResponse {
     reasoning: string;
     parts: PartDefinition[];
 }
+export declare const TEAM_LEADER_MAX_TURNS = 5;
 export declare function decomposeTask(instruction: string, maxParts: number, options: DecomposeTaskOptions): Promise<PartDefinition[]>;
 export declare function requestMoreParts(originalInstruction: string, allResults: Array<{
     id: string;

package/dist/agents/decompose-task-usecase.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"decompose-task-usecase.d.ts","sourceRoot":"","sources":["../../src/agents/decompose-task-usecase.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,EAAY,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAK5D,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;IAC3E,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,gBAAgB,CAAC,EAAE,CAAC,WAAW,EAAE;QAC/B,YAAY,EAAE,MAAM,CAAC;QACrB,eAAe,EAAE,MAAM,CAAC;KACzB,KAAK,IAAI,CAAC;CACZ;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB;AAqID,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,cAAc,EAAE,CAAC,CA0B3B;AAED,wBAAsB,gBAAgB,CACpC,mBAAmB,EAAE,MAAM,EAC3B,UAAU,EAAE,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,EACjF,WAAW,EAAE,MAAM,EAAE,EACrB,kBAAkB,EAAE,MAAM,EAC1B,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,iBAAiB,CAAC,CA4B5B"}
+{"version":3,"file":"decompose-task-usecase.d.ts","sourceRoot":"","sources":["../../src/agents/decompose-task-usecase.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAY,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAU5D,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,gBAAgB,CAAC,EAAE,CAAC,WAAW,EAAE;QAC/B,YAAY,EAAE,MAAM,CAAC;QACrB,eAAe,EAAE,MAAM,CAAC;KACzB,KAAK,IAAI,CAAC;CACZ;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB;AAED,eAAO,MAAM,qBAAqB,IAAI,CAAC;AAEvC,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,cAAc,EAAE,CAAC,CA0B3B;AAED,wBAAsB,gBAAgB,CACpC,mBAAmB,EAAE,MAAM,EAC3B,UAAU,EAAE,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,EACjF,WAAW,EAAE,MAAM,EAAE,EACrB,kBAAkB,EAAE,MAAM,EAC1B,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,iBAAiB,CAAC,CA4B5B"}