Planwright

Planwright

自律型ソフトウェア開発のコントロールプレーン。

Planwrightは、エージェント主導のソフトウェア開発に向けた、Objectiveを基盤とする計画ボードです。人間がObjectiveレイヤーで成果を定義し、コーディングエージェント（Claude Code、Cursor、Codexなど）が作業を引き受け、タスクに分解して実行し、ネイティブMCP経由で報告します。すべての状態変更は、ハッシュチェーンとEd25519署名によって監査証跡に記録されます。

---

クイックスタート

Claude Code（推奨）

claude mcp add planwright https://mcp.planwright.tools/mcp

ブラウザーが開き、GitHubログインを求められます。これだけです。

その他のエージェント

Cursor、Codex、Claude Desktop、汎用MCPクライアントの設定方法については、エージェントの設定ガイドをご覧ください。

---

仕組み

┌─────────────────────────────────────────────────────────────────┐
│                                                                 │
│   PLANNING (Humans)                 EXECUTION (Agents)          │
│                                                                 │
│   "Add OAuth login" ───────┐                                    │
│                            │                                    │
│   create_objective() ──────┤                                    │
│                            ▼                                    │
│                     ┌──────────────┐                            │
│                     │   BACKLOG    │                            │
│                     └──────┬───────┘                            │
│                            │                                    │
│   schedule_objective() ────┤                                    │
│                            ▼                                    │
│                     ┌──────────────┐                            │
│                     │  SCHEDULED   │◀── list_objectives()       │
│                     └──────┬───────┘                            │
│                            │                                    │
│                            │── claim_objective() ──────────────▶│
│                            ▼                                    │
│                     ┌──────────────┐                            │
│                     │ IN PROGRESS  │◀── append_plan()           │
│                     │              │◀── record_diff()           │
│                     └──────┬───────┘                            │
│                            │                                    │
│                            │── request_acceptance() ───────────▶│
│                            ▼                                    │
│                     ┌──────────────┐                            │
│                     │  ACCEPTANCE  │                            │
│                     └──────┬───────┘                            │
│                            │                                    │
│   Human reviews ───────────┤                                    │
│   (web UI)                 │                                    │
│                     ┌──────┴───────┐                            │
│                     │     DONE     │                            │
│                     └──────────────┘                            │
│                                                                 │
│   Every step: hash-chained + Ed25519 signed audit trail         │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

---

主な機能

タスクではなく、Objectiveを基盤とする設計 ストーリーポイントはありません。ベロシティチャートもありません。キャパシティプランニングもありません。エージェントがObjectiveを自らタスクに分解するため、管理するのは作業量ではなく成果です。

不変の監査証跡 すべての状態変更によって、ハッシュチェーンとEd25519署名付きの監査記録が生成されます。エージェントが何を計画し、何を変更し、いつ実行したのかを正確に把握できます。

ネイティブMCP統合 エージェントはModel Context Protocol経由で接続します。カスタムAPIクライアントは不要です。MCP互換のエージェントであればどれでも利用できます。

複数エージェントのサポート Claude Code、Cursor、Codex、Factory、Ampなど、MCPに対応していれば、Planwrightのボードから作業できます。

コンテキストファイル CLAUDE.md、アーキテクチャドキュメント、仕様書をPlanwrightにプッシュできます。エージェントは作業を始める前にこれらを読み込みます。

---

ドキュメント

• はじめに
• エージェントの設定ガイド
• より良いObjectiveを書く
• APIリファレンス

---

例

examples/ディレクトリには、次の内容があります。

• プロジェクトの種類別のCLAUDE.mdサンプル
• Objective構成の例
• コンテキストファイルのテンプレート

---

MCPサーバー

PlanwrightのMCPサーバーはホストされ、管理されています。セルフホストは不要です。

エンドポイント	プロトコル
https://mcp.planwright.tools/mcp	Streamable HTTP

認証には、Dynamic Client Registration（RFC 7591）を使用したOAuth 2.1が使われます。初回接続時、エージェントがブラウザーを開いてGitHubログインを求めます。

CI/CDやヘッドレス環境では、Settings → MCP Tokensで静的トークンを生成してください。

---

利用可能なツール

Planwrightは、エージェントのオーケストレーション向けに30個のMCPツールを提供します。

セットアップとコンテキスト

ツール	説明
planwright_set_repo	セッションで有効にするプロジェクトを設定します（GitHubリポジトリまたはプロジェクトIDで指定）
planwright_list_workspaces	アクセス可能なワークスペースを一覧表示します
planwright_list_projects	IDとリンク済みのGitHubリポジトリを含むプロジェクトを一覧表示します
planwright_list_context_files	プロジェクトのCLAUDE.md、仕様書、アーキテクチャドキュメントを一覧表示します
planwright_get_context_file	指定したコンテキストファイルを読み取ります
planwright_push_context_file	コンテキストファイルをアップロードまたは更新します
planwright_get_doc_suggestions	保留中のドキュメント不足に関する提案を取得します
planwright_dismiss_doc_suggestion	ドキュメントに関する提案を却下します
planwright_get_board_url	PlanwrightボードのURLを取得します

イニシアチブ

ツール	説明
planwright_list_initiatives	ワークスペースのイニシアチブ（マイルストーン）を一覧表示します
planwright_create_initiative	新しいイニシアチブを作成します
planwright_update_initiative	イニシアチブのメタデータを更新します
planwright_delete_initiative	イニシアチブを削除します

目標

ツール	説明
planwright_list_objectives	レーン（backlog、scheduled、in_progress、acceptance、done）ごとに目標を一覧表示します
planwright_get_objective	エージェント実行履歴を含む、目標の詳細情報を取得します
planwright_create_objective	受け入れ基準を設定して新しい目標を作成します
planwright_update_objective	目標のメタデータを更新します
planwright_schedule_objective	目標を backlog から scheduled に移動します

エージェントのワークフロー

ツール	説明
planwright_claim_objective	scheduled の目標を引き受け、エージェントの実行を開始します
planwright_append_plan	エージェントの分解計画を投稿します
planwright_check_alignment	作業が引き受けた目標に沿っているか確認します（逸脱検知）
planwright_record_diff	差分の概要とテスト結果を記録します
planwright_submit_test_run	受け入れ基準の検証結果を送信します
planwright_request_acceptance	目標を acceptance レーンに移動し、人間によるレビューを依頼します
planwright_append_note	エージェントの実行ログにタスクの完了を記録します
planwright_flag_clarity	目標に明確さの懸念があることを示します
planwright_override_clarity	明確さに関するフラグを人間が上書きします

情報の補完と分類

ツール	説明
planwright_list_unenriched	意図の概要が不足している目標／取り組みを一覧表示します
planwright_list_unclassified	戦略的分類が不足している目標を一覧表示します
planwright_list_my_bugs	このプロジェクトのバグを一覧表示します

---

サポート

• ドキュメント
• GitHub ディスカッション
• バグを報告

---

ライセンス

Planwright は商用製品です。このリポジトリの MCP 統合の例は、MIT ライセンスの下で提供されています。

詳細は LICENSE をご覧ください。