PAPI

PAPI

AI は毎回のセッションをゼロから始めます。プロジェクトは軌道に乗せたままに。

AI コーディングツールはコードを書くのは得意ですが、方向性を維持するのは苦手です。スコープは広がり、計画は変わり、その背景にある意思決定はチャットウィンドウで行われ、そこで失われてしまいます。PAPI はプロジェクトを軌道に乗せたままにします。アシスタントに、構造化された計画、実装、レビュー、リリースのサイクルと、何を選び、何を見送り、その理由を記録する意思決定の履歴を提供します。アシスタントは作業中にその記録を読み書きするため、誰もメンテナンスしなくても最新の状態に保たれます。

一度接続すれば、その後は毎回、どのサイクルにいるのか、何が進行中なのか、次に何をすべきなのかを把握した状態でアシスタントがセッションを開始します。

無料で始められます。 プラン → 実装 → レビュー → リリースのループ全体を、最大 3 つのプロジェクトで、カード登録なしで利用できます。無料プランでは、実際のプロジェクトを最初から最後まで進められます。トライアルではありません。料金。

このリポジトリについて。 ドキュメント、インストールガイド、課題トラッカーを提供しています。PAPI のエンジンはクローズドソースでホストされているため、ここからビルドするのではなく、接続して利用します。npm の @papi-ai/server パッケージが、サポート対象のローカルランタイムです。このリポジトリの内容は MIT ライセンスです。

クイックスタート

AI にインストールさせましょう。 Cursor、Claude Code、Windsurf、Codex、VS Code、その他の MCP クライアントで、次の内容をアシスタントに貼り付けてください。

https://getpapi.ai/llms.txt を読んで、PAPI をセットアップしてください

アシスタントは手順書を読み、初回実行のすべてを案内します。正しいプロジェクトフォルダーにいることの確認、接続、プロジェクトのセットアップ、最初のサイクルの計画、最初のタスクの実装まで行います。コーディングツールでも、claude.ai や ChatGPT のようなチャットアプリでも動作し、開発者である必要はありません。（アシスタントが URL を取得できない場合に備えて、同じ手順書をこのリポジトリ内の llms.txt と llms-install.md にも置いています。）

あなたにしかできないことが 1 つあります。 getpapi.ai で無料アカウントを作成する必要があります。その後、接続方法を 2 つから選べます。

• 接続トークン（デフォルト）。 getpapi.ai の Connect パネルを開き、「This is your project」の下にあるプロジェクト ID と接続トークンをコピーして、アシスタントに渡します。アシスタントがそれらをツールの設定に追加すれば、ブラウザーを使う手順なしですぐに PAPI を利用できます。
• ブラウザーでサインイン。 アシスタントがサーバーを追加し、ブラウザーで承認します。その画面を操作できるアシスタントはないため、あなた自身で承認する必要があります。承認するまでは、サーバーに Needs authentication と表示されます。

ほとんどのツールは会話の開始時に新しい接続を読み込むため、接続後に新しい会話を開き、アシスタントに orient を実行するよう依頼してください。

自分で接続したいですか？

Claude Code では、最短の方法はプラグインです。2 行で済み、コピーや編集は不要です。

/plugin marketplace add getpapi/papi
/plugin install papi@papi

このプラグインにはサーバー設定に加えて、2 つのスキルが含まれています。check-mcp は接続が機能していない場合に原因を診断し、papi-verify は現在のサイクルのヘルスチェックを行います。

すべてのツールで、同じストリーミング可能な HTTP エンドポイント https://mcp.getpapi.ai/mcp を直接使用できます。Claude Code では次のように設定します。

claude mcp add --transport http papi https://mcp.getpapi.ai/mcp

どちらの方法でも、最後に /mcp → papi → Authenticate を実行してください。または、Connect パネルの接続トークンを使えば、ブラウザーの手順を省略できます。

claude mcp add --transport http papi https://mcp.getpapi.ai/mcp --header "Authorization: Bearer YOUR_CONNECTION_TOKEN" --header "x-papi-project-id: YOUR_PROJECT_ID"

