Was macht BattlePlan?
Liest jede offene Aufgabe aus einem Aufgabenverfolger, gleicht sie mit dem ab, was seit dem letzten Plan tatsächlich passiert ist, und verwandelt sie in eine kurze Liste paralleler Arbeitsstränge, jeder mit einem Start-Prompt, den eine frische Agentensitzung kalt aufnehmen kann.
Schritt 0 – jeder Aufruf beginnt hier
BP="${SKILLS_HOME:-$HOME/.claude/skills}/BattlePlan/Tools"
uv run --script "$BP/setup_tracker.py" check
success: falseoder keine Konfiguration → zuerst Workflows/Setup.md ausführen. Niemals einen Aufgabenverfolger, einen Tab-Namen oder einen Kontext erfinden.- Die Konfiguration liegt unter
$BATTLEPLAN_CONFIG, sonst${AGENT_SKILLS_CONFIG:-~/.config/agent-skills}/BattlePlan/config.json. Sie enthält den Besitzer, das Backend des Aufgabenverfolgers, das Pläne-Verzeichnis und die Kontexthierarchie. Das Skill‑Verzeichnis enthält niemals personenbezogene Daten, sodass es problemlos geteilt und aktualisiert werden kann.
Routenzuordnung
| Aufruf | Workflow |
|---|---|
| „Battleplan einrichten“, keine Konfiguration, neuer Aufgabenverfolger, neuer Kontext | Workflows/Setup.md |
/BattlePlan [Kontext] [--mine] [--skip-audit] [--launch], --audit | Workflows/Plan.md |
/BattlePlan --close | Workflows/Close.md |
/BattlePlan --draft (unbeaufsichtigt), Terminierung des Entwurfs | Workflows/Draft.md |
--add, --done, --cancel, --restore, --sweep, batch-add, Importieren von Aufgaben aus Tickets oder Besprechungen | Workflows/Tasks.md |
Der Tagesablauf
abends geplant (werktags) morgens
/BattlePlan --close ──▶ /BattlePlan --draft ──▶ /BattlePlan
erledigt, nächster Schritt liest Verfolger + Übergabe + öffnet den Entwurf; du bestätigst
pro Strang, Sitzungen; schreibt Entwurf nur Ausnahmen, dann legst du los
Wiederaufnahmebefehle
Jeder Schritt funktioniert, wenn der vorherige übersprungen wurde: keine Übergabe → die Zusammenfassung fällt auf den vorherigen Arbeitstag zurück; kein Entwurf → /BattlePlan erstellt den Plan live. Dateien liegen im plans_dir:
| Datei | Geschrieben von | Enthält |
|---|---|---|
YYYY-MM-DD-handoff-<host>.md | --close | Erste Zeile Closed: <ISO 8601 mit Offset> on <host>, dann erledigt, in Bearbeitung (nächster Schritt + Wiederaufnahmebefehl), Übertragungen |
YYYY-MM-DD-draft-<host>.md | --draft | Plan mit vorausgefüllten Prüfvorschlägen; nichts in den Aufgabenverfolger geschrieben |
YYYY-MM-DD-plan.md | /BattlePlan | Der bestätigte Plan, sodass --close Plan mit Realität vergleichen kann |
<host> ist ein Alias (mac, wsl, linux oder $BATTLEPLAN_HOST_ALIAS), niemals der Rechnername, da diese Dateien zwischen Rechnern geteilt werden können. Sitzungs-IDs werden nur auf dem Rechner fortgesetzt, der sie erstellt hat: Zeige die nächsten Schritte anderer Rechner, niemals ihre Wiederaufnahmebefehle.
Mehrere Rechner: setze plans_git_sync: true und lege plans_dir in ein Git‑Repository. Commits berühren nur die gerade geschriebene Datei (git commit -- <pfad>) nach fetch + merge --ff-only. Niemals stashen, zurücksetzen oder cleanen: andere Sitzungen könnten uncommittete Arbeit in diesem Repository halten. Schlägt der Fast‑Forward fehl, committe lokal und sage, dass der Push aussteht.
Werkzeuge
| Skript | Funktion |
|---|---|
| `setup_tracker.py check | init` |
pull_tasks.py [Kontext] [--mine] | Offene Aufgaben als JSON mit berechneter Dringlichkeit, Fristen, Besitzerart, Abhängigkeiten, Tickets |
recap_sessions.py --tasks pull.json [--since auto] [--context X] | Agentensitzungen + Git‑Commits seit der letzten Übergabe, verknüpft mit Aufgaben über Ticket-ID |
| `manage_tasks.py add | batch-add |
| `run_draft.sh --install | --check |
tracker.py | Speicher-Backends (csv, xlsx, gsheets) und Konfigurationsladen; von den anderen importiert |
Alle Skripte sind uv run --script‑Dateien mit Inline‑Abhängigkeiten (PEP 723): keine virtuelle Umgebung zu verwalten. Tests: uv run --with pytest --with openpyxl pytest tests/.
Unverhandelbar
- Die Zusammenfassung schlägt vor, der Mensch bestätigt. Nichts wird allein aufgrund von Beweisen als erledigt markiert.
- Exakte Zeilenreferenzen für Schreibvorgänge. Nach einem Pull mit
Tab!Zeile-Referenzen in einembatch-done-Aufruf archivieren; niemals auf Teilstringsuche zurückfallen, wenn die Zeile bekannt ist. - Vertrauliche Kontexte (
"confidential": true) erhalten nur Ticket-IDs und kurze allgemeine Zusammenfassungen, sowohl im Aufgabenverfolger als auch in Übergaben.manage_tasks.pylehnt IPs, URLs und dieforbidden_patternsdes Kontexts ab. - Niemals Stränge ohne explizite Bestätigung starten.
- Tracker‑Befehle laufen sequentiell – Google Sheets erlaubt etwa 60 Lesevorgänge/Minute und jeder Befehl liest jeden Tab.
Abhängigkeiten
uv (brew install uv, oder curl -LsSf https://astral.sh/uv/install.sh | sh). git für den Commit‑Scan der Zusammenfassung. Google Sheets‑Backend nur: ein Dienstkonto‑JSON‑Schlüssel mit Editorzugriff auf das Blatt. Die Sitzungszusammenfassung liest Claude Code‑Transkripte (~/.claude*/projects); bei anderen Agenten werden nur Git‑Aktivität und Übergaben gemeldet.