BattlePlan

Plano de execução diária a partir de um rastreador de tarefas (CSV local, Excel ou Google Sheet). Agrupa tarefas abertas por contexto e subcontexto, estima tempo, encontra threads paralelas e escreve prompts prontos para colar por thread. Começa a partir de ontem em vez de do zero — recapitula as sessões de agente e commits git do dia anterior, pré-preenche auditoria e oferece comandos de retomada. Inclui passagem de fim de dia (--close), rascunho matinal automático (--draft) e gestão de tarefas (add, done, cancel, restore, sweep, importação em lote). USE QUANDO: planejar meu dia, plano diário, plano de batalha, no que devo trabalhar, fechar o dia, passagem de fim de dia, rascunho matinal, visão geral de tarefas, preparação para daily, priorizar tarefas, adicionar tarefa, marcar tarefa concluída, configurar plano de batalha, configurar rastreador de tarefas.

O que é BattlePlan?

BattlePlan é uma skill para agentes de IA (como Claude Code, Cursor, Codex) que transforma um rastreador de tarefas (CSV local, Excel ou Google Sheets) em um plano de execução diária acionável. Em vez de começar do zero todos os dias, BattlePlan recapitula automaticamente as sessões de agente e commits git do dia anterior, pré-preenche uma auditoria e oferece comandos de retomada para cada thread de trabalho. A skill agrupa tarefas abertas por contexto e subcontexto, estima tempo, identifica threads paralelas e gera prompts iniciais prontos para copiar e colar em novas sessões de agente. Inclui suporte para múltiplas máquinas, sincronização via git, geração de rascunhos matinais automáticos (--draft) e passagem de fim de dia (--close) que registra o progresso real. BattlePlan é particularmente útil para desenvolvedores que gerenciam múltiplas tarefas em contextos diferentes e querem evitar a sobrecarga de lembrar de tudo manualmente, integrando-se diretamente com o fluxo de trabalho do agente.

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

Installed? Explore more Produtividade e Colaboração skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que BattlePlan faz?

Lê cada tarefa aberta de um rastreador, reconcilia com o que realmente aconteceu desde o último plano, e transforma tudo em uma lista curta de threads de trabalho paralelas, cada uma com um prompt inicial que uma nova sessão de agente pode pegar fria.

Passo 0 — toda invocação começa aqui

BP="${SKILLS_HOME:-$HOME/.claude/skills}/BattlePlan/Tools"
uv run --script "$BP/setup_tracker.py" check
  • success: false ou sem configuração → execute Workflows/Setup.md primeiro. Nunca invente um rastreador, um nome de aba ou um contexto.
  • A configuração está em $BATTLEPLAN_CONFIG, senão em ${AGENT_SKILLS_CONFIG:-~/.config/agent-skills}/BattlePlan/config.json. Ela contém o proprietário, o backend do rastreador, o diretório de planos e a hierarquia de contextos. O diretório da skill nunca contém dados pessoais, portanto pode ser compartilhado e atualizado livremente.

Roteamento

InvocaçãoFluxo de Trabalho
"configurar plano de batalha", sem configuração, novo rastreador, novo contextoWorkflows/Setup.md
/BattlePlan [contexto] [--mine] [--skip-audit] [--launch], --auditWorkflows/Plan.md
/BattlePlan --closeWorkflows/Close.md
/BattlePlan --draft (automático), agendamento do rascunhoWorkflows/Draft.md
--add, --done, --cancel, --restore, --sweep, batch-add, importar tarefas de tickets ou reuniõesWorkflows/Tasks.md

O ciclo do dia

 noite                     agendado (dias úteis)          manhã
 /BattlePlan --close  ──▶   /BattlePlan --draft   ──▶   /BattlePlan
 tarefas concluídas,        lê rastreador + passagem +  abre o rascunho; você apenas
 próximo passo por thread,  sessões; escreve um         confirma exceções, depois vai
 comandos de retomada       rascunho

Cada etapa funciona quando a anterior foi pulada: sem passagem → a recapitulação recai no dia útil anterior; sem rascunho → /BattlePlan constrói o plano ao vivo. Os arquivos ficam em plans_dir:

ArquivoEscrito porContém
YYYY-MM-DD-handoff-<host>.md--closePrimeira linha Closed: <ISO 8601 com offset> em <host>, depois tarefas concluídas, em andamento (próximo passo + comando de retomada), pendentes
YYYY-MM-DD-draft-<host>.md--draftPlano mais propostas de auditoria pré-preenchidas; nada é escrito no rastreador
YYYY-MM-DD-plan.md/BattlePlanO plano confirmado, para que --close possa comparar o plano com a realidade

<host> é um apelido (mac, wsl, linux ou $BATTLEPLAN_HOST_ALIAS), nunca o nome do host, porque esses arquivos podem ser compartilhados entre máquinas. IDs de sessão retomam apenas na máquina que os criou: mostre os próximos passos de outros hosts, nunca seus comandos de retomada.

Multi-máquina: defina plans_git_sync: true e coloque plans_dir dentro de um repositório git. Os commits alteram apenas o arquivo recém-escrito (git commit -- <caminho>) após fetch + merge --ff-only. Nunca use stash, reset ou clean: outras sessões podem ter trabalho não commitado nesse repositório. Se o fast-forward falhar, faça commit localmente e informe que o push está pendente.

Ferramentas

ScriptFaz
`setup_tracker.py checkinit`
pull_tasks.py [contexto] [--mine]Tarefas abertas como JSON com urgência calculada, prazos, tipo de proprietário, dependências, tickets
recap_sessions.py --tasks pull.json [--since auto] [--context X]Sessões de agente + commits git desde a última passagem, vinculados a tarefas por ID de ticket
`manage_tasks.py addbatch-add
`run_draft.sh --install--check
tracker.pyBackends de armazenamento (csv, xlsx, gsheets) e carregamento de configuração; importado pelos demais

Todos os scripts são arquivos uv run --script com dependências inline (PEP 723): sem virtualenv para gerenciar. Testes: uv run --with pytest --with openpyxl pytest tests/.

Inegociáveis

  • A recapitulação propõe, o humano confirma. Nada é marcado como concluído apenas com base em evidências.
  • Referências exatas de linhas para escritas. Após uma leitura, arquive com referências Tab!row em uma única chamada batch-done; nunca recorra à busca por substring quando a linha é conhecida.
  • Contextos confidenciais ("confidential": true) recebem apenas IDs de ticket e resumos genéricos curtos, tanto no rastreador quanto nas passagens. manage_tasks.py rejeita IPs, URLs e os forbidden_patterns do contexto.
  • Nunca inicie threads sem confirmação explícita.
  • Comandos do rastreador executam sequencialmente — Google Sheets permite ~60 leituras/minuto e cada comando lê todas as abas.

Dependências

uv (brew install uv, ou curl -LsSf https://astral.sh/uv/install.sh | sh). git para a varredura de commits da recapitulação. Backend Google Sheets apenas: uma chave JSON de conta de serviço com acesso de editor ao documento. A recapitulação de sessões lê as transcrições do Claude Code (~/.claude*/projects); com outros agentes, relata apenas atividade git e passagens.

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.

Habilidades Relacionadas