Quarterback

Quarterback

状況を見極め、プレイを決めましょう。

複数のプロジェクトを担当する方向けの、戦略的なタスク優先順位付けとエージェントのオーケストレーションです。

---

他のAIタスクマネージャーは、1つのプロジェクトをサブタスクに分解します。Quarterbackは、5要素の重み付けスコアリングエンジン、組織のコンテキスト、時間を考慮した計画を使って、10個のプロジェクトのうち今どれを優先すべきか判断するのに役立ちます。ローカルで動作し、無料で利用でき、単体のCLIとClaude用のMCP サーバーの両方として機能します。

Quarterbackの特長

機能	Quarterback	TaskMaster AI	Shrimp Task Manager
複数プロジェクトの優先順位付け	5要素の重み付けエンジン	単一プロジェクトの分解	単一プロジェクト
アドバイザリードキュメントシステム	目標に照らして記事を分析	なし	なし
エージェントのオーケストレーション	自律性レベル＋ウェブフック	なし	なし
時間を考慮した計画	勤務時間、昼休み、バッファー時間	なし	なし
組織のコンテキスト	目標、制約、ワークフロー	なし	なし
ナレッジウィキ（Playbook）	セッションをまたいだ一貫性を保つLLM管理のウィキ	なし	なし
競合の検出	プロジェクト間のスケジュール競合	なし	なし
単体のCLI	AIランタイムなしで使える完全なCLI	AIが必要	AIが必要
費用	無料（MIT）	無料	無料

クイックスタート

# Install
pip install quarterback

# Initialize (creates ~/.quarterback/)
quarterback init

# Interactive setup wizard — walks you through org, goals, workflows, projects, constraints
quarterback setup

# Add your first project and tasks
quarterback add "Launch landing page" --project "My Startup" --priority 4 --effort 3 --impact 5
quarterback add "Write blog post" --project "Content" --priority 3 --effort 2 --impact 3

# See what to work on
quarterback priorities

# Find quick wins
quarterback quick-wins

# Plan your day with time awareness
quarterback plan-day

LLMを利用したセットアップ（MCP経由）

QuarterbackをMCP サーバーとして使う場合は、LLMに 「Quarterbackをセットアップして」 と尋ねてください。LLMがsetup_quarterbackツールを呼び出し、ビジネス、目標、ワークフロー、プロジェクト、制約、ナレッジベース（Playbook）について会話形式で聞き取り、すべての設定ファイルとデータベースレコードを一度に書き込みます。YAMLを手動で編集する必要はありません。

MCP サーバー

Quarterbackは、Claude Desktop、Claude Code、Cursor、Windsurf、Cline、OpenAIのエージェントなど、あらゆるMCP互換クライアントで動作します。23個すべてのツールが、LLM固有の依存関係なしに、標準のMCPプロトコル（stdio経由のJSON-RPC）を使用します。

# Install with MCP support
pip install quarterback[mcp]

Claude Desktopの設定（~/Library/Application Support/Claude/claude_desktop_config.json）に追加します。

{
  "mcpServers": {
    "quarterback": {
      "command": "quarterback-server"
    }
  }
}

または、Claude Codeの場合（~/.claude/settings.json）。

{
  "mcpServers": {
    "quarterback": {
      "command": "quarterback-server"
    }
  }
}

同じquarterback-serverコマンドをあらゆるMCPクライアントで使用できます。クライアントのサーバー設定に追加するだけです。

次にLLMに 「今日は何に取り組むべきですか？」 と尋ねてください。LLMはQuarterbackの23個すべてのツールを使って優先事項を分析します。

機能

5要素の優先順位付けエンジン

各タスクを5つの観点からスコアリングします。

要素	重み	測定内容
影響度	30%	タスクの影響度＋プロジェクトの収益／戦略的価値
緊急度	25%	期限までの近さ＋ブロック状態
戦略的重要度	25%	プロジェクトの優先度＋マイルストーンの状態
作業量	15%	反転した作業量スコア（短時間で終わるタスクほど高得点）
クイックウィン	5%	影響度が高く、作業量が少ない場合のボーナス

アドバイザリードキュメントシステム

外部の記事、書籍、アドバイスを組織のコンテキストに照らして分析します。

# Import and auto-analyze an article
quarterback advisory-add --title "Growth Strategy" --url https://example.com/article

# Review the analysis
quarterback advisory-view --id 1

# Approve recommendations (optionally create tasks)
quarterback advisory-approve --id 1 --approve 1,3,5 --create-tasks

分析機能は、すべての推奨事項を目標と制約に照らして確認し、競合や相乗効果を示します。

エージェントオーケストレーション

自律型エージェントの実行タスクを、設定可能な自律性レベルで指定できます。

• Draft：エージェントがレビュー用の下書きを作成します
• Checkpoint：重要な判断の段階でエージェントが一時停止し、承認を求めます
• Autonomous：エージェントがタスクを最後まで実行します

