takt 0.33.2 → 0.35.0

package/builtins/en/{pieces → workflows}/dual.yaml

@@ -1,13 +1,13 @@
 name: dual
-description: Frontend + backend development piece with test-first, team leader implementation, AI review, 2-stage reviews, fix loops, and supervision
-piece_config:
+description: Frontend + backend development workflow with test-first, team leader implementation, AI review, 2-stage reviews, fix loops, and supervision
+workflow_config:
   provider_options:
     codex:
       network_access: true
     opencode:
       network_access: true
-max_movements: 30
-initial_movement: plan
+max_steps: 60
+initial_step: plan
 loop_monitors:
   - cycle:
       - ai_review
@@ -33,7 +33,7 @@ loop_monitors:
           next: reviewers_1
         - condition: unproductive (same findings repeating)
           next: supervise
-movements:
+steps:
   - name: plan
     edit: false
     persona: planner
@@ -41,6 +41,7 @@ movements:
       - design-planning
     knowledge:
       - frontend
+      - react
       - backend
       - architecture
     provider_options:
@@ -74,6 +75,7 @@ movements:
       - testing
     knowledge:
       - frontend
+      - react
       - backend
       - architecture
       - unit-testing
@@ -118,6 +120,7 @@ movements:
     session: refresh
     knowledge:
       - frontend
+      - react
       - backend
       - security
       - architecture
@@ -166,6 +169,9 @@ movements:
           format: coder-scope
         - name: coder-decisions.md
           format: coder-decisions
+    quality_gates:
+      - When design references exist, verify major screens element by element for layout, copy, color, and spacing
+      - When design references exist, record any platform-driven deviations in the decision log
   - name: ai_review
     edit: false
     persona: ai-antipattern-reviewer
@@ -200,6 +206,7 @@ movements:
     session: refresh
     knowledge:
       - frontend
+      - react
       - backend
       - security
       - architecture
@@ -248,6 +255,7 @@ movements:
         policy: review
         knowledge:
           - architecture
+          - react
           - backend
         provider_options:
           claude:
@@ -272,7 +280,9 @@ movements:
         policy:
           - review
           - design-fidelity
-        knowledge: frontend
+        knowledge:
+          - frontend
+          - react
         provider_options:
           claude:
             allowed_tools:
@@ -403,6 +413,7 @@ movements:
       - design-fidelity
     knowledge:
       - frontend
+      - react
       - backend
       - security
       - architecture
@@ -419,6 +430,9 @@ movements:
           - WebFetch
     required_permission_mode: edit
     pass_previous_response: false
+    quality_gates:
+      - When design references exist, fixes must not introduce new layout, copy, color, or spacing drift
+      - When design references exist, any remaining deviations must be explained in decisions or review rationale
     rules:
       - condition: Fix complete
         next: reviewers_1
@@ -429,7 +443,9 @@ movements:
     edit: false
     persona: dual-supervisor
     policy: review
-    knowledge: architecture
+    knowledge:
+      - architecture
+      - react
     provider_options:
       claude:
         allowed_tools:

package/builtins/en/{pieces → workflows}/frontend-mini.yaml

@@ -1,13 +1,13 @@
 name: frontend-mini
-description: Frontend-focused mini development piece (plan -> implement -> parallel review -> fix if needed -> complete)
-piece_config:
+description: Frontend-focused mini development workflow (plan -> implement -> parallel review -> fix if needed -> complete)
+workflow_config:
   provider_options:
     codex:
       network_access: true
     opencode:
       network_access: true
-max_movements: 20
-initial_movement: plan
+max_steps: 20
+initial_step: plan
 loop_monitors:
   - cycle:
       - reviewers
@@ -21,7 +21,7 @@ loop_monitors:
           next: fix_both
         - condition: unproductive (same findings repeating)
           next: supervise_fix
-movements:
+steps:
   - name: plan
     edit: false
     persona: planner

package/builtins/en/{pieces → workflows}/frontend.yaml

@@ -1,13 +1,13 @@
 name: frontend
-description: Frontend development piece with test-first, AI review, 2-stage reviews, fix loops, and supervision
-piece_config:
+description: Frontend development workflow with test-first, AI review, 2-stage reviews, fix loops, and supervision
+workflow_config:
   provider_options:
     codex:
       network_access: true
     opencode:
       network_access: true
-max_movements: 30
-initial_movement: plan
+max_steps: 30
+initial_step: plan
 loop_monitors:
   - cycle:
       - ai_review
@@ -33,7 +33,7 @@ loop_monitors:
           next: reviewers_1
         - condition: unproductive (same findings repeating)
           next: supervise
-movements:
+steps:
   - name: plan
     edit: false
     persona: planner

package/builtins/en/{pieces → workflows}/magi.yaml

@@ -1,6 +1,6 @@
 name: magi
 description: MAGI Deliberation System - Analyze from 3 perspectives and decide by majority
-piece_config:
+workflow_config:
   provider_options:
     claude:
       allowed_tools:
