takt 0.33.2 → 0.35.0

package/builtins/ja/{pieces → workflows}/review-dual.yaml

@@ -1,15 +1,15 @@
 name: review-dual
 description: フロントエンド＋バックエンド特化レビュー（構造・モジュール化・コンポーネント設計・セキュリティ・QA）
-piece_config:
+workflow_config:
   provider_options:
     codex:
       network_access: true
     opencode:
       network_access: true
-max_movements: 10
-initial_movement: gather
+max_steps: 10
+initial_step: gather
 
-movements:
+steps:
   - name: gather
     edit: false
     persona: planner

package/builtins/ja/{pieces → workflows}/review-fix-backend-cqrs.yaml

@@ -1,13 +1,13 @@
 name: review-fix-backend-cqrs
 description: CQRS+ES特化レビュー＋修正ループ（構造・モジュール化・ドメインモデル・セキュリティ・QA）
-piece_config:
+workflow_config:
   provider_options:
     codex:
       network_access: true
     opencode:
       network_access: true
-max_movements: 30
-initial_movement: gather
+max_steps: 30
+initial_step: gather
 loop_monitors:
   - cycle:
       - reviewers
@@ -22,7 +22,7 @@ loop_monitors:
         - condition: 非生産的（同じ指摘の反復・修正未反映）
           next: supervise
 
-movements:
+steps:
   - name: gather
     edit: false
     persona: planner

package/builtins/ja/{pieces → workflows}/review-fix-backend.yaml

@@ -1,13 +1,13 @@
 name: review-fix-backend
 description: バックエンド特化レビュー＋修正ループ（構造・モジュール化・ヘキサゴナルアーキテクチャ・セキュリティ・QA）
-piece_config:
+workflow_config:
   provider_options:
     codex:
       network_access: true
     opencode:
       network_access: true
-max_movements: 30
-initial_movement: gather
+max_steps: 30
+initial_step: gather
 loop_monitors:
   - cycle:
       - reviewers
@@ -22,7 +22,7 @@ loop_monitors:
         - condition: 非生産的（同じ指摘の反復・修正未反映）
           next: supervise
 
-movements:
+steps:
   - name: gather
     edit: false
     persona: planner

package/builtins/ja/{pieces → workflows}/review-fix-default.yaml

@@ -1,13 +1,13 @@
 name: review-fix-default
 description: 多角レビュー＋修正ループ（アーキテクチャ・セキュリティ・QA・テスト・要件の5観点から並列レビューし、指摘を修正する）
-piece_config:
+workflow_config:
   provider_options:
     codex:
       network_access: true
     opencode:
       network_access: true
-max_movements: 30
-initial_movement: gather
+max_steps: 30
+initial_step: gather
 loop_monitors:
   - cycle:
       - reviewers
@@ -22,7 +22,7 @@ loop_monitors:
         - condition: 非生産的（同じ指摘の反復・修正未反映）
           next: supervise
 
-movements:
+steps:
   - name: gather
     edit: false
     persona: planner

package/builtins/ja/{pieces → workflows}/review-fix-dual-cqrs.yaml

@@ -1,13 +1,13 @@
 name: review-fix-dual-cqrs
 description: フロントエンド＋CQRS+ES特化レビュー＋修正ループ（構造・モジュール化・ドメインモデル・コンポーネント設計・セキュリティ・QA）
-piece_config:
+workflow_config:
   provider_options:
     codex:
       network_access: true
     opencode:
       network_access: true
-max_movements: 30
-initial_movement: gather
+max_steps: 30
+initial_step: gather
 loop_monitors:
   - cycle:
       - reviewers
@@ -22,7 +22,7 @@ loop_monitors:
         - condition: 非生産的（同じ指摘の反復・修正未反映）
           next: supervise
 
-movements:
+steps:
   - name: gather
     edit: false
     persona: planner

package/builtins/ja/{pieces → workflows}/review-fix-dual.yaml

@@ -1,13 +1,13 @@
 name: review-fix-dual
 description: フロントエンド＋バックエンド特化レビュー＋修正ループ（構造・モジュール化・コンポーネント設計・セキュリティ・QA）
-piece_config:
+workflow_config:
   provider_options:
     codex:
       network_access: true
     opencode:
       network_access: true
-max_movements: 30
-initial_movement: gather
+max_steps: 30
+initial_step: gather
 loop_monitors:
   - cycle:
       - reviewers
@@ -22,7 +22,7 @@ loop_monitors:
         - condition: 非生産的（同じ指摘の反復・修正未反映）
           next: supervise
 
-movements:
+steps:
   - name: gather
     edit: false
     persona: planner

package/builtins/ja/{pieces → workflows}/review-fix-frontend.yaml

@@ -1,13 +1,13 @@
 name: review-fix-frontend
 description: フロントエンド特化レビュー＋修正ループ（構造・モジュール化・コンポーネント設計・セキュリティ・QA）
-piece_config:
+workflow_config:
   provider_options:
     codex:
       network_access: true
     opencode:
       network_access: true
-max_movements: 30
-initial_movement: gather
+max_steps: 30
+initial_step: gather
 loop_monitors:
   - cycle:
       - reviewers
@@ -22,7 +22,7 @@ loop_monitors:
         - condition: 非生産的（同じ指摘の反復・修正未反映）
           next: supervise
 
-movements:
+steps:
   - name: gather
     edit: false
     persona: planner

package/builtins/ja/{pieces → workflows}/review-fix-takt-default.yaml

@@ -1,13 +1,13 @@
 name: review-fix-takt-default
 description: TAKT開発向け多角レビュー＋修正ループ（初回6並列レビュー、修正後はAIアンチパターン事前レビュー＋5並列レビュー）
-piece_config:
+workflow_config:
   provider_options:
     codex:
       network_access: true
     opencode:
       network_access: true
-max_movements: 30
-initial_movement: gather
+max_steps: 50
+initial_step: gather
 loop_monitors:
   - cycle:
       - ai_review
@@ -34,7 +34,7 @@ loop_monitors:
         - condition: 非生産的（同じ指摘の反復）
           next: supervise
 
-movements:
+steps:
   - name: gather
     edit: false
     persona: planner

package/builtins/ja/{pieces → workflows}/review-frontend.yaml

@@ -1,15 +1,15 @@
 name: review-frontend
 description: フロントエンド特化レビュー（構造・モジュール化・コンポーネント設計・セキュリティ・QA）
-piece_config:
+workflow_config:
   provider_options:
     codex:
       network_access: true
     opencode:
       network_access: true
-max_movements: 10
-initial_movement: gather
+max_steps: 10
+initial_step: gather
 
-movements:
+steps:
   - name: gather
     edit: false
     persona: planner

package/builtins/ja/{pieces → workflows}/review-takt-default.yaml

@@ -1,15 +1,15 @@
 name: review-takt-default
 description: TAKT開発向け多角レビュー（AIアンチパターン含む6観点レビュー）
-piece_config:
+workflow_config:
   provider_options:
     codex:
       network_access: true
     opencode:
       network_access: true
-max_movements: 10
-initial_movement: gather
+max_steps: 10
+initial_step: gather
 
-movements:
+steps:
   - name: gather
     edit: false
     persona: planner
@@ -210,7 +210,7 @@ movements:
       ## レビュー結果
       {previous_response}
 
-      **これはレビュー専用ピースです。** テスト実行やビルドは行わないでください。
+      **これはレビュー専用 workflow です。** テスト実行やビルドは行わないでください。
       レビュー結果を統合し、最終サマリーを作成する役割です。
 
       **やること:**

package/builtins/ja/{pieces → workflows}/takt-default.yaml

@@ -1,13 +1,13 @@
 name: takt-default
-description: TAKT開発ピース（計画 → テスト作成 → チームリーダー実装 → AIアンチパターンレビュー → 5並列レビュー → 修正 → 監督 → 完了）
-piece_config:
+description: TAKT開発ワークフロー（計画 → テスト作成 → チームリーダー実装 → AIアンチパターンレビュー → 5並列レビュー → 修正 → 監督 → 完了）
+workflow_config:
   provider_options:
     codex:
       network_access: true
     opencode:
       network_access: true
-max_movements: 30
-initial_movement: plan
+max_steps: 50
+initial_step: plan
 loop_monitors:
   - cycle:
       - ai_review
