nrslib/takt

解決する課題

TAKT は AI コーディングエージェントの「ベビーシッティング」を止めることを目的に設計されています。エージェントが指示を忘れたり、コンテキストを汚染したり、長時間の開発タスクで重要なレビュー工程をスキップしたりするという一般的な問題に対処します。複雑なプロセスを単一のエージェントに任せるのではなく、外部から構造化された再現可能な開発ワークフローを強制します。

仕組み

TAKT は YAML で定義されたワークフローを用いて複数の AI エージェントをオーケストレーションする CLI ツールです。開発プロセスを明確なステップ（例：計画、実装、レビュー、修正）に分割し、各ステップに特定のペルソナ、権限、遷移ルールを割り当てます。

主な技術メカニズムは次のとおりです：

• Isolated Worktrees：タスクは分離された Git worktree で実行され、メイン作業ディレクトリを汚染しません。
• Workflow Engine：YAML ベースのシステムでステップ間の遷移を管理します（例：失敗したレビューを実装ステップに戻す）。
• Provider Agnostic：Claude Code、Cursor、GitHub Copilot CLI、Codex、OpenCode など、さまざまな AI プロバイダーを調整します。
• Auto-routing：オプション機能で、コスト、パフォーマンス、推論要件に基づき、最適なモデルへ特定のワークフローステップを自動的にルーティングします。

対象ユーザー

TAKT は、AI コーディングエージェントを使って大規模な作業を行い、アドホックなプロンプトからプロフェッショナルで再現可能なソフトウェアエンジニアリングプロセスへ移行したい開発者向けです。また、GitHub Actions を通じて CI/CD パイプラインに AI エージェントを統合したいチームにも適しています。

ハイライト

• Declarative Workflows：YAML で開発ループ全体（Plan $\rightarrow$ Implement $\rightarrow$ Review $\rightarrow$ Fix）を定義します。
• Context Management：各エージェントにその役割に必要な情報だけを提供し、コンテキストの肥大化を防止します。
• Multi-Agent Coordination：CLI および SDK ベースのさまざまな AI エージェントを相互交換可能なプロバイダーとしてサポートします。
• Traceability：すべてのステップのログとレポートを保持し、タスクから Pull Request への経路を監査可能にします。
• Integration：GitHub と GitLab の Issue に対する組み込みサポートにより、プロジェクト管理ツールから直接タスクをキューイングできます。