Quarterback

Lies das Feld. Sag den Spielzug an.

Strategische Aufgabenpriorisierung und Agenten-Orchestrierung für Multi-Projekt-Betreiber.

Jeder andere KI-Aufgabenmanager unterteilt ein Projekt in Teilaufgaben. Quarterback hilft dir zu entscheiden, welches deiner zehn Projekte du gerade priorisieren solltest — unter Verwendung einer gewichteten 5-Faktoren-Bewertungs-Engine, organisatorischem Kontext und zeitbewusster Planung. Es läuft lokal, kostet nichts und funktioniert sowohl als eigenständige CLI als auch als MCP-Server für Claude.

Was Quarterback anders macht

Schnellstart

# 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-gestützte Einrichtung (via MCP)

Wenn du Quarterback als MCP-Server verwendest, frage dein LLM: "Richte Quarterback für mich ein" — es ruft das Tool setup_quarterback auf, führt ein Gespräch mit dir über dein Unternehmen, deine Ziele, Workflows, Projekte, Einschränkungen und deine Wissensdatenbank (Playbook) und schreibt dann alle Konfigurationsdateien und Datenbankeinträge in einem Rutsch. Kein manuelles YAML-Editieren erforderlich.

MCP-Server

Quarterback funktioniert mit jedem MCP-kompatiblen Client — Claude Desktop, Claude Code, Cursor, Windsurf, Cline, OpenAI-Agenten und anderen. Alle 23 Tools verwenden das Standard-MCP-Protokoll (JSON-RPC über stdio) ohne LLM-spezifische Abhängigkeiten.

# Install with MCP support
pip install quarterback[mcp]

Füge dies zu deiner Claude Desktop-Konfiguration hinzu (~/Library/Application Support/Claude/claude_desktop_config.json):

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

Oder für Claude Code (~/.claude/settings.json):

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

Der gleiche quarterback-server-Befehl funktioniert mit jedem MCP-Client — füge ihn einfach zur Serverkonfiguration deines Clients hinzu.

Frage dann dein LLM: "Woran sollte ich heute arbeiten?" — es wird alle 23 Quarterback-Tools verwenden, um deine Prioritäten zu analysieren.

Funktionen

5-Faktoren-Priorisierungs-Engine

Jede Aufgabe wird anhand von fünf Dimensionen bewertet:

Beratungsdokumenten-System

Analysiere externe Artikel, Bücher und Ratschläge anhand deines organisatorischen Kontexts:

# 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

Der Analysator prüft jede Empfehlung gegen deine Ziele und Einschränkungen und markiert Konflikte sowie Synergien.

Agenten-Orchestrierung

Markiere Aufgaben für die autonome Agentenausführung mit konfigurierbarer Autonomie:

• Entwurf: Der Agent erstellt einen Entwurf zur Überprüfung durch dich

• Prüfpunkt: Der Agent pausiert bei wichtigen Entscheidungen zur Genehmigung

• Autonom: Der Agent führt die Aufgabe bis zum Abschluss aus

Webhooks benachrichtigen deine Automatisierungsebene (n8n, Zapier, benutzerdefiniert), wenn Aufgaben bereit sind.

Playbook — Wissens-Wiki

Playbook ist die kompilierte Wissensebene von Quarterback. Es ist ein LLM-gepflegtes Markdown-Wiki, das jeder Sitzung — lokale CLI, MCP oder autonomer Agent — denselben kanonischen Kontext über deine Projekte, Entscheidungen und Strategien gibt.

Das Problem, das es löst: Ohne Playbook beginnt jede KI-Sitzung von vorne und leitet deinen organisatorischen Kontext aus spärlichen Signalen neu ab. Zwei Sitzungen, die dieselbe Abfrage ausführen, können unterschiedliche Ergebnisse liefern, da sie das Verständnis unabhängig voneinander rekonstruieren. Playbook bietet akkumuliertes Wissen, aus dem alle Sitzungen lesen.

Wie es funktioniert:

~/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

Einrichtung: Playbook wird automatisch während quarterback setup (oder dem MCP-Einrichtungsassistenten) erstellt. Das Interview fragt nach deinen wichtigsten Entitäten, Konzepten und Entscheidungen und erstellt dann erste Wiki-Seiten.

Ohne Playbook: Quarterback funktioniert genau wie zuvor — es liest Ziele und Einschränkungen aus ~/.quarterback/org-context/-Dateien. Playbook ist optional.

