Que fait BattlePlan ?
Lit chaque tâche ouverte depuis un suivi, la rapproche de ce qui s'est réellement passé depuis le dernier plan, et la transforme en une courte liste de fils de travail parallèles, chacun accompagné d'une invite de démarrage qu'une nouvelle session d'agent peut reprendre à froid.
Étape 0 — chaque invocation commence ici
BP="${SKILLS_HOME:-$HOME/.claude/skills}/BattlePlan/Tools"
uv run --script "$BP/setup_tracker.py" check
success: falseou pas de configuration → exécutez d'abord Workflows/Setup.md. N'inventez jamais un suivi, un nom d'onglet ou un contexte.- La configuration se trouve dans
$BATTLEPLAN_CONFIG, sinon${AGENT_SKILLS_CONFIG:-~/.config/agent-skills}/BattlePlan/config.json. Elle contient le propriétaire, le moteur de suivi, le répertoire des plans et la hiérarchie des contextes. Le répertoire du skill ne contient jamais de données personnelles, il peut donc être partagé et mis à jour librement.
Routage
| Invocation | Workflow |
|---|---|
| "configurer battleplan", pas de config, nouveau suivi, nouveau contexte | Workflows/Setup.md |
/BattlePlan [contexte] [--mine] [--skip-audit] [--launch], --audit | Workflows/Plan.md |
/BattlePlan --close | Workflows/Close.md |
/BattlePlan --draft (sans intervention), planification du brouillon | Workflows/Draft.md |
--add, --done, --cancel, --restore, --sweep, batch-add, import de tâches depuis tickets ou réunions | Workflows/Tasks.md |
La boucle quotidienne
soirée planifié (jours ouvrés) matin
/BattlePlan --close ──▶ /BattlePlan --draft ──▶ /BattlePlan
fait, prochaine étape lit le suivi + remise + ouvre le brouillon ; vous ne faites
par fil, commandes de sessions ; écrit un que confirmer les exceptions, puis
reprise brouillon vous lancez
Chaque étape fonctionne même si la précédente a été sautée : pas de remise → le récapitulatif revient au
jour ouvré précédent ; pas de brouillon → /BattlePlan construit le plan en direct. Les fichiers se trouvent dans plans_dir :
| Fichier | Écrit par | Contient |
|---|---|---|
YYYY-MM-DD-handoff-<hôte>.md | --close | Première ligne Closed: <ISO 8601 avec décalage> on <hôte>, puis fait, en cours (prochaine étape + commande de reprise), reports |
YYYY-MM-DD-draft-<hôte>.md | --draft | Plan plus propositions d'audit préremplies ; rien n'est écrit dans le suivi |
YYYY-MM-DD-plan.md | /BattlePlan | Le plan confirmé, afin que --close puisse comparer le plan avec la réalité |
<hôte> est un alias (mac, wsl, linux ou $BATTLEPLAN_HOST_ALIAS), jamais le nom d'hôte,
car ces fichiers peuvent être partagés entre machines. Les ID de session ne reprennent que sur la machine qui
les a créées : affichez les prochaines étapes des autres hôtes, jamais leurs commandes de reprise.
Multi-machine : définissez plans_git_sync: true et placez plans_dir dans un dépôt git. Les commits
ne touchent que le fichier qui vient d'être écrit (git commit -- <chemin>) après fetch + merge --ff-only.
Ne jamais utiliser stash, reset ou clean : d'autres sessions peuvent contenir des travaux non commités dans ce dépôt.
Si le fast-forward échoue, faites un commit localement et dites que le push est en attente.
Outils
| Script | Fonction |
|---|---|
| `setup_tracker.py check | init` |
pull_tasks.py [contexte] [--mine] | Tâches ouvertes au format JSON avec urgence calculée, échéances, type de propriétaire, dépendances, tickets |
recap_sessions.py --tasks pull.json [--since auto] [--contexte X] | Sessions d'agent + commits git depuis la dernière remise, liés aux tâches par ID de ticket |
| `manage_tasks.py add | batch-add |
| `run_draft.sh --install | --check |
tracker.py | Moteurs de stockage (csv, xlsx, gsheets) et chargement de la configuration ; importé par les autres |
Tous les scripts sont des fichiers uv run --script avec dépendances en ligne (PEP 723) : pas d'environnement virtuel à gérer.
Tests : uv run --with pytest --with openpyxl pytest tests/.
Non-négociables
- Le récapitulatif propose, l'humain confirme. Rien n'est marqué comme fait uniquement sur la base de preuves.
- Références de lignes exactes pour les écritures. Après un tirage, archivez avec des références
Onglet!lignedans un seul appelbatch-done; ne retombez jamais à une recherche par sous-chaîne lorsque la ligne est connue. - Contextes confidentiels (
"confidential": true) ne reçoivent que les ID de ticket et des résumés génériques courts, dans le suivi et dans les remises.manage_tasks.pyrejette les IP, les URL et lesforbidden_patternsdu contexte. - Ne lancez jamais de fils sans confirmation explicite.
- Les commandes du suivi s'exécutent séquentiellement — Google Sheets autorise environ 60 lectures/minute et chaque commande lit chaque onglet.
Dépendances
uv (brew install uv, ou curl -LsSf https://astral.sh/uv/install.sh | sh). git pour l'analyse des commits du
récapitulatif. Moteur Google Sheets uniquement : une clé JSON de compte de service avec accès en édition à la
feuille. Le récapitulatif de session lit les transcriptions de Claude Code (~/.claude*/projects) ; avec d'autres
agents, il ne rapporte que l'activité git et les remises.