qarunbook

qarunbook

テストが必要な内容を洗い出し、実際にテストまで行えます。

リリース前にテストすべきだと、ほとんどのチームはわかっています。それを妨げているのは、規律の問題ではありません。300項目もの確認事項を座って書き出したい人はいませんし、誰かが書き出したとしても、それぞれの結果を記録するのに適した場所がないのです。

qarunbookは、その両方を実現します。

1. 項目を洗い出します。 AI アシスタントにコードベースを調べさせると、リリースする各プラットフォームについて、テストする価値のあるすべてのモジュール、機能、ユーザージャーニーを洗い出し、技術的な知識がない人でも実行できるチェック項目として書き出します。自分で書いたり、すでにある計画をアップロードしたりすることもできます。
2. テストして追跡します。 テスターは上から順にテストし、各項目を合格または不合格として記録し、問題を報告します。リリースがどこまで進んでいるか、何が妨げになっているかを、いつでも確認できます。

qarunbookは、受け入れテスト、つまりリリース前に実際のビルドを人が確認するテストを目的に作られています。ユニットテストでもCIでもありません。アプリを開いて登録し、実際に使ってみるようなテストです。

https://qarunbook.com — 無料で利用できます。

---

MCP サーバーを使う理由

通常、引き継ぎの段階で一連の作業が止まってしまうからです。テスターがバグを見つけ、スプレッドシートやWhatsAppのメッセージに書き込むと、それを読んで内容を理解し、修正し、修正が完了したことをテスターに伝えるのが、誰かの仕事になってしまいます。

qarunbookはMCP経由でランブックを公開するため、コーディングアシスタントがこの一連の流れに直接参加できます。

list_issues            what did the testers actually find (and what they attached)
list_checks failing    what is broken right now
edit_issue             that report was vague — here is what actually happens
resolve_issue          I fixed it

テスターはWebアプリで、スクリーンショット、画面録画、ログを課題に添付できます。動画はページ内でそのまま再生されるため、バグの説明を読むのではなく、実際に確認できます。

課題が修正済みとマークされても、チェック項目が何事もなかったように合格へ戻ることはありません。最後に合格を記録した人は修正前のビルドを確認しているため、項目は R — 再テスト と表示されます。誰かが実際にもう一度確認するまで、この状態は解除されません。ステータスは保存された値ではなく、記録と課題から導き出されるため、ランブックの内容に矛盾が生じることはありません。

インストール

利用するアシスタントを選びます。Claude Code、Cursor、Codexでは、リポジトリがプラグインマーケットプレイスになっているため、1回のインストールでMCP接続と2つのスキルがそろいます。手動で追加するのはトークンだけです。トークンはqarunbookのホームページにある Connect your AI から取得できます。トークンはワークスペースではなく、あなた自身のものです。あなたのロールであなたとして動作し、あなたを削除すると、そのトークンだけが無効になります。

Claude Code

/plugin marketplace add Ifeanyiejindu/qarunbook
/plugin install qarunbook@qarunbook

（または、ターミナルで claude plugin marketplace add Ifeanyiejindu/qarunbook を実行し、続けて claude plugin install qarunbook@qarunbook を実行します）

次に、トークンを設定します。

export QARUNBOOK_TOKEN="qarb_…"

Cursor

Cursorがインストールするのはプラグインであり、個別のスキルフォルダーではありません。そのため、このリポジトリには .cursor-plugin マーケットプレイスマニフェストが含まれています。Cursorで次の操作を行います。

1. サイドバーの Customize を開き、From GitHub Repository を選択します（または Plugins → Add Marketplace を選択します）。
2. https://github.com/Ifeanyiejindu/qarunbook を貼り付けます。
3. qarunbook をインストールします。
4. Plugins → Configure で、QARUNBOOK_TOKEN にトークンを設定します。

これでインストールは完了です。qa-runbook MCP サーバーと2つのスキルが一緒に導入されます。

Codex

このリポジトリはCodexプラグインマーケットプレイス（.agents/plugins/marketplace.json）でもあります。Codexを起動するシェルで次の操作を行います。

export QARUNBOOK_TOKEN="qarb_…"
codex plugin marketplace add Ifeanyiejindu/qarunbook

次にCodex内で /plugins を実行し、qarunbook を見つけてインストールします。Codexは接続時に環境変数からトークンを読み取り、ベアラートークンとして送信します。後で更新するには、codex plugin marketplace upgrade を実行します。

その他のエージェント — Gemini CLI、OpenCode、Clineなど

必要なのは、スキルとMCP接続の2つです。

skills CLIを使えば、SKILL.md ファイルを読み込めるツールにスキルを導入できます。

npx skills add Ifeanyiejindu/qarunbook --global

後で更新するには、npx skills update -g を実行します。次に、MCP サーバーを手動で接続します。Streamable HTTPサーバーのURLは https://qarunbook.com/api/mcp で、Authorization: Bearer <your token> による認証が必要です。

