osolmaz/pi-workflows

解決する問題

pi-workflows は、LLM の推論、決定論的コード実行、および人間の監視を組み合わせる必要がある複雑なマルチステップ AI エージェントタスクを管理する問題を解決します。単一の長いプロンプトや予測不可能なエージェントループに頼るのではなく、一時停止・再開・監視が可能な構造的で耐久性のあるワークフローを定義できます。

動作方法

Pi コーディングエージェントの拡張として機能し、ユーザーが TypeScript グラフとしてワークフローを定義できるようにします。これらのグラフは、agent（LLM プロンプト）、compute（TS 関数）、shell（コマンド）、checkpoint（人間の入力）などのノードと、実行パスを決定するエッジで構成されます。

主な技術的要素:

• 耐久性のある実行: 状態はローカルの SQLite データベースに永続化されるため、再起動後もワークフローが生存可能であり、人間の意思決定のために一時停止も可能。
• 統合: Pi 会話内での /workflow コマンドでワークフローをトリガーし、現在の議論のコンテキストを維持。
• 可視化: 専用のターミナルビューア（piw）が、ワークフローの進行状況と履歴をライブでボックスグラフ形式で表示。
• リソースマネージャ: 外部状態（例：PR の監視）と長時間実行される自動化を一致させるための宣言的システム。

対象ユーザー

Pi コーディングエージェントを使用し、自動計画、実装、検証などの高度なソフトウェアエンジニアリングパイプラインを自動化しながら、プロセスの細かい制御を維持したい開発者向けです。

主な特徴

• TypeScript グラフ定義: タイプセーフな TS API を使って、複雑なロジック、ループ、分岐を定義可能。
• 人間が関与するプロセス: 保護された人間の意思決定とチェックポイントを内蔵。
• ライブモニタリング: ステップの再実行やトレースの検査が可能なインタラクティブ TUI ビューア。
• 事前構築済みスキル: 自動計画、自動実装、健全性チェック用のバンドル済みワークフローを提供。
• Herdr 統合: シームレスなペイン管理を実現する Herdr 環境との深いつながり。