BattlePlan (Plan de Batalla)

Plan de ejecución diaria a partir de un rastreador de tareas (CSV local, libro de Excel o Google Sheet). Agrupa tareas abiertas por contexto y subcontexto, estima tiempo, encuentra hilos paralelos y escribe indicaciones de inicio listas para pegar por hilo.

¿Qué es BattlePlan (Plan de Batalla)?

BattlePlan es una habilidad de agente diseñada para profesionales técnicos que buscan optimizar su flujo de trabajo diario. Conecta con un rastreador de tareas (CSV, Excel o Google Sheets), agrupa tareas abiertas por contexto y subcontexto, estima tiempos, identifica hilos paralelos y genera indicaciones de inicio listas para usar en nuevas sesiones de agente. A diferencia de empezar desde cero, BattlePlan recapitula sesiones previas del agente y commits de git, precompleta la auditoría y ofrece comandos de reanudación. Soporta plataformas como Claude Code y es altamente configurable para equipos multi-máquina. Su ciclo de día incluye un cierre al final del día (--close), un borrador matutino sin supervisión (--draft) y gestión completa de tareas (añadir, completar, cancelar, restaurar, barrer, importación por lotes). Los scripts utilizan `uv run --script` (PEP 723), eliminando la necesidad de entornos virtuales, y están diseñados para ser compartidos sin datos personales.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/juanmherrerav/agent-workday-skills/tree/main/skills/BattlePlan

Installed? Explore more Productividad y colaboración skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿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: false o 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ónFlujo de trabajo
"configurar battleplan", sin configuración, nuevo rastreador, nuevo contextoWorkflows/Setup.md
/BattlePlan [contexto] [--mine] [--skip-audit] [--launch], --auditWorkflows/Plan.md
/BattlePlan --closeWorkflows/Close.md
/BattlePlan --draft (sin supervisión), programar el borradorWorkflows/Draft.md
--add, --done, --cancel, --restore, --sweep, batch-add, importar tareas desde tickets o reunionesWorkflows/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:

ArchivoEscrito porContiene
YYYY-MM-DD-handoff-<host>.md--closePrimera 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--draftPlan más propuestas de auditoría prellenadas; nada escrito en el rastreador
YYYY-MM-DD-plan.md/BattlePlanEl 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

ScriptHace
`setup_tracker.py checkinit`
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 addbatch-add
`run_draft.sh --install--check
tracker.pyBackends 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!fila en una sola llamada batch-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.py rechaza IPs, URLs y los forbidden_patterns del 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.

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

CodeQuality

Code quality loop for any repo, seen through two lenses — a tool lens (linters, type checkers, security, dead-code and duplication scanners; fix by P0 security → P1 correctness → P2 maintainability) and a principle lens (SOLID + Clean Code smells; one principle at a time, propose → confirm → apply behind characterization tests). One manifest of free local tools, one scan, one fix loop, one mandatory Quality Improvement Report. USE WHEN improve code quality, analyze code, fix linting, reduce duplication, add types, security scan, test coverage, refactor, improve code design, apply SOLID, clean code refactor, reduce complexity, kill code smells, make code maintainable, refactor legacy code, single responsibility, dependency inversion, remediation sprint, install quality tools, quality baseline, smell report, refactoring roadmap, what should we fix first. NOT FOR the issue lifecycle, branches, PRs or merging (use IssueFlow; its Remediation workflow calls this skill to pick and scope the w

MeetingAnalysis

Turn meetings into structured summaries and tracked action items. Transcribes recordings locally (faster-whisper on CUDA, Apple Silicon or CPU), imports Google Meet / Gemini notes through connectors, or takes pasted notetaker transcripts; writes a summary with decisions and an action table; pushes only your own items to the BattlePlan tracker. Includes an unattended inbox ingest (drop a recording, get a summary) and a hard rule that recordings never land in a git repo. USE WHEN analyze meeting, meeting summary, transcribe meeting, transcribe recording, summarize this call, what happened in the meeting, import meeting notes, Gemini notes, Google Meet notes, import meetings to tracker, auto ingest meetings, meeting inbox, process recordings folder, set up meeting analysis.

Skills relacionados