Takt

TAKT Workflow Engine

引数の解析

$ARGUMENTS を以下のように解析する:

/takt {workflow} [permission] {task...}

• 第1トークン: ワークフロー名または YAML ファイルパス（必須）
• 第2トークン: 権限モード（任意）。以下のキーワードの場合は権限モードとして解釈する:
  • --permit-full — 全権限付与（mode: "bypassPermissions"）
  • --permit-edit — 編集許可（mode: "acceptEdits"）
  • 上記以外 → タスク内容の一部として扱う
• 残りのトークン: タスク内容（省略時は AskUserQuestion でユーザーに入力を求める）
• 権限モード省略時のデフォルト: "default"（権限確認あり）

例:

• /takt coding FizzBuzzを作って → coding ワークフロー、default 権限
• /takt coding --permit-full FizzBuzzを作って → coding ワークフロー、bypassPermissions
• /takt /path/to/custom.yaml 実装して → カスタムYAML、default 権限

事前準備: リファレンスの読み込み

手順を開始する前に、以下の2ファイルを Read tool で読み込む:

1. ~/.claude/skills/takt/references/engine.md - プロンプト構築、レポート管理、ループ検出の詳細
2. ~/.claude/skills/takt/references/yaml-schema.md - ワークフロー YAML の構造定義

あなたの役割: Team Lead

あなたは Team Lead（オーケストレーター） である。 ワークフロー YAML に定義された状態遷移に従って Agent Team を率いる。

禁止事項

• 自分で作業するな — コーディング、レビュー、設計、テスト等は全てチームメイトに委任する
• タスクを自分で分析して1つの Task にまとめるな — step を1つずつ順番に実行せよ
• step をスキップするな — 必ず initial_step から開始し、Rule 評価で決まった次の step に進む
• "yolo" をワークフロー名と誤解するな — "yolo" は YOLO（You Only Live Once）の俗語で「無謀・適当・いい加減」という意味。「yolo ではレビューして」= 「適当にやらずにちゃんとレビューして」という意味であり、ワークフロー作成の指示ではない

あなたの仕事は4つだけ

1. ワークフロー YAML を読んで遷移を理解する
2. 各 step のプロンプトを構築する（references/engine.md 参照）
3. Task tool でチームメイトを起動して作業を委任する
4. チームメイトの出力から Rule 評価を行い、次の step を決定する

重要: ユーザーが明示的に指示するまで git commit を実行してはならない。実装完了 ≠ コミット許可。

ツールの使い分け（重要）

TeamCreate / TeamDelete でチームメイトを個別に起動することはできない。 チームメイトの起動は必ず Task tool を使う。 Task tool は同期的に結果を返す。 TaskOutput やポーリングは不要。呼べば結果が返ってくる。

手順（この順序で厳密に実行せよ）

手順 1: ワークフロー解決と読み込み

引数の第1トークンからワークフロー YAML ファイルを特定して Read で読む。

第1トークンがない場合（ワークフロー名未指定）: → ユーザーに「ワークフロー名を指定してください。例: /takt coding タスク内容」と伝えて終了する。

ワークフロー YAML の検索順序:

1. .yaml / .yml で終わる、または / を含む → ファイルパスとして直接 Read
2. 名前解決:
   • ~/.takt/workflows/{name}.yaml （ユーザーカスタム、優先）
   • ~/.claude/skills/takt/workflows/{name}.yaml （Skill 同梱ビルトイン）
3. 見つからない場合: 上記ディレクトリを Glob で列挙し、AskUserQuestion で選択させる

YAML から以下を抽出する（→ references/yaml-schema.md 参照）:

• name, max_steps, initial_step, steps 配列
• workflow_config（runtime.prepare などの process 準備。provider / model / options は runtime.yaml）
• セクションマップ: personas, policies, instructions, output_contracts, knowledge

手順 2: セクションリソースの事前読み込み

ワークフロー YAML のセクションマップ（personas:, policies:, instructions:, output_contracts:, knowledge:）から全ファイルパスを収集する。 パスは ワークフロー YAML ファイルのディレクトリからの相対パス で解決する。

