Quarterback

Читай поле. Вызывай игру.

Стратегическая приоритизация задач и оркестрация агентов для операторов нескольких проектов.

Любой другой ИИ-менеджер задач разбивает один проект на подзадачи. Quarterback помогает вам решить, какой из ваших десяти проектов приоритизировать прямо сейчас — используя 5-факторный движок взвешенной оценки, организационный контекст и планирование с учетом времени. Он работает локально, ничего не стоит и функционирует как автономный CLI и MCP-сервер для Claude.

Что отличает Quarterback

Быстрый старт

# 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 работает с любым MCP-совместимым клиентом — Claude Desktop, Claude Code, Cursor, Windsurf, Cline, агентами OpenAI и другими. Все 23 инструмента используют стандартный протокол MCP (JSON-RPC через stdio) без зависимостей, специфичных для 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-факторный движок приоритизации

Каждая задача оценивается по пяти измерениям:

Система консультативных документов

Анализируйте внешние статьи, книги и советы на соответствие вашему организационному контексту:

# 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

Анализатор проверяет каждую рекомендацию на соответствие вашим целям и ограничениям, отмечая конфликты и синергию.

Оркестрация агентов

Отмечайте задачи для автономного выполнения агентами с настраиваемой степенью автономности:

• Черновик: Агент создает черновик для вашего просмотра

• Контрольная точка: Агент приостанавливается для утверждения ключевых решений

• Автономно: Агент выполняет задачу до завершения

Вебхуки уведомляют ваш уровень автоматизации (n8n, Zapier, кастомные решения), когда задачи готовы.

Playbook — База знаний

Playbook — это скомпилированный уровень знаний Quarterback. Это поддерживаемая LLM вики в формате markdown, которая дает каждой сессии — локальному CLI, MCP или автономному агенту — одинаковый канонический контекст о ваших проектах, решениях и стратегиях.

Проблема, которую он решает: Без Playbook каждая сессия ИИ начинается с нуля и заново выводит ваш организационный контекст из разрозненных сигналов. Две сессии, выполняющие один и тот же запрос, могут дать разные результаты, потому что они реконструируют понимание независимо. 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). Интервью спрашивает о ваших ключевых сущностях, концепциях и решениях, а затем создает начальные страницы вики.

Без Playbook: Quarterback работает точно так же, как и раньше — считывая цели и ограничения из файлов ~/.quarterback/org-context/. Playbook является опциональным.

С Playbook: Quarterback сначала считывает compiled/goals.md и compiled/constraints.md из Playbook, возвращаясь к файлам org-context/, если Playbook не инициализирован. Ваша 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. Откройте папку Playbook в Obsidian для визуализации графа и визуального редактирования. Установите MCP-сервер Obsidian для программного доступа. Зависимость от Obsidian не требуется — Playbook работает как обычные файлы markdown.

Интеграция с CI/CD конвейером

CLI и система вебхуков Quarterback делают его естественным выбором для автоматизированных конвейеров — обновляйте статус задачи, регистрируйте результаты и запускайте последующую работу без участия человека.

Прямой CLI в конвейерах

Добавляйте команды Quarterback к любому шагу CI/CD. 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

Агентский CI/CD с вебхуками

Зарегистрируйте вебхук и позвольте вашему уровню автоматизации реагировать на события задач в режиме реального времени:

# 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, читать и записывать в один и тот же граф задач — предоставляя вам единый источник истины для ручных и автоматизированных рабочих процессов.

Планирование с учетом времени

quarterback plan-day

Учитывает ваши рабочие часы, обеденный перерыв, буферное время для встреч и текущее время, чтобы предложить задачи, которые действительно вписываются в оставшийся день.

Конфигурация

Организационный контекст

После quarterback init запустите quarterback setup для интерактивного мастера или попросите Claude запустить мастер настройки через MCP. Вы также можете вручную настроить свой контекст в ~/.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 будут автоматически поддерживаться из каталога 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

Вебхуки: register_webhook, list_webhooks, update_webhook, delete_webhook

Оркестрация агентов: mark_task_agent_ready, get_agent_ready_tasks, update_agent_status

Настройка: setup_quarterback

Переменные окружения

Участие в разработке

См. CONTRIBUTING.md для настройки разработки, стиля кода и процесса PR.

Лицензия

MIT - см. LICENSE

Создано NodeBridge Automation Solutions | GitHub Sponsors