OthmanAdi/planning-with-files / skills/i18n/planning-with-files-de
planning-with-files-de
VerifiedPersistente 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"
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 472k | Updated | Claude CodeCodex | Verified | Install |
| 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: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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 available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |