Claude Code TriFlow — Claudeエージェント向け3フェーズ実行ワークフロー

AI/ML

概要

Claude Code TriFlowは、Claude Code互換のエージェントが行うタスクを「計画(/plan)」「実行(/run)」「クリア(/clear)」という三段階で管理することを目的としたツール群です。主にPowerShellで実装されており、todoファイルを最小限に保ちながらエージェントの出力とローカルの永続状態を整合させ、実行の重複を避けつつ品質を担保する仕組みを提供します。READMEにはバージョン3.0やMITライセンスの記載があり、導入手順や貢献ガイド、CLAUDE用の設定例などがリポジトリに含まれている想定です。

GitHub

リポジトリの統計情報

  • スター数: 6
  • フォーク数: 0
  • ウォッチャー数: 6
  • コミット数: 2
  • ファイル数: 14
  • メインの言語: PowerShell

主な特徴

  • /plan → /run → /clear の三段階ワークフローでタスク管理を明確化
  • todoファイルを軽量に保ち、エージェント出力と永続状態の整合を支援
  • PowerShellベースでWindows環境を含むCLI操作に親和性あり
  • MITライセンスで利用・改変が容易

技術的なポイント

TriFlowは設計上、エージェントの「思考(計画)」と「行動(実行)」を分離し、さらに実行後の後片付け(クリア)を明示することで、反復実行や部分的な失敗からの回復を容易にします。具体的には、エージェントが生成するtodoや指示を最小限の表現に留め、実行前に計画を検証して不要な実行を防止するフローが想定されます。また、永続的状態(ファイルやローカルのメタデータ)とエージェントの意図を突き合わせることで、既に達成済みのタスクをスキップしたり、差分だけを適用するような差分実行が可能になります。PowerShellで実装されているため、Windows環境やPowerShell Coreのクロスプラットフォーム環境でスクリプトとして組み込みやすく、CI/CDやローカルの自動化パイプラインへの組み込みも現実的です。READMEやCLAUDE.md.example、INSTALL.mdなどのドキュメントが揃っている点から、導入手順やエージェントとの接続方法、設定テンプレートが提供される設計になっていると推測できます。品質担保のための検証ステップやログ出力、場合によっては差し戻し(/clear)によるロールバック手順も用意されていることが想定され、実運用での安全性を重視した設計がうかがえます。

プロジェクトの構成

主要なファイルとディレクトリ:

  • .gitignore: file
  • CHANGELOG.md: file
  • CLAUDE.md.example: file
  • CONTRIBUTING.md: file
  • INSTALL.md: file

…他 9 ファイル

(注)PowerShellスクリプト、README、LICENSE、バージョンバッジや設定テンプレートが含まれる想定です。

まとめ

Claude Codeエージェントの実行を安全に管理する三段階ワークフローを提供する軽量なPowerShellツール群です。

リポジトリ情報:

READMEの抜粋:

Claude Code TriFlow

Version License Claude Code

Intelligent /plan/run/clear workflow guidance for Claude Code agents. TriFlow keeps todo files lean, aligns execution with persistent state, and enforces quality v…