DeepSeek Harness のユーザーは、PAPI 接続トークンを作成した後、リポジトリ管理のバンドルをインストールできます。

dsh plugin --profile web add @papi-ai/deepseek-harness

トークンの取り扱い、検証、互換性、削除については、PAPI for DeepSeek Harness をご覧ください。

Cursor、VS Code、Windsurf、Codex、および一般的な MCP クライアント向けのツール別設定は、docs/install.md にあります。

利用できる機能

• plan は目標を適切な規模のタスクに分割し、それぞれにアシスタントが直接実行できるビルドの引き継ぎ情報を付与します。
• build は、何を構築したか、何に驚いたか、作業中に何を発見したかを記録します。
• review and release でサイクルを締めくくり、各サイクルの結果を次の計画に反映します。
• 数サイクルごとの strategy reviews では、進捗だけでなく、立ち止まって方向性を確認します。
• getpapi.ai の ダッシュボード には、サイクル、ボード、意思決定が表示されるため、尋ねなくてもプロジェクトの状況を把握できます。

方法論こそがこのプロダクトです。アシスタントがあなたと一緒に進める、計画、ビルド、レビュー、リリースのループであり、使うほど蓄積される記憶を備えています。上のバッジにあるように、PAPI はすべてのサイクルで PAPI を使って構築されました。

ハブを開くと、まず「次に何をするか」という問いが表示されます。その下には、計画、ビルド、レビュー、リリースを通じたサイクルの進捗が表示されます。

ボードには全体像が表示されます。アシスタントは作業の副産物としてボードに書き込むため、誰も更新しなくても最新の状態が保たれます。

トラッカーとの違い

Linear、Jira、Asana、Notion と異なり、 PAPI は人間向けに作られてからエージェントにも開放されたものではありません。これらのボードは、人間がチケットを書き、人間がそれを読むことを前提としています。しかも、そのタブは AI から見えません。PAPI のボードには、作業の副産物としてアシスタントが書き込み、読み取ります。ビルドを開始するとタスクが開き、完了するとレポートが記録され、リリースするとサイクルが閉じます。計画を承認し、レビューを承認するのはあなたです。その間にあるチケット管理の作業がなくなります。管理するのはキー入力ではなく、成果です。

Taskmaster や、リポジトリ内にタスクファイルを置く他のツールと異なり、PAPI の状態は、あるツールが一度生成した後に実態とずれていくファイルではありません。ホスト上で構造化されており、サイクル、ビルドレポート、レビューの判定、そして証拠が集まるにつれて変化する信頼度を持つ Active Decisions が記録されています。同じプロジェクトの記憶に Claude Code、Cursor、VS Code、Codex のいずれからもアクセスできるため、ツールを切り替えてもコンテキストはリセットされません。また、前のサイクルで得た学びは、わざわざ伝えることを覚えておかなくても、次の計画に反映されます。

どちらのツールも、批判しているわけではありません。それぞれ別の問題を解決しています。アシスタントが新しいウィンドウを開くたびに起きる問題とは、異なるものです。

Active Decisions は、タスクトラッカーに記録欄がない情報を扱います。何が決定され、なぜそう決め、何を却下し、いつ見直すべきかという情報です。証拠が集まるにつれて信頼度が変化します。

各サイクルの履歴が残るため、プロジェクトの判断の根拠を数か月後も確認できます。履歴を読み返すアシスタントも同様です。

ツール

PAPI は、アシスタントに次の MCP ツールを公開します。一連の作業は、数回の呼び出しで完了します。

基本サイクル

• orient — 現在のサイクル、進行中の作業、推奨される次のアクションを1回の呼び出しで返します。各セッションの開始時に実行してください。
• setup — 新しいプロジェクトに PAPI のひな形を作成します。
• plan — 目標を適切な規模のタスクで構成されるサイクルに分解します。各タスクには、アシスタントがそのまま実行できるビルド引き継ぎが含まれます。
• build_list — 現在のサイクルのタスクと引き継ぎを一覧表示します。
• build_execute — タスクを開始し（ブランチと引き継ぎを作成）、完了します（ビルドレポートを記録します）。
• review_list / review_submit — 完了したビルドを表示し、承認／変更要求／却下の判定を記録します。
• release / close_cycle — 公開バージョンを作成してサイクルを完了する（release）か、バージョンを作成せずに完了します（close_cycle）。
• tutorial_mode — すべての返信で、短い説明と明確な次のステップを提示します。最初の数サイクルに便利です。

ボードとバックログ

• board_view — プロジェクトボードと任意のタスクを確認します。
• board_edit — タスクのステータス、サイクル、優先度、メモを変更します。
• ad_hoc — サイクル外で行った簡単な作業を記録し、プロジェクト履歴に反映します。
• idea — 機能、バグ、調査メモをバックログに登録します。
• bug — ボードにバグを報告します。

戦略と分析

• strategy_review — 数サイクルごとに立ち止まり、進捗だけでなく方向性を確認します。
• strategy_change — Active Decision を、置き換え履歴とともに記録します。
• zoom_out — 複数のサイクルを対象に、定期的な振り返りを行います。

ドキュメントとプロジェクト

• doc_register / doc_search — プロジェクトの参照ドキュメントを登録、検索します。
• project_list / project_switch / project_create — 複数の PAPI プロジェクトを管理します。

チーム

• join — チームメイトから招待されたプロジェクトに参加します。
• contributor_list / contributor_add — プロジェクトの参加者を確認、管理します。

ドキュメント

このリポジトリ内：

ドキュメント	内容
llms.txt	エージェント向けの運用ガイドです。AI に渡してください（公開版：getpapi.ai/llms.txt）
llms-install.md	AI アシスタント向けのツール別インストール手順
docs/install.md	サポート対象のすべてのツールのインストール方法
docs/how-it-works.md	サイクル、引き継ぎ、意思決定と、それぞれの仕組み
docs/troubleshooting.md	接続の問題、プロジェクトのルーティング、よくある問題の解決方法

ウェブサイトでドキュメントをすべてご覧いただけます。アカウントは不要です。

ページ	内容
クイックスタート	5分以内に最初のサイクル計画を作成するまで
ワークフロー	計画 → ビルド → レビュー → リリースの全サイクル
概念	サイクル、引き継ぎ、Active Decisions などの用語
チートシート	すべてのコマンドを1ページに掲載
ツールリファレンス	パラメーターと使用例を含む、すべての PAPI MCP ツール
トラブルシューティング	接続と認証の問題を解決するための手引き
ハンドブック	チーム向け：ダッシュボード、サイクルレポート、レビューフローの確認方法

コミュニティとサポート

行き詰まったり、何かが壊れたりしましたか？Issue を作成してください。状況ごとのテンプレートが用意されています。PAPI が接続できない、または認証できない場合は、接続の問題のテンプレートを使用してください。最も多くの人がつまずくのはこの問題です。

• 接続の問題 · バグ報告 · 質問 · 機能リクエスト
• 質問はDiscordのほうがすばやく回答を得られます。また、リリースノートもまずこちらに掲載されます。
• CONTRIBUTING.mdでは、役に立つ報告の書き方と、ドキュメントのプルリクエストで変更できる内容について説明しています。
• 脆弱性を見つけましたか？Issue は作成せず、非公開の連絡窓口を記載したSECURITY.mdをご確認ください。

リポジトリにスターを付ける

PAPI が役に立ったら、スターを付けてください。お願いしたいのはそれだけです。AI アシスタントを使って開発している人たちに見つけてもらうきっかけになります。

リンク

• ウェブサイトとダッシュボード：getpapi.ai
• 料金：getpapi.ai/pricing — 無料プランがあり、カード情報は不要です
• 各サイクルでリリースされた内容：getpapi.ai/changelog
• データ、アクセス、PAPI にまだ備わっていない機能について：getpapi.ai/trust
• **ライセンス：**このリポジトリの内容（ドキュメント、ガイド、設定例、Dockerfile）は MIT ライセンスです。このライセンスの対象はこのリポジトリのみであり、PAPI エンジン、PAPI の名称やロゴは対象外です。名称とロゴは商標です。