プラグインを使わずに接続する

MCP 接続だけが必要で、スキルが不要な場合は、サーバーを直接追加してください。

Claude Code：

claude mcp add qa-runbook --transport http https://qarunbook.com/api/mcp \
  --header "Authorization: Bearer qarb_…"

Codex — ~/.codex/config.toml：

[mcp_servers.qa-runbook]
url = "https://qarunbook.com/api/mcp"
bearer_token_env_var = "QARUNBOOK_TOKEN"

Cursor — ~/.cursor/mcp.json：

{
  "mcpServers": {
    "qa-runbook": {
      "url": "https://qarunbook.com/api/mcp",
      "headers": { "Authorization": "Bearer qarb_…" }
    }
  }
}

更新

Claude Code：/plugin を開き、Marketplaces を選択して qarunbook を選び、自動更新をオンにします。Claude Code は起動時に更新を確認します。または、手動で更新します：

/plugin marketplace update qarunbook
/plugin update qarunbook@qarunbook
/reload-plugins

Cursor は Plugins パネルからマーケットプレイスのプラグインを更新します。Codex： codex plugin marketplace upgrade。

構成について

1 つのプラグインディレクトリ plugins/qarunbook/ を、次の 3 通りで読み取ります：

ツール	マニフェスト	MCP 設定
Claude Code	.claude-plugin/plugin.json	マニフェスト内に直接記述
Cursor	.cursor-plugin/plugin.json	mcp.json（トークンはプラグイン変数から取得）
Codex	.codex-plugin/plugin.json	.codex-plugin/mcp.json（bearer_token_env_var）

スキル本体は plugins/qarunbook/skills/ に一度だけ配置され、 Agent Skills 形式に準拠しているため、 SKILL.md を読み取れるエージェントなら、そのまま利用できます。

2 つのスキル

/test-checklist	アプリのコードを読み、テストする価値のある項目を洗い出します。各プラットフォームで提供される、すべてのモジュール、機能、ユーザージャーニーが対象です。技術的な知識がないテスターでも実行できる手順として書き出し、テスト計画書に追加します（新しいアプリの場合は計画書を新規作成し、既存のアプリの場合は不足しているチェック項目を追加します）。その後、すぐにテストを開始するか尋ねます。
/qa-runbook	テストを実行します。テスト対象を確認し、実際のアカウントを作成して、ウェブとモバイルを操作し、証拠とともに各結果を記録し、修正を検証します。

どちらも必須ではありません。計画を自分で作成したり、Markdown ファイルをアップロードしたり、チェック項目を 1 つずつ追加したりできます。スキルを使えば、面倒な作業をすばやく進められます。

他の人と共同作業する

ワークスペースにはアプリが保存されます。メンバーは参加して、次のいずれかのロールを割り当てられます：

• テスター — 結果を記録し、問題を報告します
• 管理者 — 上記に加えて、計画の編集、インポート、問題の解決、メンバーの招待を行えます
• オーナー — 上記に加えて、オーナーとワークスペースを管理できます

ロールはウェブアプリと MCP ツールの両方で適用されます。テスターのトークンでは計画を編集できません。

また、相手に表示するアプリを選択できます。すべてのアプリを表示することも、選択したアプリだけを表示することもできます。1 つの製品のテストのために招待された人に、作業中の他のすべてのアプリが一覧表示されることはありません。

各メンバーには専用の MCP トークンが発行されるため、そのトークンを通じて動作するアシスタントは、そのメンバーとして操作します。書き込みにはそのメンバーの名前が記録され、メンバーを削除すると、その人のアクセス権だけが取り消されます。

ツール

読み取り：list_apps · progress · list_checks · get_check · list_issues 書き込み：set_result · add_issue · edit_issue · resolve_issue · update_check · add_check · add_section · create_app · import_plan

import_plan はテスト計画全体を Markdown 形式で受け取り、1 回の呼び出しでアプリを構築します。実際のテスト計画書を取り込むには、この方法を使います。計画には数百ものチェック項目が含まれることもあり、1 つずつ追加する方法は適していません。

セルフホスト

サーバーは MongoDB 上で動作する小規模な Next.js アプリです。QA_MONGO_URI と QA_SESSION_SECRET を設定してデプロイし、QARUNBOOK_URL を独自のインスタンスに向けてください。 メール（招待、パスワードリセット）は任意です。プロバイダーが設定されていない場合、アカウントは誰も締め出すことなく、自動的に認証されます。

ライセンス

MIT — LICENSE を参照してください。qarunbook.com のホステッドサービスは、開始からしばらくの間、無料で利用できます。

ステータス

利用されており、開発が続いています。開始からしばらくの間は無料です。不具合や不足している機能があれば、issue を作成してください。