ki-praxis/templates/compaction-hints.md

Compaction-Hints (kopierbar)

Nutze diese Hints beim Compact (/compact <hint> oder äquivalent im jeweiligen Tool).
Ein guter Hint sagt, was behalten werden muss — nicht „fass dich kurz“.

Prinzip

• Behalten: Ziele, DoD, Entscheidungen, Dateipfade, Fehlerursachen, nächste Schritte, Verbote
• Verwerfen: lange Tool-Outputs, gescheiterte Irrwege (außer die Lehre daraus), redundante Datei-Dumps
• Ein Hint pro Compact — fokussiert, 1–2 Sätze plus optionale Bullet-Liste

---

1. Architektur & Entscheidungen behalten

/compact Wichtige Architektur-Entscheidungen, aktuelle TODOs, offene Tasks und begründete Verwürfe behalten; Tool-Logs und Datei-Dumps verwerfen

2. Feature-Implementierung (laufender Slice)

/compact Fokus auf aktuelle Feature-Implementierung: Ziel, DoD, geänderte Dateien, Teststatus und nächste Schritte der letzten Turns behalten

3. Debug / Incident

/compact Debug-Fokus: Reproduktionsschritte, Fehlermeldungen, bereits ausgeschlossene Ursachen und aktuelle Hypothese behalten; fehlgeschlagene Experiment-Details knapper fassen

4. Refactoring

/compact Refactoring-Kontext behalten: Invarianten, betroffene Module, Migrationsgrenzen, was bewusst nicht geändert wird, und Verify-Kommandos

5. Nach Plan-Freigabe (Execute-Phase)

/compact Genehmigten Plan und DoD behalten; Explore-Diskussion und Alternativen nur als Kurzentscheidungen; Execute-Fortschritt und Diff-relevante Dateien priorisieren

6. Vor Session-Ende / vor Handoff

/compact Session-Abschluss: Stand, Entscheidungen, offene Punkte und nächste konkrete Schritte behalten — geeignet zum Übertrag ins Handoff

7. Multi-Slice / langes Feature

/compact Gesamtziel und Slice-Status behalten; Details abgeschlossener Slices auf Ergebnis + relevante Dateien reduzieren; aktuellen Slice detailliert lassen

8. Review / PR-Vorbereitung

/compact Review-Fokus: Änderungsabsicht, Risikoflächen, Testabdeckung und offene Review-Punkte behalten; Implementierungs-Irrwege verwerfen

9. Tooling / Setup

/compact Setup-Kontext behalten: gewählte Tools, Config-Pfade, funktionierende Befehle und bekannte Stolpersteine; Installations-Logs verwerfen

10. Minimal (Notfall bei hohem Context)

/compact Nur Ziel, DoD, Branch, kritische Dateipfade und den nächsten Schritt behalten

---

Schlechte Hints (Avoid)

Avoid	Warum
kürzer	Kein Erhaltungskriterium — Modell rät, was wichtig ist
alles behalten	Konterkariert Compact
Zusammenfassen	Zu vage; oft gehen DoD und Dateipfade verloren
Sehr lange Essay-Hints	Selbst Context-Müll

Gute Ergänzung (optional, nach dem Hint)

Wenn das Tool Freitext erlaubt, hänge 3–5 harte Facts an:

Behalten zusätzlich:
- DoD: npm test && npm run lint exit 0
- Nicht anfassen: packages/legacy/**
- Nächster Schritt: POST /api/invoices absichern + Test