Skip to content

OthmanAdi/planning-with-files / skills/i18n/planning-with-files-de

planning-with-files-de

Verified

Persistente dateibasierte Planung für mehrstufige Arbeit mit KI-Agenten. Hält task_plan.md, findings.md und progress.md auf dem Datenträger; Lebenszyklus-Hooks speisen ausgewählten Planungskontext des Projekts ein. Die automatische Wiederherstellung liest nur die Planungsdateien des Projekts. Nur ein ausdrücklicher Aufruf von session-catchup.py --metadata darf lokale Sitzungsmetadaten desselben Projekts prüfen; --replay darf begrenzte, nonce-gerahmte Auszüge ausgeben. Der optionale Gate-Modus kann nur bei Unterstützung durch den Host eine Fortsetzung anfordern und führt niemals in Markdown angegebene Befehle aus. Der Skill hat keinen Netzwerk-Uploadpfad. Verwenden für Forschung oder Arbeit mit mehr als 5 Tool-Aufrufen.

scripts/init-session.sh

View on GitHub
#!/usr/bin/env bash
# Initialisiert Planungsdateien für eine neue Sitzung
# Verwendung: ./init-session.sh [Projektname]

set -e

PROJECT_NAME="${1:-projekt}"
DATE=$(date +%Y-%m-%d)

echo "Initialisiere Planungsdateien: $PROJECT_NAME"

# task_plan.md erstellen, wenn nicht vorhanden
if [ ! -f "task_plan.md" ]; then
    cat > task_plan.md << 'EOF'
# Aufgabenplan: [Kurze Beschreibung]

Nutzen Sie diese Datei als dauerhafte Roadmap und halten Sie sie bei jedem Phasenwechsel aktuell.

## Ziel
[Ein-Satz-Beschreibung des Endzustands]

## Nächster Schritt
[Die nächste einzelne Aktion. Bei jedem Phasenwechsel aktualisieren.]

## Aktuelle Phase
Phase 1

## Phasen

### Phase 1: Anforderungen & Entdeckung
- [ ] Benutzerabsicht verstehen
- [ ] Einschränkungen und Anforderungen klären
- [ ] Erkenntnisse in findings.md dokumentieren
- **Status:** in_progress

### Phase 2: Planung & Struktur
- [ ] Technischen Ansatz festlegen
- [ ] Projektstruktur bei Bedarf erstellen
- [ ] Entscheidungen mit Begründung dokumentieren
- **Status:** pending

### Phase 3: Implementierung
- [ ] Schrittweise gemäß Plan ausführen
- [ ] Code zuerst in Dateien schreiben, dann ausführen
- [ ] Inkrementell testen
- **Status:** pending

### Phase 4: Test & Validierung
- [ ] Alle Anforderungen geprüft
- [ ] Testergebnisse in progress.md dokumentieren
- [ ] Gefundene Probleme beheben
- **Status:** pending

### Phase 5: Auslieferung
- [ ] Alle Ausgabedateien geprüft
- [ ] Vollständigkeit der Lieferobjekte sicherstellen
- [ ] An Benutzer ausgeliefert
- **Status:** pending

## Schlüsselfragen
1. [Zu beantwortende Frage]
2. [Zu beantwortende Frage]

## Getroffene Entscheidungen
| Entscheidung | Begründung |
|------|------|

## Aufgetretene Fehler
| Fehler | Versuch | Lösung |
|------|---------|---------|

## Hinweise
- Aktualisieren Sie den Phasenstatus von `pending` zu `in_progress` und danach zu `complete`.
- Prüfen Sie Ziel und nächsten Schritt vor wichtigen Entscheidungen erneut.
- Protokollieren Sie Fehler zeitnah und ändern Sie den Ansatz vor einem erneuten Versuch.
EOF
    echo "task_plan.md erstellt"
else
    echo "task_plan.md existiert bereits, überspringe"
fi

# findings.md erstellen, wenn nicht vorhanden
if [ ! -f "findings.md" ]; then
    cat > findings.md << 'EOF'
# Erkenntnisse & Entscheidungen

## Anforderungen
-

## Forschungsergebnisse
-

## Technische Entscheidungen
| Entscheidung | Begründung |
|------|------|

## Aufgetretene Probleme
| Problem | Lösung |
|------|---------|

## Ressourcen
-
EOF
    echo "findings.md erstellt"
else
    echo "findings.md existiert bereits, überspringe"
fi

# progress.md erstellen, wenn nicht vorhanden
if [ ! -f "progress.md" ]; then
    cat > progress.md << EOF
# Fortschrittsprotokoll

## Sitzung: $DATE

### Aktueller Status
- **Phase:** 1 - Anforderungen & Entdeckung
- **Startzeit:** $DATE

### Ausgeführte Aktionen
-

### Testergebnisse
| Test | Erwartet | Tatsächlich | Status |
|------|---------|---------|------|

### Fehler
| Fehler | Lösung |
|------|---------|
EOF
    echo "progress.md erstellt"
else
    echo "progress.md existiert bereits, überspringe"
fi

echo ""
echo "Planungsdateien initialisiert!"
echo "Dateien: task_plan.md, findings.md, progress.md"
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall