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: falseou 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ção | Fluxo de Trabalho |
|---|---|
| "configurar plano de batalha", sem configuração, novo rastreador, novo contexto | Workflows/Setup.md |
/BattlePlan [contexto] [--mine] [--skip-audit] [--launch], --audit | Workflows/Plan.md |
/BattlePlan --close | Workflows/Close.md |
/BattlePlan --draft (automático), agendamento do rascunho | Workflows/Draft.md |
--add, --done, --cancel, --restore, --sweep, batch-add, importar tarefas de tickets ou reuniões | Workflows/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:
| Arquivo | Escrito por | Contém |
|---|---|---|
YYYY-MM-DD-handoff-<host>.md | --close | Primeira 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 | --draft | Plano mais propostas de auditoria pré-preenchidas; nada é escrito no rastreador |
YYYY-MM-DD-plan.md | /BattlePlan | O 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
| Script | Faz |
|---|---|
| `setup_tracker.py check | init` |
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 add | batch-add |
| `run_draft.sh --install | --check |
tracker.py | Backends 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!rowem uma única chamadabatch-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.pyrejeita IPs, URLs e osforbidden_patternsdo 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.