diff --git a/agent/AGENTS.md b/agent/AGENTS.md index b1f0769..7df0d0e 100644 --- a/agent/AGENTS.md +++ b/agent/AGENTS.md @@ -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 `, `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 3–4 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. ---