---
name: plane-abgleich
description: Gleicht die Checkbox-Aufgaben aus todo.md der Vault-Code-Projekte mit den Work Items der Plane-Instanz ab — in beide Richtungen, mit Konflikterkennung. Nutze diesen Skill, wenn von Plane, Work Items, Issues, Aufgabenabgleich, „todo nach Plane" oder „was ist in Plane offen" die Rede ist.
---

# Plane-Abgleich

Gleicht `todo.md` und Plane in beide Richtungen ab.

## Voraussetzungen prüfen

Setze `PLANE_URL`, `PLANE_API_KEY` und `PLANE_WORKSPACE` voraus. Fehlen sie, meldet das
Skript das verständlich — gib die Meldung weiter und brich ab. Frage niemals nach dem
Schlüssel und schreibe ihn nirgends hin.

Arbeitsverzeichnis: `D:\Claude\Code Projekte\active - Plane Abgleich\skill\scripts`

## Ablauf

1. **Immer zuerst der Probelauf.** Ohne `--anwenden` schreibt nichts:

   ```
   python -m plane.cli
   ```

2. **Bericht lesen.** Je Aufgabe ANLEGEN, NACH PLANE, NACH VAULT, ANHAENGEN, ZEILE WEG,
   ITEM WEG oder KONFLIKT.

3. **Fehlende Zuordnung klären.** Meldet der Bericht für ein Projekt, dass `plane_project`
   fehlt:

   - Plane-Projekte zeigen: `python -m plane.cli --projekte`
   - Dem Anwender die Liste vorlegen und fragen, welches Projekt gemeint ist. Nicht raten.
   - Gibt es kein passendes, anlegen lassen — erst nach ausdrücklicher Zustimmung:
     `python -m plane.cli --projekt-anlegen "Name" --kennung KRZ --anwenden`
   - Die UUID ins Frontmatter der `todo.md` schreiben.

4. **Konflikte vorlegen.** Bei jedem KONFLIKT beide Fassungen zeigen und fragen, welche gilt.
   Nicht selbst entscheiden.

5. **Freigabe einholen und anwenden.** Erst nach ausdrücklichem „ja":

   ```
   python -m plane.cli --anwenden --konflikt PLA-42=vault
   ```

6. **Ergebnis melden.** Was angelegt, was in welche Richtung übertragen, was offen blieb.

## Grenzen

- `--anwenden` niemals ungefragt ausführen. Es verändert Plane für alle Beteiligten.
- Konflikte ohne Entscheidung bleiben liegen — das ist beabsichtigt, nicht umgehen.
- Es wird nie gelöscht: keine Zeile, kein Work Item, kein Projekt. Entfernte Zeilen und
  entfernte Work Items werden nur gemeldet.
- Projekte werden nur auf ausdrückliche Anforderung angelegt, nie nebenbei im Abgleich.