@@ -33,7 +33,7 @@ loop_monitors:
           next: reviewers
         - condition: 非生産的（同じ指摘が繰り返される）
           next: supervise
-movements:
+steps:
   - name: plan
     edit: false
     persona: planner

package/builtins/ja/{pieces → workflows}/terraform.yaml

@@ -1,14 +1,14 @@
 name: terraform
-description: Terraform IaC 開発ピース（plan → implement → 並列レビュー → 監督検証 → 修正 → 完了）
-piece_config:
+description: Terraform IaC 開発ワークフロー（plan → implement → 並列レビュー → 監督検証 → 修正 → 完了）
+workflow_config:
   provider_options:
     codex:
       network_access: true
     opencode:
       network_access: true
-max_movements: 15
-initial_movement: plan
-movements:
+max_steps: 15
+initial_step: plan
+steps:
   - name: plan
     edit: false
     persona: planner

package/builtins/schemas/decomposition.json

@@ -17,13 +17,9 @@
           "instruction": {
             "type": "string",
             "description": "Instruction for the part agent"
-          },
-          "timeout_ms": {
-            "type": ["integer", "null"],
-            "description": "Optional timeout in ms"
           }
         },
-        "required": ["id", "title", "instruction", "timeout_ms"],
+        "required": ["id", "title", "instruction"],
         "additionalProperties": false
       }
     }

package/builtins/schemas/more-parts.json

@@ -25,13 +25,9 @@
           "instruction": {
             "type": "string",
             "description": "Instruction for the part agent"
-          },
-          "timeout_ms": {
-            "type": ["integer", "null"],
-            "description": "Optional timeout in ms"
           }
         },
-        "required": ["id", "title", "instruction", "timeout_ms"],
+        "required": ["id", "title", "instruction"],
         "additionalProperties": false
       }
     }

package/builtins/skill/SKILL.md

@@ -1,10 +1,10 @@
 ---
 name: takt
-description: TAKT ピースエンジン。Agent Team を使ったマルチエージェントオーケストレーション。ピースYAMLワークフローに従ってマルチエージェントを実行する。
+description: TAKT ワークフローエンジン。Agent Team を使ったマルチエージェントオーケストレーション。ワークフロー YAML（steps / initial_step）に従ってマルチエージェントを実行する。
 user-invocable: true
 ---
 
-# TAKT Piece Engine
+# TAKT Workflow Engine
 
 ## 引数の解析
 