タスクの準備ができると、Webhook が自動化レイヤー（n8n、Zapier、カスタムシステム）に通知します。

Playbook — ナレッジ Wiki

Playbook は、Quarterback のコンパイル済みナレッジレイヤーです。LLM が管理する Markdown Wiki で、ローカル CLI、MCP、自律型エージェントを問わず、すべてのセッションにプロジェクト、意思決定、戦略に関する同じ正規のコンテキストを提供します。

解決する問題： Playbook がない場合、AI セッションは毎回まっさらな状態から始まり、乏しい情報をもとに組織のコンテキストを再構築します。同じクエリを実行する 2 つのセッションでも、それぞれが独立して理解を再構築するため、異なる結果を返すことがあります。Playbook は、すべてのセッションが参照する蓄積されたナレッジを提供します。

仕組み：

~/playbook/                          (or ~/.quarterback/playbook/)
├── CLAUDE.md                        # Schema — how the LLM reads/writes pages
├── raw/                             # Drop zone for source material
└── wiki/
    ├── index.md                     # Master catalog — read this first
    ├── entities/                    # Companies, products, clients, tools
    ├── concepts/                    # Patterns, strategies, recurring themes
    ├── decisions/                   # Decisions with rationale and alternatives
    ├── compiled/                    # QB-compatible files for task scoring
    │   ├── goals.md                 # Read by QB's prioritization engine
    │   └── constraints.md           # Read by QB's conflict detection
    └── log.md                       # Append-only operations record

セットアップ： Playbook は quarterback setup（または MCP セットアップウィザード）の実行時に自動的に作成されます。インタビューでは主要なエンティティ、概念、意思決定について質問し、初期 Wiki ページを作成します。

Playbook を使わない場合： Quarterback はこれまでどおり、~/.quarterback/org-context/ ファイルから目標と制約を読み取ります。Playbook はオプトイン方式です。

Playbook を使う場合： Quarterback は最初に Playbook の compiled/goals.md と compiled/constraints.md を読み取り、Playbook が初期化されていない場合は org-context/ ファイルにフォールバックします。LLM は wiki/index.md を読み取り、組織のコンテキスト全体を把握します。

# Check Playbook status
quarterback playbook status

# Browse the index
quarterback playbook index

# List pages by category
quarterback playbook list --category entities

# Read a specific page
quarterback playbook read entities/my-product.md

# Search across all pages
quarterback playbook search "budget"

Obsidian 連携（任意）： セットアップ中に、Playbook を Obsidian Vault として設定できます。Obsidian で Playbook フォルダーを開くと、グラフ表示やビジュアル編集を利用できます。プログラムからアクセスするには、Obsidian MCP サーバー をインストールしてください。Obsidian への依存は不要です。Playbook は通常の Markdown ファイルとして動作します。

CI/CD パイプライン連携

Quarterback の CLI と webhook システムは、自動化パイプラインとの相性がよく、人手を介さずにタスクのステータスを更新し、成果物を記録して、後続の作業を開始できます。

パイプラインでの直接 CLI 実行

任意の CI/CD ステップに Quarterback コマンドを追加できます。CLI はステートレスで、スクリプトから実行できます。

# GitHub Actions example: auto-update task on deploy
- name: Mark deploy task complete
  run: |
    pip install quarterback
    export QUARTERBACK_HOME=${{ runner.temp }}/.quarterback
    quarterback update 42 --status completed --notes "Deployed via CI, SHA: ${{ github.sha }}"

# After test suite passes, log results to a task
- name: Report test results
  run: |
    quarterback update 38 --notes "Tests passed: 106/106, coverage 87%. Build #${{ github.run_number }}"

# Nightly: check for overdue deliverables and alert
- name: Nightly priority check
  run: |
    quarterback alert-check
    quarterback priorities today --limit 5

Webhook を使ったエージェント型 CI/CD

Webhook を登録して、タスクイベントに自動化レイヤーがリアルタイムで反応できるようにします。

# Register a webhook pointing at your n8n/Zapier/custom endpoint
quarterback-server  # MCP tools available, or use CLI:

# In your automation script: mark a task agent-ready after PR merge
import subprocess
subprocess.run([
    "quarterback", "update", "55",
    "--status", "completed",
    "--notes", f"PR #{pr_number} merged. Deployed to staging."
])

ユースケース：

パイプラインイベント	Quarterback のアクション	動作
PR がマージされた	update_task status=completed	タスクが完了としてマークされ、Webhook が Slack に通知します
デプロイが成功した	SHA と環境に関するメモを付けて update_task を実行	成果物が監査証跡とともに記録されます
毎晩の cron	get_priorities + alert-check	チームに期限超過タスクの日次概要が届きます
テストスイートが失敗した	失敗の詳細を付けて add_task を実行	バグが自動登録され、プロジェクトに紐付けられます
スプリントが開始した	get_priorities + detect_conflicts	作業開始前にスケジュールの競合を明らかにします
エージェントが作業を完了した	update_agent_status status=completed	Webhook がオーケストレーターに通知し、次のタスクが割り当てられます
リリースにタグが付けられた	リリースノートを付けて advisory-add を実行	変更履歴がプロジェクトの目標に照らして分析されます

