History

nrslib 70651f8dd8 feat: ai() 条件式によるAI遷移判断とパラレルステップ実行を実装 (#9 , #20 )

- rules の condition に ai("...") 式を追加し、別AIが遷移先を判断する仕組みを導入
- ワークフローステップに parallel フィールドを追加し、サブステップの並列実行を実装
- all()/any() 集約条件の仕様書を追加

2026-01-30 14:53:25 +09:00

agents.md

first commit:

2026-01-25 15:16:27 +09:00

README.ja.md

report 系のformatを利用するように変更、gitdiff廃止

2026-01-30 09:13:32 +09:00

spec-aggregate-conditions.md

feat: ai() 条件式によるAI遷移判断とパラレルステップ実行を実装 (#9 , #20 )

2026-01-30 14:53:25 +09:00

workflows.md

report 系のformatを利用するように変更、gitdiff廃止

2026-01-30 09:13:32 +09:00

README.ja.md

TAKT

Task Agent Koordination Tool - Claude CodeとOpenAI Codex向けのマルチエージェントオーケストレーションシステム

Note

: このプロジェクトは個人のペースで開発されています。詳細は免責事項をご覧ください。

必要条件

Claude Code または Codex がインストール・設定済みであること

TAKTはClaude CodeとCodexの両方をプロバイダーとしてサポートしています。セットアップ時にプロバイダーを選択できます。

インストール

npm install -g takt

クイックスタート

# タスクを実行（ワークフロー選択プロンプトが表示されます）
takt "ログイン機能を追加して"

# タスクをキューに追加
takt /add-task "ログインのバグを修正"

# 保留中のタスクをすべて実行
takt /run-tasks

# タスクを監視して自動実行
takt /watch

# タスクブランチ一覧（マージ・削除）
takt /list-tasks

# ワークフローを切り替え
takt /switch

タスク実行の流れ

takt "ログイン機能を追加して" を実行すると、以下の対話フローが表示されます：

1. ワークフロー選択

Select workflow:
  (↑↓ to move, Enter to select)

  ❯ default (current) (default)
    expert
    expert-cqrs
    magi
    research
    simple
    Cancel

2. 隔離クローン作成（オプション）

? Create worktree? (y/N)

y を選ぶと git clone --shared で隔離環境を作成し、作業ディレクトリをクリーンに保てます。

3. 実行 — 選択したワークフローが複数のエージェントを連携させてタスクを完了します。

ワークフロー	おすすめ用途
`default`	本格的な開発タスク。TAKT自身の開発で使用。修正ループ付きの多段階レビュー。
`simple`	README更新や小さな修正などの軽量タスク。レビューはあるが修正ループなし。
`expert-review` / `expert-cqrs`	Web開発プロジェクト。マルチエキスパートレビュー（CQRS、フロントエンド、セキュリティ、QA）。
`research`	調査・リサーチ。質問せずに自律的にリサーチを実行。
`magi`	審議システム。3つのAIペルソナが分析・投票（エヴァンゲリオン風）。

コマンド一覧

コマンド	エイリアス	説明
`takt "タスク"`		現在のワークフローでタスクを実行（セッション自動継続）
`takt /run-tasks`	`/run`	`.takt/tasks/` の保留中タスクをすべて実行
`takt /watch`		`.takt/tasks/` を監視してタスクを自動実行（常駐プロセス）
`takt /add-task`	`/add`	新しいタスクを対話的に追加（YAML形式、複数行対応）
`takt /list-tasks`	`/list`	タスクブランチ一覧（マージ・削除）
`takt /switch`	`/sw`	ワークフローを対話的に切り替え
`takt /clear`		エージェントの会話セッションをクリア
`takt /refresh-builtin`		ビルトインのエージェント/ワークフローを最新版に更新
`takt /config`		パーミッションモードを設定
`takt /help`		ヘルプを表示

実践的な使い方ガイド

タスク管理

TAKTは.takt/tasks/内のタスクファイルによるバッチ処理をサポートしています。.yaml/.ymlと.mdの両方のファイル形式に対応しています。

`/add-task` でタスクを追加

# クイック追加（隔離なし）
takt /add-task "認証機能を追加"

# 対話モード（隔離実行、ブランチ、ワークフローオプションを指定可能）
takt /add-task

タスクファイルの形式

YAML形式（推奨、worktree/branch/workflowオプション対応）：

# .takt/tasks/add-auth.yaml
task: "認証機能を追加する"
worktree: true                  # 隔離された共有クローンで実行
branch: "feat/add-auth"         # ブランチ名（省略時は自動生成）
workflow: "default"             # ワークフロー指定（省略時は現在のもの）

Markdown形式（シンプル、後方互換）：

# .takt/tasks/add-login-feature.md

アプリケーションにログイン機能を追加する。

要件：
- ユーザー名とパスワードフィールド
- フォームバリデーション
- 失敗時のエラーハンドリング

共有クローンによる隔離実行

YAMLタスクファイルでworktreeを指定すると、各タスクをgit clone --sharedで作成した隔離クローンで実行し、メインの作業ディレクトリをクリーンに保てます：

worktree: true - 隣接ディレクトリ（またはworktree_dir設定で指定した場所）に共有クローンを自動作成
worktree: "/path/to/dir" - 指定パスに作成
branch: "feat/xxx" - 指定ブランチを使用（省略時はtakt/{timestamp}-{slug}で自動生成）
worktree省略 - カレントディレクトリで実行（デフォルト）

Note

: YAMLフィールド名は後方互換のためworktreeのままです。内部的にはgit worktreeではなくgit clone --sharedを使用しています。git worktreeの.gitファイルにはgitdir:でメインリポジトリへのパスが記載されており、Claude Codeがそれを辿ってメインリポジトリをプロジェクトルートと認識してしまうためです。共有クローンは独立した.gitディレクトリを持つため、この問題が発生しません。

クローンは使い捨てです。タスク完了後に自動的にコミット＋プッシュし、クローンを削除します。ブランチが唯一の永続的な成果物です。takt /list-tasksでブランチの一覧表示・マージ・削除ができます。

`/run-tasks` でタスクを実行

takt /run-tasks

タスクはアルファベット順に実行されます（001-、002-のようなプレフィックスで順序を制御）
完了したタスクは実行レポートとともに.takt/completed/に移動されます
実行中に追加された新しいタスクも動的に取得されます

`/watch` でタスクを監視

takt /watch

ウォッチモードは.takt/tasks/をポーリングし、新しいタスクファイルが現れると自動実行します。Ctrl+Cで停止する常駐プロセスです。以下のような場合に便利です：

タスクファイルを生成するCI/CDパイプライン
外部プロセスがタスクを追加する自動化ワークフロー
タスクを順次キューイングする長時間の開発セッション

`/list-tasks` でタスクブランチを一覧表示

takt /list-tasks

takt/プレフィックスのブランチをファイル変更数とともに一覧表示します。各ブランチに対して以下の操作が可能です：

Try merge - mainにスカッシュマージ（変更をステージングのみ、コミットなし）
Instruct - 一時クローン経由で追加指示を与える
Merge & cleanup - マージしてブランチを削除
Delete - マージせずにブランチを削除

セッションログ

TAKTはセッションログを.takt/logs/にインクリメンタルに書き込みます。ログはワークフロー開始時、各ステップ完了後、ワークフロー終了時に保存されるため、プロセスが途中でクラッシュしても部分的なログが保持されます。

.takt/logs/latest.json - 現在（または最新の）セッションへのポインタ
.takt/logs/previous.json - 前回セッションへのポインタ
.takt/logs/{sessionId}.json - ワークフロー実行ごとの完全なセッションログ

エージェントはprevious.jsonを読み取って前回の実行コンテキストを引き継ぐことができます。セッション継続は自動的に行われます — takt "タスク"を実行するだけで前回のセッションから続行されます。

カスタムワークフローの追加

~/.takt/workflows/にYAMLファイルを追加して独自のワークフローを作成できます：

# ~/.takt/workflows/my-workflow.yaml
name: my-workflow
description: カスタムワークフロー

max_iterations: 5

steps:
  - name: analyze
    agent: ~/.takt/agents/my-agents/analyzer.md
    instruction_template: |
      このリクエストを分析してください: {task}
    transitions:
      - condition: done
        next_step: implement

  - name: implement
    agent: ~/.takt/agents/default/coder.md
    instruction_template: |
      分析に基づいて実装してください: {previous_response}
    pass_previous_response: true
    transitions:
      - condition: done
        next_step: COMPLETE

エージェントをパスで指定する

ワークフロー定義ではファイルパスを使ってエージェントを指定します：

# ビルトインエージェントを使用
agent: ~/.takt/agents/default/coder.md
agent: ~/.takt/agents/magi/melchior.md

# プロジェクトローカルのエージェントを使用
agent: ./.takt/agents/my-reviewer.md

# 絶対パスを使用
agent: /path/to/custom/agent.md

カスタムエージェントプロンプトをMarkdownファイルとして作成：

# ~/.takt/agents/my-agents/reviewer.md

あなたはセキュリティに特化したコードレビュアーです。

## 役割
- セキュリティ脆弱性をチェック
- 入力バリデーションを検証
- 認証ロジックをレビュー

## 出力形式
- [REVIEWER:APPROVE] コードが安全な場合
- [REVIEWER:REJECT] 問題が見つかった場合（問題点をリストアップ）

ワークフロー変数

instruction_templateで使用可能な変数：

変数	説明
`{task}`	元のユーザーリクエスト
`{iteration}`	ワークフロー全体のターン数（実行された全ステップ数）
`{max_iterations}`	最大イテレーション数
`{step_iteration}`	ステップごとのイテレーション数（このステップが実行された回数）
`{previous_response}`	前のステップの出力（`pass_previous_response: true`が必要）
`{user_inputs}`	ワークフロー中の追加ユーザー入力
`{report_dir}`	レポートディレクトリ名（例：`20250126-143052-task-summary`）

ワークフローの設計

各ワークフローステップには3つの重要な要素が必要です。

1. エージェント - システムプロンプトを含むMarkdownファイル：

agent: ~/.takt/agents/default/coder.md    # エージェントプロンプトファイルのパス
agent_name: coder                          # 表示名（オプション）

2. ステータスルール - エージェントが完了を通知する方法を定義。エージェントは[CODER:DONE]や[ARCHITECT:REJECT]のようなステータスマーカーを出力し、TAKTがそれを検出して遷移を駆動します：

status_rules_prompt: |
  最終出力には必ずステータスタグを含めてください：
  - `[CODER:DONE]` 実装が完了した場合
  - `[CODER:BLOCKED]` 進行できない場合

3. 遷移 - ステータスに基づいて次のステップにルーティング：

transitions:
  - condition: done        # ステータスタグDONEに対応
    next_step: review      # reviewステップへ遷移
  - condition: blocked     # ステータスタグBLOCKEDに対応
    next_step: ABORT       # ワークフローを失敗終了

使用可能な遷移条件：done、blocked、approved、rejected、improve、answer、always 特殊なnext_step値：COMPLETE（成功）、ABORT（失敗）

ステップオプション：

オプション	デフォルト	説明
`pass_previous_response`	`true`	前のステップの出力を`{previous_response}`に渡す
`on_no_status`	-	ステータス未検出時の動作：`complete`、`continue`、`stay`
`allowed_tools`	-	エージェントが使用できるツール一覧（Read, Glob, Grep, Edit, Write, Bash等）
`provider`	-	このステップのプロバイダーを上書き（`claude`または`codex`）
`model`	-	このステップのモデルを上書き
`permission_mode`	`default`	パーミッションモード：`default`、`acceptEdits`、`bypassPermissions`

ワークフロー

TAKTはYAMLベースのワークフロー定義を使用します。以下に配置してください：

~/.takt/workflows/*.yaml

ワークフローの例

name: default
max_iterations: 10

steps:
  - name: implement
    agent: coder
    instruction_template: |
      {task}
    transitions:
      - condition: done
        next_step: review
      - condition: blocked
        next_step: ABORT

  - name: review
    agent: architect
    transitions:
      - condition: approved
        next_step: COMPLETE
      - condition: rejected
        next_step: implement

ビルトインワークフロー

TAKTには複数のビルトインワークフローが同梱されています：

ワークフロー	説明
`default`	フル開発ワークフロー：計画 → 実装 → アーキテクトレビュー → AIレビュー → セキュリティレビュー → スーパーバイザー承認。各レビュー段階に修正ループあり。
`simple`	defaultの簡略版：計画 → 実装 → アーキテクトレビュー → AIレビュー → スーパーバイザー。中間の修正ステップなし。
`research`	リサーチワークフロー：プランナー → ディガー → スーパーバイザー。質問せずに自律的にリサーチを実行。
`expert-review`	ドメインエキスパートによる包括的レビュー：CQRS+ES、フロントエンド、AI、セキュリティ、QAレビューと修正ループ。
`expert-cqrs`	CQRS+ES、フロントエンド、AI、セキュリティ、QA専門のエキスパートレビュー。計画 → 実装 → マルチエキスパートレビュー → スーパーバイザー。
`magi`	エヴァンゲリオンにインスパイアされた審議システム。3つのAIペルソナ（MELCHIOR、BALTHASAR、CASPER）が分析し投票。

takt /switch でワークフローを切り替えられます。

ビルトインエージェント

coder - 機能を実装しバグを修正
architect - コードをレビューしフィードバックを提供
supervisor - 最終検証と承認
planner - タスク分析と実装計画
ai-reviewer - AI生成コードの品質レビュー
security - セキュリティ脆弱性の評価

カスタムエージェント

.takt/agents.yamlでカスタムエージェントを定義：

agents:
  - name: my-reviewer
    prompt_file: .takt/prompts/reviewer.md
    allowed_tools: [Read, Glob, Grep]
    provider: claude             # オプション：claude または codex
    model: opus                  # Claude: opus/sonnet/haiku、Codex: gpt-5.2-codex 等
    status_patterns:
      approved: "\\[APPROVE\\]"
      rejected: "\\[REJECT\\]"

プロジェクト構造

~/.takt/
├── config.yaml          # グローバル設定（プロバイダー、モデル、ワークフロー等）
├── workflows/           # ワークフロー定義
└── agents/              # エージェントプロンプトファイル

.takt/                   # プロジェクトレベルの設定
├── agents.yaml          # カスタムエージェント定義
├── tasks/               # 保留中のタスクファイル（.yaml, .md）
├── completed/           # 完了したタスクとレポート
├── worktree-meta/       # タスクブランチのメタデータ
├── worktree-sessions/   # クローンごとのエージェントセッション保存
├── reports/             # 実行レポート（自動生成）
└── logs/                # セッションログ（インクリメンタル）
    ├── latest.json      # 現在/最新セッションへのポインタ
    ├── previous.json    # 前回セッションへのポインタ
    └── {sessionId}.json # ワークフロー実行ごとの完全なセッションログ

API使用例

import { WorkflowEngine, loadWorkflow } from 'takt';  // npm install takt

const config = loadWorkflow('default');
if (!config) {
  throw new Error('Workflow not found');
}
const engine = new WorkflowEngine(config, process.cwd(), 'My task');

engine.on('step:complete', (step, response) => {
  console.log(`${step.name}: ${response.status}`);
});

await engine.run();

免責事項

このプロジェクトは個人プロジェクトであり、私自身のペースで開発されています。

レスポンス時間: イシューにすぐに対応できない場合があります
開発スタイル: このプロジェクトは主に「バイブコーディング」（AI支援開発）で開発されています - 自己責任でお使いください
プルリクエスト:
- 小さく焦点を絞ったPR（バグ修正、タイポ、ドキュメント）は歓迎します
- 大きなPR、特にAI生成の一括変更はレビューが困難です

詳細はCONTRIBUTING.mdをご覧ください。

Docker サポート

他の環境でのテスト用にDocker環境が提供されています：

# Dockerイメージをビルド
docker compose build

# コンテナでテストを実行
docker compose run --rm test

# コンテナでlintを実行
docker compose run --rm lint

# ビルドのみ（テストをスキップ）
docker compose run --rm build

これにより、クリーンなNode.js 20環境でプロジェクトが正しく動作することが保証されます。

ドキュメント

Workflow Guide - ワークフローの作成とカスタマイズ
Agent Guide - カスタムエージェントの設定
Changelog - バージョン履歴
Security Policy - 脆弱性報告
ブログ：TAKT - AIエージェントオーケストレーション - 設計思想と実践的な使い方ガイド

ライセンス

MIT - 詳細はLICENSEをご覧ください。

README.ja.md Unescape Escape

TAKT

必要条件

インストール

クイックスタート

タスク実行の流れ

おすすめワークフロー

コマンド一覧

実践的な使い方ガイド

タスク管理

/add-task でタスクを追加

タスクファイルの形式

共有クローンによる隔離実行

/run-tasks でタスクを実行

/watch でタスクを監視

/list-tasks でタスクブランチを一覧表示

セッションログ

カスタムワークフローの追加

エージェントをパスで指定する

ワークフロー変数

ワークフローの設計

ワークフロー

ワークフローの例

ビルトインワークフロー

ビルトインエージェント

カスタムエージェント

プロジェクト構造

API使用例

免責事項

Docker サポート

ドキュメント

ライセンス

README.ja.md

`/add-task` でタスクを追加

`/run-tasks` でタスクを実行

`/watch` でタスクを監視

`/list-tasks` でタスクブランチを一覧表示