ki-praxis/templates/task-prompt-template.md

Task-Prompt-Template

Outcome vor Micro-Management. Der Agent soll eine Lösung ausarbeiten, nicht nur Tasten drücken.

---

Kopiervorlage

## Ziel
[Ein klarer Outcome in 1–3 Sätzen. Was ist danach wahr?]

## Warum / Kontext (kurz)
[Nur was die Lösung beeinflusst — Business-Regel, Bug-Symptom, User-Flow.]

## Nebenbedingungen
- [Performance, Security, Kompatibilität, Style-Guide, API-Stabilität, …]
- [Technische Nebenbedingungen: bestehende Libs, keine neuen Dependencies ohne Grund, …]

## Ausschlüsse (Out of Scope)
- Fachlich: [was bewusst nicht geliefert wird]
- Pfade / Packages: [was nicht angefasst wird]
- Kein Drive-by außerhalb des Slices

## Definition of Done (vom Agent prüfbar)
- [ ] [Verhalten / Akzeptanzkriterium]
- [ ] [Automatisierter Check, z. B. `pnpm --filter … test` exit 0]
- [ ] [Lint/Typecheck falls im Repo Standard]
- [ ] [Kein unnötiger Diff außerhalb des Slices]

## Erlaubte Aktionen
- Lesen/Suchen im Repo: ja
- Tests ausführen: ja
- Commit: [nein | nur auf Feature-Branch nach Verify | ja mit Message-Schema]
- Push / PR: [nein | nach Freigabe]

## Ausgangspunkte (Kontextquellen)
- Relevante Dateien/Ordner: `…`
- Docs/Tickets: `…`
- Handoff/Progress falls vorhanden: `…`

## Arbeitsweise
- Explore → Plan bei Mehrdeutigkeit/größerem Scope (Plan-Mode / Ask-Mode / Plan-Turn) → Execute in vertikalen Slices → Verify gegen DoD
- Bei Unklarheit: Annahmen explizit oder eine gezielte Rückfrage
- Keine spekulativen Refactors; Surgical Changes

## Alignment (Pflicht bei multi-file / Public API / Security, sonst optional)
- Bestehendes Pattern: [Modul/Beispielpfad]
- Teach-back vor Write: Ziel, Ausschlüsse, Invarianten, DoD;
  bei Mismatch: stoppen, nicht patchen
- Unsicher bei: […] → kurz nachfragen; sonst Annahmen explizit listen
- Optional 5-Bullet-Plan zur Freigabe (Plan-Mode / Ask-Mode / Plan-Turn).
  Skip bei 1-Datei-Fix mit klarer Repro.
  Nach Freigabe nur der freigegebene Scope; Freigabe ersetzt kein Orakel.

---

Mini-Variante (für kleine Tasks)

Ziel: …
Scope: …
Nebenbedingungen: …
Out of scope: …
DoD: [ ] …  [ ] Tests: `…` exit 0
Nicht anfassen: …

---

Qualitätscheck vor dem Absenden

• DoD ist ohne Menschenmeinung prüfbar
• Alignment-Gate vor multi-file Write — ersetzt keine DoD
• Nicht zu restriktiv (kein Schritt-für-Schritt-Rezept, außer bei Compliance)
• Nicht zu vage (Outcome + Grenzen klar)
• Ein vertikaler Slice — nicht „das ganze Epic“
• Stack/Konventionen des Repos respektiert