GaosCode/PlanWeave

PlanWeave – コードエージェント向けのファイルバックドループエンジニアリングプラットフォーム

何であるか – PlanWeave は TypeScript/Node.js で構築されたツール（CLI + Electron デスクトップアプリ）であり、曖昧な開発目標を構造化されたファイルバックドタスクグラフに変換できます。各ノード（ファイル）には ブロック（個別の作業単位）が含まれます。ブロックは専門的な AI エージェント（Codex、Claude Code、OpenCode、Pi、Grok、またはローカルスクリプト）によって割り当てられ、実行・レビューされ、その結果はソースファイルと併せて記録されます。この全体のループ（計画、実装、レビュー、回復）は復元可能で観察可能になっています。

なぜ重要か – チャットベースのプロンプトは計画の開始には優れていますが、長期的なエンジニアリングでは脆弱です。計画をリポジトリの第一級の要素（ファイル = ノード、ブロック = ドキュメント）として扱うことで、PlanWeave は状態、履歴、依存関係をプロジェクト内に保持し、以下を可能にします：

• 独立したブロックでの並列作業
• 各ブロックを最も適したエージェントに自動ルーティング
• 実装にフィードバックされる構造化されたレビューのフィードバック
• 後で検査可能な永続的な実行ログ、アーティファクト、メトリクス
• マルチユーザー協働とリモートエージェント実行

コアコンセプト

コンセプト	役割
パッケージ / キャンバス	リポジトリ内の通常のファイルとして保存される、PlanWeave の最上位プロジェクト。
タスクグラフ	依存関係でリンクされたノード（ファイル）；各ノードは1つ以上の ブロック を保持する。
ブロック	割り当て可能な作業単位（例：「関数Xを実装」）。
エクセキュータープロファイル	ブロックを処理するAIモデルまたはローカルコマンドの説明（例：codex-acp）。
エージェントスキル	ブロックに対して特定のアクションを実行する小さな再利用可能なエージェント（plan-maker、plan-runner、plan-reviewer、…）。
MCPサーバー	外部LLM（ChatGPT、Claudeなど）がPlanWeaveのAPIを呼び出して計画を作成または変更できるようにするローカルHTTPトンネル。

主な機能

• ファイルバックドグラフ – 計画は別データベースではなく、ワークスペース内に直接存在します。
• ゼロ構成スタート – CLI（npm i -g @planweave-ai/cli）といくつかのスキルパッケージをインストールし、planweave コマンドを実行するだけです。
• ブロックごとのエージェントルーティング – 各ブロックに最適なLLMまたは決定論的スクリプトを選択できます。
• オートランモード – すぐに実行可能なブロックを継続的に割り当て、エクセキュータを呼び出し、レポートを収集し、レビュー結果をフィードバックします。
• デスクトップキャンバス – タスク、ブロック、依存関係、実行ステータスを視覚的に編集できる（Electronアプリ）。
• 完全な監査トレール – すべての実行でプロンプト、stdout、stderr、構造化されたレポート、メタデータがワークスペース下に保存されます。
• 協働 – メンバー招待、タスク割り当て、コメント、リモートエージェントホストによる共有プロジェクト。
• MCP統合 – ローカルトンネルを公開し、ChatGPT（または他のWeb-LLM）がHTTP経由でPlanWeaveを制御できるようにします。
• 統計と検索 – ツールから離れずに効率メトリクスを表示、ブロックを検索、TODOリストを確認できます。

通常のワークフロー

1. 計画の作成／インポート – plan-maker や plan-importer スキルを介してLLMに、高レベルな目標や既存のドキュメントからパッケージ形式のドラフトを作成してもらいます。
2. 検証とインポート – planweave package-draft validate … と planweave package import … を実行して、計画をリポジトリに反映します。
3. 計画の実行 – plan-coordinator スキル（または直接 planweave run …）を呼び出します。コーディネーターがブロックを割り当て、plan-runner で実装、plan-reviewer でレビューを行い、必要に応じて plan-recovery を使用します。
4. 検査と反復 – CLIコマンド（planweave status、planweave graph inspect、planweave doctor）またはデスクトップUIを使って進捗を確認、ログを閲覧、グラフを調整します。
5. 協働 – チームメイトを招待し、ブロックを割り当て、エージェントをリモートデバイスで実行する（エージェントホスト機能を利用）。

導入方法

# CLIのインストール（npmまたはHomebrew）
npm install -g @planweave-ai/cli
# または
brew install GaosCode/tap/planweave

# バンドルされたエージェントスキルのインストール
npx skills@latest add GaosCode/PlanWeave

# インストールの確認
planweave --help

• 視覚的な体験を求める場合は、リポジトリのリリースページからElectronアプリをダウンロードしてください。
• ChatGPTによる計画を有効にするには、MCPサーバーを起動（planweave mcp tunnel …）し、ChatGPTのツール設定にトンネルを追加してください。

誰が使うべきか

• 再現性があり、監査可能な実行が必要なAI支援コード生成を希望する開発者。
• 複数のAIエージェントが並列で作業できる大規模なコードベースを構築するチーム。
• 「ループエンジニアリング」（プロンプト → 実行 → レビュー → 改善）を実験する研究者。
• 複数ステップのAIワークフローを永続的かつファイルバックドで表現したいすべての人。

ライセンス – MIT（LICENSE を参照）。

---

上記のすべての詳細は、リポジトリのREADMEから直接取得したものであり、追加の機能は推測されていません。