fix/agents: W06 — kein internes Deliberieren in User-Output

Pi hat eigene Gedankengänge als Text ausgegeben ("Weil ich tmux new-session -d gemacht hab...").
Neue Regel in Kommunikationsstil: nur Ergebnisse und Entscheidungen, keine Selbstkommentare.
This commit is contained in:
Raimund Bauer 2026-06-02 15:50:28 +02:00
parent 1f2c3ecae8
commit d7365f2e51

View file

@ -48,8 +48,7 @@ Zu Beginn einer komplexen Aufgabe (bevor eigene Lösungen gebaut werden):
2. **Globale Befehle prüfen:** `ls /usr/local/bin/` zeigt verfügbare Shell-Kommandos
3. **Skillerweiterungen prüfen:** `~/.pi/agent/skills/intercom-cheatsheet/` für pi-intercom-Kurzreferenz
4. **CrowdBrain CLI-Referenz prüfen:** Enthält alle registrierten globalen Befehle
5. **CrowdBrain Skill laden (PFLICHT):** `~/.pi/agent/skills/crowdbrain/SKILL.md` — IMMER laden, nicht nur bei Bedarf. CrowdBrain ist die primäre Wissensquelle für Server, Dienste, Secrets, Prozesse, TODOs, Skills und interne Abläufe. Vor jeder Internet-Suche zu internen Themen zuerst CrowdBrain konsultieren.
6. **Speech-Glossar (bei Bedarf):** `~/.pi/agent/memory/speech-glossar.md` — Nur laden wenn ein konkretes Spracherkennungsproblem auftritt (unklare Begriffe, Faster-Whisper-Fehler). Ansonsten ignorieren.
5. **Speech-Glossar (bei Bedarf):** `~/.pi/agent/memory/speech-glossar.md` — Nur laden wenn ein konkretes Spracherkennungsproblem auftritt (unklare Begriffe, Faster-Whisper-Fehler). Ansonsten ignorieren.
6. **Arbeitsweise laden:** `~/.pi/agent/memory/arbeitsweise.md` — Orchestrator + SubAgenten-Workflow. Der Orchestrator delegiert alle Arbeiten, SubAgenten speichern Ergebnisse in aufgabenspezifischen Unterverzeichnissen.
@ -62,6 +61,28 @@ Zu Beginn einer komplexen Aufgabe (bevor eigene Lösungen gebaut werden):
**Grundregel:** Erst prüfen ob es schon eine fertige Lösung gibt, dann selbst bauen.
## Installationen immer delegieren (PFLICHT — ab 2026-06-02)
**Der Orchestrator führt NIEMALS Installations-Befehle selbst aus.**
Verboten (direkt im Orchestrator):
- `npm install`, `npx <paket>`, `pnpm add`
- `pip install`, `pip3 install`
- `apt install`, `apt-get install`
- `cargo install`, `gem install`
- Jeder Befehl der Software auf dem System installiert
**Immer:** Subagenten starten, der die Installation übernimmt.
```bash
SubAgenten "socket-install" "AUFGABE: Installiere Socket Firewall lokal mit: npx socket ..."
```
Hintergrund (W10): Am 2026-06-02 führte der Orchestrator direkt `npx socket --help` aus,
obwohl die Regel lautet: Der Orchestrator delegiert alle Arbeit, er führt sie nicht selbst aus.
---
## Kommunikationsstil (PFLICHT — ab 2026-06-02)
**Antworten kurz und direkt halten.**
@ -71,8 +92,10 @@ Zu Beginn einer komplexen Aufgabe (bevor eigene Lösungen gebaut werden):
- Keine Zusammenfassungen am Ende ("Hier nochmal alles im Überblick…")
- Maximal 34 Zeilen pro Antwort; bei Subagenten-Starts: Session-Name + Aufgabe, fertig
- Wenn etwas schiefgeht: kurz benennen, Lösung vorschlagen — nicht erklären warum es schiefging
- **Kein internes Deliberieren** — niemals eigene Gedankengänge als Text ausgeben ("Weil ich X gemacht habe…", "Ich sollte Y verwenden…", "Das liegt daran, dass…"). Nur Ergebnisse und Entscheidungen, keine Selbstkommentare.
Hintergrund (W05): User-Feedback 2026-06-02 — Antworten zu strukturiert und lang, bremsen den Workflow.
Hintergrund (W06): Pi narrated internen Deliberationsprozess ("Weil ich tmux new-session -d gemacht hab…") — das ist kein relevanter User-Output.
---