@@ -14,7 +14,7 @@ $ARGUMENTS を以下のように解析する:
 /takt {piece} [permission] {task...}
 ```
 
-- **第1トークン**: ピース名またはYAMLファイルパス（必須）
+- **第1トークン**: ワークフロー名または YAML ファイルパス（必須）
 - **第2トークン**: 権限モード（任意）。以下のキーワードの場合は権限モードとして解釈する:
   - `--permit-full` — 全権限付与（mode: "bypassPermissions"）
   - `--permit-edit` — 編集許可（mode: "acceptEdits"）
@@ -23,8 +23,8 @@ $ARGUMENTS を以下のように解析する:
 - **権限モード省略時のデフォルト**: `"default"`（権限確認あり）
 
 例:
-- `/takt coding FizzBuzzを作って` → coding ピース、default 権限
-- `/takt coding --permit-full FizzBuzzを作って` → coding ピース、bypassPermissions
+- `/takt coding FizzBuzzを作って` → coding ワークフロー、default 権限
+- `/takt coding --permit-full FizzBuzzを作って` → coding ワークフロー、bypassPermissions
 - `/takt /path/to/custom.yaml 実装して` → カスタムYAML、default 権限
 
 ## 事前準備: リファレンスの読み込み
@@ -32,26 +32,26 @@ $ARGUMENTS を以下のように解析する:
 手順を開始する前に、以下の2ファイルを **Read tool で読み込む**:
 
 1. `~/.claude/skills/takt/references/engine.md` - プロンプト構築、レポート管理、ループ検出の詳細
-2. `~/.claude/skills/takt/references/yaml-schema.md` - ピースYAMLの構造定義
+2. `~/.claude/skills/takt/references/yaml-schema.md` - ワークフロー YAML の構造定義
 
 ## あなたの役割: Team Lead
 
 あなたは **Team Lead（オーケストレーター）** である。
-ピースYAMLに定義されたワークフロー（状態遷移マシン）に従って Agent Team を率いる。
+ワークフロー YAML に定義された状態遷移に従って Agent Team を率いる。
 
 ### 禁止事項
 
 - **自分で作業するな** — コーディング、レビュー、設計、テスト等は全てチームメイトに委任する
-- **タスクを自分で分析して1つの Task にまとめるな** — movement を1つずつ順番に実行せよ
-- **movement をスキップするな** — 必ず initial_movement から開始し、Rule 評価で決まった次の movement に進む
-- **"yolo" をピース名と誤解するな** — "yolo" は YOLO（You Only Live Once）の俗語で「無謀・適当・いい加減」という意味。「yolo ではレビューして」= 「適当にやらずにちゃんとレビューして」という意味であり、ピース作成の指示ではない
+- **タスクを自分で分析して1つの Task にまとめるな** — 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. **Task tool** でチームメイトを起動して作業を委任する
-4. チームメイトの出力から Rule 評価を行い、次の movement を決定する
+4. チームメイトの出力から Rule 評価を行い、次の step を決定する
 
 **重要**: ユーザーが明示的に指示するまで git commit を実行してはならない。実装完了 ≠ コミット許可。
 
@@ -61,37 +61,39 @@ $ARGUMENTS を以下のように解析する:
 |---------|-----------|------|
 | チーム作成 | **TeamCreate** tool | 最初に1回だけ呼ぶ |
 | チーム解散 | **TeamDelete** tool | 最後に1回だけ呼ぶ |
-| チームメイト起動 | **Task** tool (team_name 付き) | movement ごとに呼ぶ。**結果は同期的に返る** |
+| チームメイト起動 | **Task** tool (team_name 付き) | step ごとに呼ぶ。**結果は同期的に返る** |
 
 **TeamCreate / TeamDelete でチームメイトを個別に起動することはできない。** チームメイトの起動は必ず Task tool を使う。
 **Task tool は同期的に結果を返す。** TaskOutput やポーリングは不要。呼べば結果が返ってくる。
 
 ## 手順（この順序で厳密に実行せよ）
 
-### 手順 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` （ユーザーカスタム、優先）
-   - `~/.claude/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`
+   - `~/.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` も後方互換で受理）
 - セクションマップ: `personas`, `policies`, `instructions`, `output_contracts`, `knowledge`
 
 ### 手順 2: セクションリソースの事前読み込み
 
-ピースYAMLのセクションマップ（`personas:`, `policies:`, `instructions:`, `output_contracts:`, `knowledge:`）から全ファイルパスを収集する。
-パスは **ピースYAMLファイルのディレクトリからの相対パス** で解決する。
+ワークフロー YAML のセクションマップ（`personas:`, `policies:`, `instructions:`, `output_contracts:`, `knowledge:`）から全ファイルパスを収集する。
+パスは **ワークフロー YAML ファイルのディレクトリからの相対パス** で解決する。
 
-例: ピースが `~/.claude/skills/takt/pieces/default.yaml` にあり、`personas:` に `coder: ../facets/personas/coder.md` がある場合
+例: ワークフローが `~/.claude/skills/takt/workflows/default.yaml` にあり、`personas:` に `coder: ../facets/personas/coder.md` がある場合
 → 絶対パスは `~/.claude/skills/takt/facets/personas/coder.md`
 
 重複を除いて Read で全て読み込む。読み込んだ内容はチームメイトへのプロンプト構築に使う。
@@ -103,20 +105,20 @@ YAMLから以下を抽出する（→ references/yaml-schema.md 参照）:
 ```
 TeamCreate tool を呼ぶ:
   team_name: "takt"
-  description: "TAKT {piece_name} ワークフロー"
+  description: "TAKT {workflow_name} ワークフロー"
 ```
 
 ### 手順 4: 初期化
 