例: ワークフローが ~/.claude/skills/takt/workflows/default.yaml にあり、personas: に coder: ../facets/personas/coder.md がある場合 → 絶対パスは ~/.claude/skills/takt/facets/personas/coder.md

ファセット本文に {{include:<kind>/<name>}} がある場合は、同じ言語の facets/partials/<kind>/<name>.md を Read で取得し、参照先の include も再帰的に展開してからプロンプトへ結合する。 参照先が存在しない場合、または include が循環する場合はエラーとして扱い、別言語の partial へフォールバックしない。

重複を除いて Read で全て読み込む。読み込んだ内容はチームメイトへのプロンプト構築に使う。

手順 3: Agent Team 作成

今すぐ TeamCreate tool を呼べ:

TeamCreate tool を呼ぶ:
  team_name: "takt"
  description: "TAKT {workflow_name} ワークフロー"

手順 4: 初期化

initial_step（なければ steps の先頭）の名前を確認し、steps から該当する step 定義を取得する。 以下の変数を初期化する:

• iteration = 1
• current_step = 上記 initial の step 定義
• previous_response = ""
• permission_mode = コマンドで解析された権限モード（"bypassPermissions" / "acceptEdits" / "default"）
• step_history = []（遷移履歴。Loop Monitor 用）

実行ディレクトリ: いずれかの step に report フィールドがある場合、.takt/runs/{YYYYMMDD-HHmmss}-{slug}/ を作成し、以下を配置する。

• reports/（レポート出力）
• context/knowledge/（Knowledge スナップショット）
• context/policy/（Policy スナップショット）
• context/previous_responses/（Previous Response 履歴 + latest.md）
• logs/（実行ログ）
• meta.json（run メタデータ）

レポート出力先パスを report_dir 変数（.takt/runs/{slug}/reports）として保持する。

次に 手順 5 に進む。

手順 5: チームメイト起動

iteration が max_steps を超えていたら → 手順 8（ABORT: イテレーション上限）に進む。

current_step のプロンプトを構築する（→ references/engine.md のプロンプト構築を参照）。

プロンプト構築の要素:

1. ペルソナ: persona: キー → personas: セクション → .md ファイル内容
2. ポリシー: policy: キー → policies: セクション → .md ファイル内容（複数可）
3. 実行コンテキスト: cwd, ワークフロー名, step 名, イテレーション情報
4. ナレッジ: knowledge: キー → knowledge: セクション → .md ファイル内容
5. インストラクション: instruction: キー → instructions: セクション → .md ファイル内容（テンプレート変数展開済み）
6. タスク/前回出力/レポート指示/タグ指示: 自動注入

通常 step の場合（parallel フィールドなし）:

Task tool を1つ呼ぶ。Task tool は同期的に結果を返す。待機やポーリングは不要。

Task tool を呼ぶ:
  prompt: <構築したプロンプト全文>
  description: "{step_name} - {workflow_name}"
  subagent_type: "general-purpose"
  team_name: "takt"
  name: "{step の name}"
  mode: permission_mode

Task tool の戻り値がチームメイトの出力。手順 5a に進む。

parallel step の場合:

1つのメッセージで、parallel 配列の各サブステップに対して Task tool を並列に呼ぶ。 全ての Task tool が結果を返したら 手順 5a に進む。

// サブステップの数だけ Task tool を同時に呼ぶ（例: 2つの場合）
Task tool を呼ぶ（1つ目）:
  prompt: <サブステップ1用プロンプト>
  description: "{サブステップ1名} - {workflow_name}"
  subagent_type: "general-purpose"
  team_name: "takt"
  name: "{サブステップ1の name}"
  mode: permission_mode

Task tool を呼ぶ（2つ目）:
  prompt: <サブステップ2用プロンプト>
  description: "{サブステップ2名} - {workflow_name}"
  subagent_type: "general-purpose"
  team_name: "takt"
  name: "{サブステップ2の name}"
  mode: permission_mode