@@ -13,9 +13,9 @@ piece_config:
       network_access: true
     opencode:
       network_access: true
-max_movements: 5
-initial_movement: melchior
-movements:
+max_steps: 5
+initial_step: melchior
+steps:
   - name: melchior
     persona: melchior
     instruction: |

package/builtins/en/{pieces → workflows}/research.yaml

@@ -1,6 +1,6 @@
 name: research
-description: Research piece - autonomously executes research without asking questions
-piece_config:
+description: Research workflow - autonomously executes research without asking questions
+workflow_config:
   provider_options:
     claude:
       allowed_tools:
@@ -13,9 +13,9 @@ piece_config:
       network_access: true
     opencode:
       network_access: true
-max_movements: 10
-initial_movement: plan
-movements:
+max_steps: 10
+initial_step: plan
+steps:
   - name: plan
     persona: research-planner
     policy: research

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

@@ -1,15 +1,15 @@
 name: review-backend-cqrs
 description: CQRS+ES focused review (structure, modularization, domain model, security, 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/en/{pieces → workflows}/review-backend.yaml

@@ -1,15 +1,15 @@
 name: review-backend
 description: Backend-focused review (structure, modularization, hexagonal architecture, security, 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/en/{pieces → workflows}/review-default.yaml

@@ -1,15 +1,15 @@
 name: review-default
 description: Multi-perspective Code Review - reviews changes in parallel from 5 perspectives and outputs consolidated results
-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
@@ -184,7 +184,7 @@ movements:
       ## Review Results
       {previous_response}
 
-      **This is a review-only piece.** Do NOT run tests or builds.
+      **This is a review-only workflow.** Do NOT run tests or builds.
       Your role is to synthesize the review results and produce a final summary.
 
       **Tasks:**

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

@@ -1,15 +1,15 @@
 name: review-dual-cqrs
 description: Frontend + CQRS+ES focused review (structure, modularization, domain model, component design, security, 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/en/{pieces → workflows}/review-dual.yaml

@@ -1,15 +1,15 @@
 name: review-dual
 description: Frontend + backend focused review (structure, modularization, component design, security, 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/en/{pieces → workflows}/review-fix-backend-cqrs.yaml

@@ -1,13 +1,13 @@
 name: review-fix-backend-cqrs
 description: CQRS+ES focused review + fix loop (structure, modularization, domain model, security, 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: Unproductive (repeated findings, fixes not applied)
           next: supervise
 
-movements:
+steps:
   - name: gather
     edit: false
     persona: planner

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

@@ -1,13 +1,13 @@
 name: review-fix-backend
 description: Backend-focused review + fix loop (structure, modularization, hexagonal architecture, security, 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: Unproductive (repeated findings, fixes not applied)
           next: supervise
 
-movements:
+steps:
   - name: gather
     edit: false
     persona: planner

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

@@ -1,13 +1,13 @@
 name: review-fix-default
 description: Multi-perspective review + fix loop (architecture, security, QA, testing, requirements — 5 parallel reviewers with iterative fixes)
-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: Unproductive (repeated findings, fixes not applied)
           next: supervise
 
-movements:
+steps:
   - name: gather
     edit: false
     persona: planner

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

@@ -1,13 +1,13 @@
 name: review-fix-dual-cqrs
 description: Frontend + CQRS+ES focused review + fix loop (structure, modularization, domain model, component design, security, 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: Unproductive (repeated findings, fixes not applied)
           next: supervise
 
-movements:
+steps:
   - name: gather
     edit: false
     persona: planner

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

@@ -1,13 +1,13 @@
 name: review-fix-dual
 description: Frontend + backend focused review + fix loop (structure, modularization, component design, security, 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: Unproductive (repeated findings, fixes not applied)
           next: supervise
 
-movements:
+steps:
   - name: gather
     edit: false
     persona: planner

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

@@ -1,13 +1,13 @@
 name: review-fix-frontend
 description: Frontend-focused review + fix loop (structure, modularization, component design, security, 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: Unproductive (repeated findings, fixes not applied)
           next: supervise
 
-movements:
+steps:
   - name: gather
     edit: false
     persona: planner

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

@@ -1,13 +1,13 @@
 name: review-fix-takt-default
 description: "TAKT-focused multi-perspective review + fix loop (6-parallel initial review, AI antipattern pre-review on fix iterations)"
-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: Unproductive (same findings repeating)
           next: supervise
 
-movements:
+steps:
   - name: gather
     edit: false
     persona: planner

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

@@ -1,15 +1,15 @@
 name: review-frontend
 description: Frontend-focused review (structure, modularization, component design, security, 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/en/{pieces → workflows}/review-takt-default.yaml

@@ -1,15 +1,15 @@
 name: review-takt-default
 description: "TAKT-focused multi-perspective review (6 reviewers including AI antipattern review)"
-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:
       ## Review Results
       {previous_response}
 
-      **This is a review-only piece.** Do NOT run tests or builds.
+      **This is a review-only workflow.** Do NOT run tests or builds.
       Your role is to synthesize the review results and produce a final summary.
 
       **Tasks:**

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

@@ -1,13 +1,13 @@
 name: takt-default
-description: TAKT development piece (plan → write tests → team-leader implement → AI antipattern review → 5-parallel review → fix → supervise → complete)
-piece_config:
+description: TAKT development workflow (plan → write tests → team-leader implement → AI antipattern review → 5-parallel review → fix → supervise → complete)
+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: Unproductive (same findings repeating)
           next: supervise
-movements:
+steps:
   - name: plan
     edit: false
     persona: planner

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

@@ -1,14 +1,14 @@
 name: terraform
-description: Terraform IaC development piece (plan → implement → parallel review → supervisor validation → fix → complete)
-piece_config:
+description: Terraform IaC development workflow (plan → implement → parallel review → supervisor validation → fix → complete)
+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/ja/config.yaml

@@ -34,8 +34,8 @@ language: ja         # 表示言語: ja | en
 # notification_sound: true         # 通知音全体のON/OFF
 # notification_sound_events:       # イベント別通知音（未指定はtrue扱い）
 #   iteration_limit: true
-#   piece_complete: true
-#   piece_abort: true
+#   workflow_complete: true
+#   workflow_abort: true
 #   run_complete: true
 #   run_abort: true
 # logging:
@@ -82,12 +82,12 @@ language: ja         # 表示言語: ja | en
 # runtime:
 #   prepare: [node, gradle, ./custom-script.sh]
 
-# ピースレベルのオーバーライド
-# piece_overrides:
+# ワークフローレベルのオーバーライド
+# workflow_overrides:
 #   quality_gates:
 #     - "All tests pass"
 #   quality_gates_edit_only: true
-#   movements:
+#   steps:
 #     review:
 #       quality_gates:
 #         - "No security vulnerabilities"
@@ -116,8 +116,8 @@ language: ja         # 表示言語: ja | en
 # その他
 # bookmarks_file: ~/.takt/preferences/bookmarks.yaml   # ブックマーク保存先
 
-# ピース一覧/カテゴリ
-# enable_builtin_pieces: true                             # builtins/{lang}/pieces を有効化
+# ワークフロー一覧/カテゴリ
+# enable_builtin_workflows: true                          # builtins/{lang}/workflows を有効化
 # disabled_builtins:
 #   - magi                                                # 無効化するビルトインピース名
-# piece_categories_file: ~/.takt/preferences/piece-categories.yaml  # カテゴリ定義ファイル
+# workflow_categories_file: ~/.takt/preferences/workflow-categories.yaml  # カテゴリ定義ファイル

package/builtins/ja/facets/instructions/dual-team-leader-implement.md

@@ -10,6 +10,8 @@
    - 変更ファイル数が少ない場合、リファクタ・リネーム系の場合も1パートで実装する
 
 2. 分解する場合: フロントエンドとバックエンドでの分割を優先的に検討する
+   - **デザイン参照があり、バックエンド変更が明示要件でない場合は分解しない。** UI の見た目・構造・文言・間隔は相互依存が強く、分割すると忠実再現を壊しやすいため、1パートでまとめて実装する
+   - **デザイン参照がある場合、同一画面を構成する UI コンポーネント群は同じパートにまとめる。** ヘッダー・フィルタ・カード・バナー・モーダルなど、見た目の整合性に関わる要素を別パートへ分散しない
    - フロントエンド（UI・コンポーネント・スタイル）とバックエンド（API・ロジック・データ層）で分けるのが最も自然な分割軸
    - API契約（リクエスト/レスポンスの型）が決まっている場合は並列実装に適している
    - API契約が未確定の場合はバックエンドを先に1パートで実装し、フロントエンドは後続にする
@@ -24,9 +26,13 @@
      - **参照専用ファイル**（変更禁止、読み取りのみ可）
      - **実装内容**（何をどのように実装するか）
      - **完了基準**（担当ファイルの実装が完了したこと）
+   - デザイン参照がある場合、各パートの instruction に以下も必ず明記する：
+     - **参照デザイン**（どのファイルを一次情報として使うか）
+     - **照合対象要素**（レイアウト、文言、色、間隔、導線）
    - テスト済みの場合は「既存テストがパスするよう実装する」と明記する
-   - ビルドチェックは指示しない（他パートのファイルが揃ってから全体でまとめて確認するため）
+   - 品質ゲート（Quality Gates）を参照し、必要な検証は専用の単独パートとして計画する
+   - 並列の実装パートには、全体ビルド・全体テストを重複して実行させない
 
 **制約:**
-- 各パートはテスト実行を行わない（後続ムーブメントで実施する）
+- テストやビルドが必要な場合は、他パートの変更が揃った後に、単独の検証パートで実行する
 - 担当外のファイルを変更しない（コンフリクトの原因になる）