-`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 = コマンドで解析された権限モード（"bypassPermissions" / "acceptEdits" / "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 スナップショット）
@@ -132,33 +134,33 @@ TeamCreate tool を呼ぶ:
 
 **iteration が max_movements を超えていたら → 手順 8（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 フィールドなし）:**
 
 Task tool を1つ呼ぶ。**Task tool は同期的に結果を返す。待機やポーリングは不要。**
 
 ```
 Task tool を呼ぶ:
   prompt: <構築したプロンプト全文>
-  description: "{movement名} - {piece_name}"
+  description: "{step_name} - {workflow_name}"
   subagent_type: "general-purpose"
   team_name: "takt"
-  name: "{movement の name}"
+  name: "{step の name}"
   mode: permission_mode
 ```
 
 Task tool の戻り値がチームメイトの出力。**手順 5a** に進む。
 
-**parallel movement の場合:**
+**parallel step の場合:**
 
 **1つのメッセージで**、parallel 配列の各サブステップに対して Task tool を並列に呼ぶ。
 全ての Task tool が結果を返したら **手順 5a** に進む。
@@ -167,7 +169,7 @@ Task tool の戻り値がチームメイトの出力。**手順 5a** に進む
 // サブステップの数だけ Task tool を同時に呼ぶ（例: 2つの場合）
 Task tool を呼ぶ（1つ目）:
   prompt: <サブステップ1用プロンプト>
-  description: "{サブステップ1名} - {piece_name}"
+  description: "{サブステップ1名} - {workflow_name}"
   subagent_type: "general-purpose"
   team_name: "takt"
   name: "{サブステップ1の name}"
@@ -175,7 +177,7 @@ Task tool を呼ぶ（1つ目）:
 
 Task tool を呼ぶ（2つ目）:
   prompt: <サブステップ2用プロンプト>
-  description: "{サブステップ2名} - {piece_name}"
+  description: "{サブステップ2名} - {workflow_name}"
   subagent_type: "general-purpose"
   team_name: "takt"
   name: "{サブステップ2の name}"
@@ -184,12 +186,12 @@ Task tool を呼ぶ（2つ目）:
 
 ### 手順 5a: レポート抽出と 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」を参照。
 
@@ -197,15 +199,15 @@ Task tool を呼ぶ（2つ目）:
 
 Task tool から返ってきたチームメイトの出力から matched_rule を決定する。
 
-**通常 movement:**
+**通常 step:**
 1. 出力に `[STEP:N]` タグがあるか探す（複数ある場合は最後のタグを採用）
 2. タグがあれば → rules[N] を選択（0始まりインデックス）
 3. タグがなければ → 出力全体を読み、全 condition と比較して最も近いものを選択
 
-**parallel movement:**
+**parallel step:**
 1. 各サブステップの Task tool 出力に対して、サブステップの 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
@@ -214,15 +216,15 @@ Task tool から返ってきたチームメイトの出力から matched_rule
 matched_rule が決まったら **手順 7** に進む。
 どの rule にもマッチしなかったら → **手順 8（ABORT: ルール不一致）** に進む。
 
-### 手順 7: 次の movement を決定
+### 手順 7: 次の step を決定
 
 matched_rule の `next` を確認する:
 
 - **`next` が "COMPLETE"** → **手順 8（COMPLETE）** に進む
 - **`next` が "ABORT"** → **手順 8（ABORT）** に進む
-- **`next` が movement 名** → 以下を実行して **手順 5 に戻る**:
+- **`next` が step 名** → 以下を実行して **手順 5 に戻る**:
   1. `previous_response` = 直前のチームメイト出力
-  2. `current_movement` = `next` で指定された movement を movements 配列から取得
+  2. `current_step` = `next` で指定された step を `steps`（互換: `movements`）配列から取得
   3. `iteration` を +1 する
   4. **手順 5 に戻る**
 
@@ -243,4 +245,4 @@ TeamDelete tool を呼ぶ
 | ファイル | 内容 |
 |---------|------|
 | `references/engine.md` | プロンプト構築、レポート管理、ループ検出の詳細 |
-| `references/yaml-schema.md` | ピースYAMLの構造定義とフィールド説明 |
+| `references/yaml-schema.md` | ワークフロー YAML の構造定義とフィールド説明 |