Quarterback

フィールドを読み、プレイをコールせよ。

複数プロジェクトを抱えるオペレーター向けの戦略的タスク優先順位付けおよびエージェントオーケストレーションツール。

👁 PyPI
👁 Python
👁 License: MIT
👁 CI
👁 bobbyrgoldsmith/quarterback MCP server

他のAIタスクマネージャーは、1つのプロジェクトをサブタスクに分解するだけです。Quarterbackは、5要素の加重スコアリングエンジン、組織のコンテキスト、および時間認識型プランニングを使用して、10個のプロジェクトのうちどれを今優先すべきかを決定する手助けをします。ローカルで動作し、無料で利用でき、スタンドアロンのCLIとしても、Claude用のMCPサーバーとしても機能します。

Quarterbackが他と異なる点

Related MCP server: GitHub Project Manager MCP

クイックスタート

# 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をセットアップして」と伝えてください。setup_quarterbackツールが呼び出され、ビジネス、目標、ワークフロー、プロジェクト、制約、ナレッジベース（Playbook）について対話形式でヒアリングを行い、すべての設定ファイルとデータベースレコードを一括で作成します。手動でのYAML編集は不要です。

MCPサーバー

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

# 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に「今日取り組むべきことは？」と尋ねれば、23個のQuarterbackツールすべてを使用して優先順位を分析します。

機能

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

すべてのタスクは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

アナライザーはすべての推奨事項を目標や制約と照らし合わせ、競合や相乗効果をフラグ立てします。

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

設定可能な自律レベルで、自律エージェント実行用のタスクをマークします：

• ドラフト: エージェントがレビュー用のドラフトを作成

• チェックポイント: エージェントが重要な決定ポイントで承認のために一時停止

• 自律: エージェントが完了まで実行

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

Playbook — ナレッジWiki

PlaybookはQuarterbackのコンパイル済みナレッジレイヤーです。これはLLMが管理するMarkdown Wikiであり、ローカルCLI、MCP、自律エージェントなど、すべてのセッションにプロジェクト、決定事項、戦略に関する同一の標準コンテキストを提供します。

解決する問題: Playbookがない場合、AIセッションは毎回ゼロから開始され、断片的なシグナルから組織のコンテキストを再導出します。同じクエリを実行しても、セッションごとに理解を個別に再構築するため、異なる結果が生じることがあります。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ボルトとして設定することを選択できます。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インスタンスに向けることができます：

# 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接続エージェントのすべてが同じタスクグラフを読み書きでき、手動および自動ワークフロー全体で単一の信頼できる情報源（Single Source of Truth）が得られます。

時間認識型プランニング

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/ディレクトリから自動的に維持されます。引き続きorg-contextファイルを手動で編集することも可能です。Playbookは追加機能であり、必須ではありません。

アラート設定

~/.quarterback/config/alerts.yamlで通知を設定します：

• 静かな時間帯（夜間の通知なし）

• 優先度しきい値（P4以上のタスクのみ通知）

• 時間に敏感なプロジェクト（請求書、税金などは常に通知）

• 勤務時間と昼食休憩の設定

CLIコマンド

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

環境変数

貢献

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

ライセンス

MIT - LICENSEを参照

Built by NodeBridge Automation Solutions | GitHub Sponsors

Maintenance

Resources

• GitHub Repository
Need Help?Related Servers

Tools

• add_advisory_documentC
• add_projectD
• add_taskC
• adopt_advisory_recommendationsC
• analyze_advisory_documentC
• assess_task_valueC
• delete_webhookC
• detect_conflictsC