環境間でのデータベース共有

複数の環境を同じ Quarterback インスタンスに接続します。

# All CI runners share one database via mounted volume or network path
export QUARTERBACK_HOME=/shared/quarterback

# Or per-environment with migration
quarterback migrate /path/to/source

これにより、ローカル CLI、CI パイプライン、MCP 接続エージェントがすべて同じタスクグラフを読み書きできるようになり、手動と自動のワークフロー全体で単一の信頼できる情報源を確保できます。

時間を考慮した計画

quarterback plan-day

勤務時間、昼休み、会議用のバッファ時間、現在時刻を考慮し、残りの勤務時間内に実際に収まるタスクを提案します。

設定

組織のコンテキスト

quarterback init の実行後、quarterback setup を実行して対話型ウィザードを開始するか、MCP 経由で Claude にセットアップウィザードの実行を依頼してください。また、~/.quarterback/org-context/ でコンテキストを手動設定することもできます。

~/.quarterback/org-context/
├── goals.md          # Your strategic, workflow, and project goals
├── projects.yaml     # Active projects with metadata
├── workflows.yaml    # Groups of related projects
└── constraints.md    # Time, budget, and strategic boundaries

テンプレートの例が含まれています。.example ファイルをコピーしてカスタマイズしてください。

セットアップ時に Playbook を有効にすると、goals.md と constraints.md が wiki の compiled/ ディレクトリから自動的に管理されます。組織コンテキストのファイルは引き続き手動で編集できます。Playbook は追加機能であり、必須ではありません。

アラート設定

通知は ~/.quarterback/config/alerts.yaml で設定します。

• 通知しない時間帯（夜間は通知しません）
• 優先度のしきい値（P4 以上のタスクのみ通知します）
• 時間的制約のあるプロジェクト（請求書、税金などは常に通知します）
• 勤務時間と昼休みの設定

CLI コマンド

コマンド	説明
quarterback init	Quarterback を初期化します
quarterback setup	対話型セットアップウィザード
quarterback migrate <dir>	task-manager から移行します
quarterback priorities [today|week|all]	優先順位を付けたタスクリスト
quarterback add "task" [options]	タスクを追加します
quarterback update <id> [options]	タスクを更新します
quarterback list [-s status]	タスクを一覧表示します
quarterback quick-wins	すぐに達成できるタスクを探します
quarterback conflicts	優先順位の競合を検出します
quarterback projects	プロジェクトを一覧表示します
quarterback summary	組織の概要
quarterback plan-day	時間を考慮した日次計画
quarterback advisory-add	アドバイザリードキュメントを追加します
quarterback advisory-list	アドバイザリードキュメントを一覧表示します
quarterback advisory-view --id N	ドキュメントの詳細を表示します
quarterback advisory-analyze --id N	ドキュメントを分析します
quarterback advisory-approve --id N	推奨事項を承認または却下します
quarterback alert-check	アラートを確認します
quarterback alert-summary	日次サマリーを送信します
quarterback playbook status	Playbook の初期化状況
quarterback playbook index	Playbook のマスターカタログを表示します
quarterback playbook list	wiki ページを一覧表示します（--category フィルターを使用）
quarterback playbook read <path>	wiki ページを読み込みます
quarterback playbook search <query>	ページ全体を全文検索します

MCP ツール（全 27 種類）

MCP サーバーとして使用すると、Quarterback は以下のツールを Claude に公開します。

タスク管理：get_priorities、add_task、update_task、get_quick_wins、detect_conflicts、assess_task_value、get_blocking_tasks

プロジェクト管理：add_project、list_projects、update_project、get_organizational_summary

アドバイザリーシステム：add_advisory_document、list_advisory_documents、get_advisory_document、analyze_advisory_document、discuss_advisory_recommendations、adopt_advisory_recommendations

Playbook：playbook_read、playbook_write、playbook_search、playbook_ingest

Webhook：register_webhook、list_webhooks、update_webhook、delete_webhook

エージェントのオーケストレーション：mark_task_agent_ready、get_agent_ready_tasks、update_agent_status

セットアップ：setup_quarterback

環境変数

変数	デフォルト	説明
QUARTERBACK_HOME	~/.quarterback	データディレクトリ
PLAYBOOK_PATH	~/.quarterback/playbook	Playbook wiki の場所（または config/playbook.yaml で設定）
QUARTERBACK_API_URL	None	Pro 機能用に予約されています

コントリビューション

開発環境のセットアップ、コードスタイル、PR の手順については、CONTRIBUTING.md を参照してください。

ライセンス

MIT — LICENSE を参照してください。

---

NodeBridge Automation Solutions が開発 | GitHub Sponsors