Mit Playbook: Quarterback liest zuerst compiled/goals.md und compiled/constraints.md aus dem Playbook und greift auf org-context/-Dateien zurück, falls Playbook nicht initialisiert ist. Dein LLM liest wiki/index.md für den vollständigen organisatorischen Kontext.

# 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-Integration (optional): Während der Einrichtung kannst du wählen, Playbook als Obsidian-Vault zu konfigurieren. Öffne den Playbook-Ordner in Obsidian für Graph-Visualisierung und visuelle Bearbeitung. Installiere einen Obsidian MCP-Server für den programmatischen Zugriff. Keine Obsidian-Abhängigkeit erforderlich — Playbook funktioniert als einfache Markdown-Dateien.

CI/CD-Pipeline-Integration

Die CLI und das Webhook-System von Quarterback machen es zu einer natürlichen Ergänzung für automatisierte Pipelines — aktualisiere den Aufgabenstatus, protokolliere Ergebnisse und löse nachgelagerte Arbeit aus, ohne dass ein Mensch eingreifen muss.

Direkte CLI in Pipelines

Füge Quarterback-Befehle zu jedem CI/CD-Schritt hinzu. Die CLI ist zustandslos und skriptbar:

# 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

Agentische CI/CD mit Webhooks

Registriere einen Webhook und lass deine Automatisierungsebene in Echtzeit auf Aufgabenereignisse reagieren:

# 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."
])

Anwendungsfälle:

Gemeinsame Datenbank über Umgebungen hinweg

Verweise mehrere Umgebungen auf dieselbe Quarterback-Instanz:

# 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

Dies ermöglicht es deiner lokalen CLI, CI-Pipelines und MCP-verbundenen Agenten, alle denselben Aufgabengraphen zu lesen und zu schreiben — was dir eine einzige Quelle der Wahrheit über manuelle und automatisierte Workflows hinweg gibt.

Zeitbewusste Planung

quarterback plan-day

Berücksichtigt deine Arbeitszeiten, Mittagspause, Pufferzeit für Meetings und die aktuelle Uhrzeit, um Aufgaben vorzuschlagen, die tatsächlich in deinen verbleibenden Tag passen.

Konfiguration

Organisatorischer Kontext

Führe nach quarterback init den Befehl quarterback setup für einen interaktiven Assistenten aus oder bitte Claude, den Einrichtungsassistenten via MCP auszuführen. Du kannst deinen Kontext auch manuell in ~/.quarterback/org-context/ konfigurieren:

~/.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

Beispielvorlagen sind enthalten — kopiere sie aus den .example-Dateien und passe sie an.

Wenn du Playbook während der Einrichtung aktivierst, werden goals.md und constraints.md automatisch aus dem compiled/-Verzeichnis des Wikis gepflegt. Du kannst die org-context-Dateien weiterhin manuell bearbeiten — Playbook ist additiv, nicht erforderlich.

Alarmkonfiguration

Konfiguriere Benachrichtigungen in ~/.quarterback/config/alerts.yaml:

• Ruhezeiten (keine Benachrichtigungen nachts)

• Prioritätsschwellenwerte (nur für P4+-Aufgaben benachrichtigen)

• Zeitkritische Projekte (immer für Rechnungen, Steuern usw. benachrichtigen)

• Einstellungen für Arbeitszeiten und Mittagspause

CLI-Befehle

MCP-Tools (insgesamt 27)

Wenn Quarterback als MCP-Server verwendet wird, stellt es Claude diese Tools zur Verfügung:

Aufgabenverwaltung: get_priorities, add_task, update_task, get_quick_wins, detect_conflicts, assess_task_value, get_blocking_tasks

Projektmanagement: add_project, list_projects, update_project, get_organizational_summary

Beratungssystem: 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

Webhooks: register_webhook, list_webhooks, update_webhook, delete_webhook

Agenten-Orchestrierung: mark_task_agent_ready, get_agent_ready_tasks, update_agent_status

Einrichtung: setup_quarterback

Umgebungsvariablen

Mitwirken

Siehe CONTRIBUTING.md für die Entwicklungseinrichtung, den Code-Stil und den PR-Prozess.

Lizenz

MIT - siehe LICENSE

Erstellt von NodeBridge Automation Solutions | GitHub Sponsors