getedgehq/workplan

Work Plan Skill (Arbeitsplan-Fähigkeit)

Arbeitspläne sind timestamp-basierte Markdown-Dateien, die eine automatische Kontextkomprimierung überstehen. Sie sind Ihr externes Gedächtnis für mehrschrittige Aufgaben.

Dateikonvention

• Ort: Projektstamm, gitignoriert
• Name: WORKPLAN-YYYYMMDD-slug.md (z. B. WORKPLAN-20260228-auth-refactor.md)
• Eine Datei pro Aufgabe/Phase. Verwenden Sie keine alten Arbeitspläne erneut. Beginnen Sie für jedes neue Vorhaben frisch.

Aktionen

Erstellen (/workplan oder /workplan create)

1. Lesen Sie zuerst. Bevor Sie den Plan schreiben, lesen Sie alle relevanten Dateien, Issues, Kontext.

2. Stellen Sie sicher, dass .gitignore WORKPLAN-*.md enthält (fügen Sie es hinzu, falls es fehlt).

3. Wählen Sie einen Umfangsmodus, bevor Sie den Plan schreiben:

   • EXPANSION: „Was ist die 10-Sterne-Version?“ Träumen Sie groß, erweitern Sie den Umfang.
   • HOLD: „Machen Sie das bombensicher.“ Der Umfang ist richtig, maximieren Sie die Genauigkeit.
   • REDUCTION: „Was ist das Minimum, das Wert liefert?“ Schneiden Sie radikal.

   Standardeinstellungen: Neues Feature = EXPANSION, Bugfix / Launch-Vorbereitung = HOLD, zeitlich begrenzt = REDUCTION.

4. Erstellen Sie die Datei mit dieser Vorlage:

# Work Plan: [Titel]

Erstellt: YYYY-MM-DD HH:MM
Zuletzt aktualisiert: YYYY-MM-DD HH:MM
Status: IN PROGRESS
Modus: HOLD / EXPANSION / REDUCTION

## Kontext

[Warum diese Arbeit existiert. Das Problem. Die Ursache. Wichtige Einschränkungen. Links zu Issues/PRs.]

## Roadmap

- [ ] 1. Schrittbeschreibung
- [ ] 2. Schrittbeschreibung
- [ ] 3. Schrittbeschreibung

## Entscheidungen

[Protokollieren Sie Architektur- oder Ansatzentscheidungen mit Zeitstempeln]
- [HH:MM] X statt Y gewählt, weil Z

## Entdeckte Probleme

[Dinge, die während der Arbeit gefunden wurden und nicht im ursprünglichen Umfang waren]
- [HH:MM] ... gefunden während Arbeit an Schritt 2

## Verifikationslog

[Jeder abgeschlossene Punkt erhält einen Verifikationseintrag]
- [HH:MM] Schritt 1: VERIFIED – `npm test` ausgeführt, alle 42 Tests bestanden
- [HH:MM] Schritt 3: VERIFIED – Login-Flow manuell getestet, funktioniert mit OAuth und E-Mail

Aktualisieren (/workplan update)

1. Lesen Sie die aktive(n) WORKPLAN-*.md-Datei(en) im Projektstamm.
2. Aktualisieren Sie den Zeitstempel „Zuletzt aktualisiert“.
3. Haken Sie erledigte Punkte mit Verifikationszeitstempeln ab.
4. Fügen Sie neue Entdeckungen oder Entscheidungen hinzu.
5. Melden Sie dem Benutzer den aktuellen Status.

Schließen (/workplan close)

1. Lesen Sie den aktiven Arbeitsplan.
2. Verifizieren Sie, dass ALLE Punkte mit Verifikationszeitstempeln abgehakt sind.
3. Führen Sie eine abschließende Verifikation durch (Build, Tests, manuelle Checks).
4. Ändern Sie den Status auf DONE.
5. Fügen Sie eine abschließende Zusammenfassung hinzu:

## Abgeschlossen

Geschlossen: YYYY-MM-DD HH:MM
Alle N Punkte implementiert und verifiziert. Build läuft durch. Tests bestehen.

Fortsetzen (nach Komprimierung)

Wenn der Kontext komprimiert wurde oder Sie nicht sicher sind, wo Sie aufgehört haben:

1. Suchen Sie nach aktiven Arbeitsplänen: Suchen Sie nach WORKPLAN-*.md im Projektstamm.
2. Lesen Sie die Arbeitsplandatei.
3. Identifizieren Sie den ersten nicht abgehakten Punkt.
4. Fahren Sie dort fort.

Regeln

1. VERIFIED bedeutet getestet. Nicht „Ich glaube, es funktioniert.“ Führen Sie es aus, sehen Sie, dass es bestanden wird, dann markieren Sie es als verifiziert. Geben Sie an, was Sie ausgeführt haben und welches Ergebnis.
2. Aktualisieren Sie Zeitstempel bei jeder Änderung. Das zukünftige Ich (nach Komprimierung) ist darauf angewiesen.
3. Neue Entdeckungen sofort eintragen. Behalten Sie sie nicht nur im Kontext.
4. Löschen Sie den Plan niemals, bis der Benutzer bestätigt, dass die Arbeit erledigt ist.
5. Ein Anliegen pro Checklistenpunkt. Teilen Sie große Schritte in kleinere verifizierbare Teile auf.
6. Wenn ein Schritt die Verifikation nicht besteht, protokollieren Sie den Fehler, lassen Sie ihn unabgehakt, fügen Sie hinzu, was schief gelaufen ist.