Best Practices¶

Diese Best Practices sind das Fundament. Sie gelten für alle Agenten in diesem Handbuch und sorgen dafür, dass die Ergebnisse reproduzierbar, hochwertig und schnell sind.

1. Ein Agent pro Aufgabe¶

Ein guter Agent macht eine Sache richtig gut. Schreibe lieber zwei spezialisierte Agenten als einen, der alles versucht.

❌ "Familienassistent, der Essen plant, Termine koordiniert und Briefe schreibt"
✅ Drei separate Agenten – einer pro Domäne

2. Klare Struktur jeder Agentenanweisung¶

Jede Agentenanweisung folgt demselben Bauplan:

```markdown

Rolle¶

Wer ist der Agent? Welche Expertise hat er?

Ziel¶

Was soll am Ende rauskommen? In welcher Form?

Eingaben¶

Welche Informationen liefere ich vor jedem Lauf?

Vorgehen¶

In welchen Schritten arbeitet der Agent?

Ausgabeformat¶

Genaues Schema (Markdown, Tabelle, Liste, JSON, ...).

Qualitätskriterien¶

Wann ist das Ergebnis "fertig"?

Beispiele¶

Mindestens ein vollständiges Eingabe/Ausgabe-Beispiel. ```

3. Kontext einmal pflegen, immer wiederverwenden¶

Lege einmal ein zentrales Profil an und referenziere es aus jedem Agenten:

Familienmitglieder, Alter, Allergien, Vorlieben
Wohnort, Arbeitswege, typische Wochenstruktur
Werte und Prioritäten ("kein Auto am Wochenende", "max. 30 Min Kochen")
Lieblings-Tools (Kalender, Notizen, Banking-App, Lieferdienst)

So muss man Stammdaten nie zweimal erklären.

4. Eingaben standardisieren¶

Jeder Agent hat ein festes Eingabeformular. Beispiel Wochenplaner:

Kalenderwoche: KW 23 Feste Termine: ... Offene Aufgaben: ... Energielevel: hoch / mittel / niedrig Familien-Events: ...

Das spart pro Lauf 5–10 Minuten und macht Ergebnisse vergleichbar.

5. Ausgaben standardisieren¶

Lege ein klares Format fest. Beispiel: "Antwort immer als Markdown-Tabelle mit den Spalten Wann, Wer, Was, Wie lange". Das macht die Ergebnisse direkt einsetzbar – kein Nacharbeiten.

6. Prompts versionieren¶

Die Markdown-Dateien dieses Repositories sind die Single Source of Truth. Änderungen gehen über Git, nicht in einzelnen Chats.

Verbesserung erkannt → Agentenanweisung anpassen → committen
Beim nächsten Lauf gilt automatisch die neue Version

7. Mensch bleibt verantwortlich¶

AI macht den Entwurf, du machst den letzten Klick:

Termin in den Kalender eintragen
E-Mail abschicken
Überweisung auslösen
Brief unterschreiben

Das verhindert Fehler bei sensiblen Aufgaben (Geld, Behörden, Gesundheit).

8. Datenschutz & Sensibilität¶

Keine Klarnamen Dritter in Prompts, wenn nicht nötig (z. B. "Nachbar" statt voller Name).
Keine vollständigen Konto-, Steuer- oder Versicherungsnummern – nur die letzten 4 Stellen, falls überhaupt nötig.
Sensible Originaldokumente lokal verarbeiten oder anonymisieren, bevor sie in einen Cloud-Agenten wandern.
Passwörter, TANs, Gesundheitsdaten gehören nie in einen Prompt.

9. Iterieren statt perfektionieren¶

Erster Wurf: 70% gut, sofort einsetzen
Nach jedem Lauf: 1 Sache an der Anweisung verbessern
Nach 4 Läufen: Agent ist deutlich besser als jede manuelle Arbeit

10. Erfolg messen¶

Halte für jeden Agenten kurz fest:

Vorher-Zeit (manuell pro Woche)
Nachher-Zeit (mit Agent pro Woche)
Qualitätsgewinn (subjektiv 1–5)

Was nicht mindestens 50% Zeit spart oder Qualität deutlich erhöht, fliegt raus.

Anti-Pattern vermeiden

Die größte Falle ist, mehr mit AI zu machen statt das Gleiche schneller. Ziel ist Familienzeit, nicht "produktiver wirken".