¿Qué hace BattlePlan (Plan de Batalla)?
Lee cada tarea abierta de un rastreador, la reconcilia con lo que realmente ocurrió desde el último plan y la convierte en una lista corta de hilos de trabajo paralelos, cada uno con una indicación de inicio que una nueva sesión de agente puede retomar en frío.
Paso 0 — cada invocación comienza aquí
BP="${SKILLS_HOME:-$HOME/.claude/skills}/BattlePlan/Tools"
uv run --script "$BP/setup_tracker.py" check
success: falseo sin configuración → ejecuta Workflows/Setup.md primero. Nunca inventes un rastreador, un nombre de pestaña o un contexto.- La configuración se encuentra en
$BATTLEPLAN_CONFIG, o en su defecto en${AGENT_SKILLS_CONFIG:-~/.config/agent-skills}/BattlePlan/config.json. Almacena el propietario, el backend del rastreador, el directorio de planes y la jerarquía de contextos. El directorio de la habilidad nunca contiene datos personales, por lo que puede compartirse y actualizarse libremente.
Ruteo
| Invocación | Flujo de trabajo |
|---|---|
| "configurar battleplan", sin configuración, nuevo rastreador, nuevo contexto | Workflows/Setup.md |
/BattlePlan [contexto] [--mine] [--skip-audit] [--launch], --audit | Workflows/Plan.md |
/BattlePlan --close | Workflows/Close.md |
/BattlePlan --draft (sin supervisión), programar el borrador | Workflows/Draft.md |
--add, --done, --cancel, --restore, --sweep, batch-add, importar tareas desde tickets o reuniones | Workflows/Tasks.md |
El ciclo diario
tarde programado (días laborables) mañana
/BattlePlan --close ──▶ /BattlePlan --draft ──▶ /BattlePlan
hecho, siguiente paso por lee el rastreador + traspaso + abre el borrador; solo confirmas
hilo, comandos de reanud. sesiones; escribe un borrador excepciones, luego a trabajar
Cada paso funciona si el anterior se omitió: sin traspaso → la recapitulación recurre al
día laborable anterior; sin borrador → /BattlePlan construye el plan en vivo. Los archivos residen en plans_dir:
| Archivo | Escrito por | Contiene |
|---|---|---|
YYYY-MM-DD-handoff-<host>.md | --close | Primera línea: Cerrado: <ISO 8601 con offset> en <host>, luego hecho, en curso (siguiente paso + comando de reanudación), pendientes |
YYYY-MM-DD-draft-<host>.md | --draft | Plan más propuestas de auditoría prellenadas; nada escrito en el rastreador |
YYYY-MM-DD-plan.md | /BattlePlan | El plan confirmado, para que --close pueda comparar el plan con la realidad |
<host> es un alias (mac, wsl, linux o $BATTLEPLAN_HOST_ALIAS), nunca el nombre del host,
porque estos archivos pueden compartirse entre máquinas. Los IDs de sesión se reanudan solo en la máquina que
los creó: muestra los siguientes pasos de otros hosts, nunca sus comandos de reanudación.
Multi-máquina: establece plans_git_sync: true y coloca plans_dir dentro de un repositorio git. Los commits
afectan solo al archivo recién escrito (git commit -- <ruta>) después de fetch + merge --ff-only.
Nunca hagas stash, reset o clean: otras sesiones pueden tener trabajo sin commit en ese repositorio. Si la
fusión fast-forward falla, haz commit localmente y di que el push está pendiente.
Herramientas
| Script | Hace |
|---|---|
| `setup_tracker.py check | init` |
pull_tasks.py [contexto] [--mine] | Tareas abiertas como JSON con urgencia calculada, fechas límite, tipo de propietario, dependencias, tickets |
recap_sessions.py --tasks pull.json [--since auto] [--context X] | Sesiones de agente + commits de git desde el último traspaso, vinculados a tareas por ID de ticket |
| `manage_tasks.py add | batch-add |
| `run_draft.sh --install | --check |
tracker.py | Backends de almacenamiento (csv, xlsx, gsheets) y carga de configuración; importado por los demás |
Todos los scripts son archivos uv run --script con dependencias en línea (PEP 723): no hay virtualenv que
gestionar. Pruebas: uv run --with pytest --with openpyxl pytest tests/.
No negociables
- La recapitulación propone, el humano confirma. Nada se marca como hecho solo con evidencia.
- Referencias exactas de fila para escrituras. Después de una extracción, archiva con referencias
Tab!filaen una sola llamadabatch-done; nunca recurras a búsqueda por subcadena cuando se conoce la fila. - Contextos confidenciales (
"confidential": true) reciben solo IDs de ticket y resúmenes genéricos cortos, tanto en el rastreador como en los traspasos.manage_tasks.pyrechaza IPs, URLs y losforbidden_patternsdel contexto. - Nunca lances hilos sin confirmación explícita.
- Los comandos del rastreador se ejecutan secuencialmente — Google Sheets permite ~60 lecturas/minuto y cada comando lee cada pestaña.
Dependencias
uv (brew install uv, o curl -LsSf https://astral.sh/uv/install.sh | sh). git para el
escaneo de commits de la recapitulación. Solo backend de Google Sheets: una clave JSON de cuenta de servicio con acceso
de editor a la hoja. La recapitulación de sesiones lee transcripciones de Claude Code (~/.claude*/projects); con otros
agentes solo informa actividad de git y traspasos.