agent-briefs

Agenten-Briefings

Ein Subagent startet mit leerem Speicher. Er weiß nur das, was du schreibst. Bevor du einen Subagenten, einen Workflow oder eine lange Aufgabe startest, schreibe eine Aufgabenbeschreibung mit templates/brief.md (im Ordner dieses Skills).

Schritte

1. Große Aufgabe mit mehreren Teilen: Führe zuerst einen Planungsagenten mit templates/planner.md aus. Er gibt 5 bis 8 Phasen zurück, jede mit einem messbaren done_when. Jede Phase erhält dann ihre eigene Aufgabenbeschreibung.
2. Qualitätsarbeit (Musik, Sound, Bilder, Schreibstil): Folge zuerst templates/reference.md. Sammle 2 bis 3 Referenzen, messe sie, schreibe die Lücke auf, erstelle einen Prototyp eines Teils und lasse den Besitzer ihn bewerten, bevor der Rest erledigt wird.
3. Schreibe die Aufgabenbeschreibung mit jeder Überschrift von templates/brief.md. Schreibe "none" unter eine Überschrift, die nicht zutrifft. Füge templates/test-policy.md in jede Aufgabenbeschreibung ein, die etwas baut oder ändert.
4. Nach einem Bauschritt überprüfe mit 2 oder 3 Kritikern aus templates/critic.md, parallel, auf demselben aufgezeichneten Material. Gib die zusammengeführte must_fix-Liste an einen einzelnen Reparaturagenten.
5. Starte einen Watchdog neben jedem Agenten, der länger als etwa 15 Minuten läuft (siehe unten).
6. Sage dem Benutzer, was du gestartet hast, das Budget und eine ehrliche Schätzung. Sage, was unsicher ist.

Regeln für jede Aufgabenbeschreibung

• Zuerst lesen: Zeige auf Dateien und Abschnitte, anstatt langen Kontext einzufügen.
• Zitiere die Worte des Besitzers (ggf. übersetzt), damit der Agent sieht, was wirklich gefragt wurde.
• Wenn der Besitzer abwesend ist, sage es: "Der Besitzer kann nicht antworten. Entscheide selbst und dokumentiere jede Entscheidung."
• Erledigungskriterien müssen durch ein Skript, einen Test oder eine Messung überprüfbar sein. Verwende Zahlen und Bereiche.
• Ein Agent kann nicht sehen oder hören wie ein Mensch. Lass ihn messen (Screenshots, Bildanzahlen, Lautstärke, Spitzenwerte), im Bericht sagen, was niemand angesehen oder angehört hat, und den Geschmack dem Besitzer überlassen.
• Jede Aufgabenbeschreibung hat ein Zeitbudget, ein Testbudget und eine Stoppregel: "Wenn die Zeit aufgebraucht ist, höre auf, schreibe auf, was übrig ist, und kehre zurück." Lange Aufgaben erhalten auch einen Kontrollpunkt ("Nach 2 h, wenn X nicht gestartet ist, falle auf Y zurück").
• Schreibe niemals "führe alle früheren Tests erneut aus" oder "halte alles am Laufen" ohne Grenzen. Teste den neuen Teil an seiner Stelle; führe einen alten Test nur erneut aus, wenn du das geändert hast, was er abdeckt.
• Liste Prioritäten für den Fall, dass die Zeit ausgeht, die wichtigste zuerst, und sage, was mit dem Rest passiert.
• Ergebnisse behalten die Namen, Formate und Längen dessen bei, was sie ersetzen, damit der nächste Schritt sie austauschen kann.
• Eine Fortschrittsdatei erhält einen Zeitstempel pro erledigtem Stück, damit die Arbeit einen Abbruch übersteht.
• Harte Regeln geben den Grund an ("Speichere X niemals: Speichern würde seine Referenzen löschen").
• Trage frühere Fehler als Regeln weiter ("ein früheres Clip war schwarz: Verwende Main profile und yuv420p").
• Zeitbegrenze riskante Nebenquests: "Gib höchstens 15 Minuten dafür aus, dann falle auf Y zurück."
• Parallele Agenten erhalten Begrenzungen: "Schritt 3 ist NICHT deine Aufgabe: berühre A oder B nicht."
• Frage nach einem festen Rückgabeformat: was erledigt wurde, was übersprungen wurde und warum, Messungen, Testzeit, genutzte Zeit, eine Schätzung für den Rest, Dateipfade.

Watchdog

Parallel zu jedem langeren Agenten starte einen Hintergrundbefehl der auf das Zeitbudget wartet und dann eine Zeile ausgibt:

sleep 5400; echo "BUDGET überschritten: Phase 3 (90 min)"

Starte ihn im Hintergrund (Claude Code benachrichtigt dich, wenn er endet). Wenn er auslöst: Lies die Fortschrittsdatei des Agenten, dann sage dem Agenten entweder, er soll abschließen und zurückkehren, oder stoppe ihn, oder verlängere das Budget einmal und sage es dem Benutzer. Wenn der Agent früh zurückkehrt, stoppe den Watchdog.