Quarterback

Lee el campo. Llama a la jugada.

Priorización estratégica de tareas y orquestación de agentes para operadores de múltiples proyectos.

Cualquier otro gestor de tareas de IA desglosa un proyecto en subtareas. Quarterback te ayuda a decidir cuál de tus diez proyectos priorizar en este momento, utilizando un motor de puntuación ponderada de 5 factores, contexto organizativo y planificación consciente del tiempo. Se ejecuta localmente, no cuesta nada y funciona tanto como CLI independiente como servidor MCP para Claude.

Qué hace diferente a Quarterback

Inicio rápido

# 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

Configuración impulsada por LLM (vía MCP)

Cuando utilices Quarterback como servidor MCP, pídele a tu LLM: "Configura Quarterback para mí" — llamará a la herramienta setup_quarterback, te entrevistará de forma conversacional sobre tu negocio, objetivos, flujos de trabajo, proyectos, restricciones y base de conocimientos (Playbook), y luego escribirá todos los archivos de configuración y registros de la base de datos de una sola vez. No se requiere edición manual de YAML.

Servidor MCP

Quarterback funciona con cualquier cliente compatible con MCP — Claude Desktop, Claude Code, Cursor, Windsurf, Cline, agentes de OpenAI y otros. Las 23 herramientas utilizan el protocolo MCP estándar (JSON-RPC sobre stdio) sin dependencias específicas de LLM.

# Install with MCP support
pip install quarterback[mcp]

Añádelo a tu configuración de Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

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

O para Claude Code (~/.claude/settings.json):

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

El mismo comando quarterback-server funciona con cualquier cliente MCP; solo añádelo a la configuración del servidor de tu cliente.

Luego pídele a tu LLM: "¿En qué debería trabajar hoy?" — utilizará las 23 herramientas de Quarterback para analizar tus prioridades.

Características

Motor de priorización de 5 factores

Cada tarea se puntúa en cinco dimensiones:

Sistema de documentos de asesoramiento

Analiza artículos, libros y consejos externos frente a tu contexto organizativo:

# 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

El analizador verifica cada recomendación frente a tus objetivos y restricciones, señalando conflictos y sinergias.

Orquestación de agentes

Marca tareas para la ejecución autónoma de agentes con autonomía configurable:

• Borrador: El agente crea un borrador para tu revisión

• Punto de control: El agente se detiene en decisiones clave para su aprobación

• Autónomo: El agente se ejecuta hasta completarse

Los webhooks notifican a tu capa de automatización (n8n, Zapier, personalizada) cuando las tareas están listas.

Playbook — Wiki de conocimiento

Playbook es la capa de conocimiento compilada de Quarterback. Es una wiki en markdown mantenida por LLM que proporciona a cada sesión — CLI local, MCP o agente autónomo — el mismo contexto canónico sobre tus proyectos, decisiones y estrategias.

El problema que resuelve: Sin Playbook, cada sesión de IA comienza desde cero y vuelve a derivar tu contexto organizativo a partir de señales dispersas. Dos sesiones ejecutando la misma consulta pueden producir resultados diferentes porque reconstruyen la comprensión de forma independiente. Playbook proporciona conocimiento acumulado que todas las sesiones leen.

Cómo funciona:

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

Configuración: Playbook se crea automáticamente durante quarterback setup (o el asistente de configuración de MCP). La entrevista pregunta sobre tus entidades, conceptos y decisiones clave, y luego siembra las páginas iniciales de la wiki.

Sin Playbook: Quarterback funciona exactamente igual que antes — leyendo objetivos y restricciones de los archivos ~/.quarterback/org-context/. Playbook es opcional.

Con Playbook: Quarterback lee primero compiled/goals.md y compiled/constraints.md de Playbook, recurriendo a los archivos org-context/ si Playbook no está inicializado. Tu LLM lee wiki/index.md para obtener el contexto organizativo completo.

# 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"

Integración con Obsidian (opcional): Durante la configuración, puedes optar por configurar Playbook como un almacén (vault) de Obsidian. Abre la carpeta Playbook en Obsidian para visualización de grafos y edición visual. Instala un servidor MCP de Obsidian para acceso programático. No se requiere dependencia de Obsidian — Playbook funciona como archivos markdown simples.

Integración de canalización CI/CD

La CLI y el sistema de webhooks de Quarterback lo convierten en un ajuste natural para canalizaciones automatizadas — actualiza el estado de la tarea, registra entregables y activa trabajo posterior sin intervención humana.

CLI directa en canalizaciones

Añade comandos de Quarterback a cualquier paso de CI/CD. La CLI es sin estado y programable:

# 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 agéntico con webhooks

Registra un webhook y deja que tu capa de automatización reaccione a los eventos de tareas en tiempo real:

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

Casos de uso:

Base de datos compartida entre entornos

Apunta múltiples entornos a la misma instancia de 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

Esto permite que tu CLI local, canalizaciones de CI y agentes conectados por MCP lean y escriban en el mismo grafo de tareas, dándote una única fuente de verdad en flujos de trabajo manuales y automatizados.

Planificación consciente del tiempo

quarterback plan-day

Considera tus horas de trabajo, pausa para el almuerzo, tiempo de margen para reuniones y la hora actual para sugerir tareas que realmente encajen en el resto de tu día.

Configuración

Contexto organizativo

Después de quarterback init, ejecuta quarterback setup para un asistente interactivo, o pídele a Claude que ejecute el asistente de configuración a través de MCP. También puedes configurar manualmente tu contexto en ~/.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

Se incluyen plantillas de ejemplo — copia desde los archivos .example y personaliza.

Si habilitas Playbook durante la configuración, goals.md y constraints.md se mantienen automáticamente desde el directorio compiled/ de la wiki. Aún puedes editar manualmente los archivos de contexto organizativo — Playbook es aditivo, no obligatorio.

Configuración de alertas

Configura las notificaciones en ~/.quarterback/config/alerts.yaml:

• Horas de silencio (sin notificaciones por la noche)

• Umbrales de prioridad (solo notificar para tareas P4+)

• Proyectos sensibles al tiempo (notificar siempre para Facturas, Impuestos, etc.)

• Configuración de horas de trabajo y pausa para el almuerzo

Comandos CLI

Herramientas MCP (27 en total)

Cuando se utiliza como servidor MCP, Quarterback expone estas herramientas a Claude:

Gestión de tareas: get_priorities, add_task, update_task, get_quick_wins, detect_conflicts, assess_task_value, get_blocking_tasks

Gestión de proyectos: add_project, list_projects, update_project, get_organizational_summary

Sistema de asesoramiento: 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

Orquestación de agentes: mark_task_agent_ready, get_agent_ready_tasks, update_agent_status

Configuración: setup_quarterback

Variables de entorno

Contribución

Consulta CONTRIBUTING.md para la configuración de desarrollo, estilo de código y proceso de PR.

Licencia

MIT - consulta LICENSE

Creado por NodeBridge Automation Solutions | GitHub Sponsors