kris-hansen/comanda

何を解決するか

Comanda は、ソフトウェアリポジトリ内での耐久性があり自己改善可能なエージェントワークフローを管理する、ターミナルネイティブなランタイムを提供します。エージェントがタスクを完了したと主張するが実際には完了していない「幻覚的完了」の問題に対処するために、観測可能な終了基準と自動化された品質ゲート（テストやリンターなど）を実装しており、ワークフローが終了する前にこれらを通過する必要があります。

どう動くか

Comanda はユーザーが英語で望ましい成果を記述すると、それを YAML ベースのプログラムに変換します。このプログラムはステップの順序、並列処理、またはエージェントループを定義します。さまざまな AI モデル（Claude、Gemini、OpenAI、Ollama/vLLM を通じたローカルモデル）とツールを調整し、データをファイルや標準入出力経由で渡します。

主な技術的要素は以下の通りです：

• エージェントループ：状態を保持し、過去の結果に基づいてプロンプトを改善し、各ステップ後に品質ゲートを実行する状態保持型の反復処理。
• コードベースインデキシング：リポジトリ構造とシンボルをキャプチャし、SQLite FTS5 データベースに保存された意味的再検索可能な知識グラフを作成。
• 耐久性のあるメモリ：プロジェクトローカルな意味的メモリシステムで、エージェントが特定のプロジェクトの意思決定、制約、事実を記憶可能。
• MCP 統合：ワークフローを Model Context Protocol (MCP) を通じてツールやプロンプトとして公開可能。

対象ユーザー

フルエージェントフレームワークや可視化オートメーションプラットフォームに切り替えることなく、リポジトリ内で耐久性のあるエージェント作業を管理・再利用したい開発者。

特徴

• 決定論的品質ゲート：既存のテスト、セキュリティチェック、リンターを「完了」の定義として使用。
• 知識グラフビジュアライザー：複雑なコードベースの依存関係やアーキテクチャをナビゲートするためのインタラクティブなローカルブラウザビュー。
• マルチエージェント調整：1つのパイプライン内で異なるモデル（例：Claude でレビュー、OpenAI で実装）を調整可能。
• チェックポイント：長時間実行中のエージェントループを最後のチェックポイントから中断・再開可能。
• 意味的メモリ：オプトイン、名前空間スコープ付きのローカルなプロジェクト固有の事実・意思決定の再検索。