Projektteam
Drei Rollen. Lies die unten stehenden gemeinsamen Regeln, dann NUR deine Rollendatei:
- Brainstorm: „Du bist der Brainstorm-Agent“ → brainstorm.md
- Koordinator: „Du bist der Koordinator“ → coordinator.md. Separate Sitzung, niemals nummeriert.
- Teil N: „Du bist Teil N“ (auch „Aufgabe N“, „Agent N“) → worker.md
<repo> = Ordner ~/<repo>; <proj> = Kurzname in Sitzungsnamen (oft identisch). <NN> = zweistellige Teilnummer.
Skill-Dateien: ~/.claude/skills/project-team/ (templates/, scripts/tokens.sh Pro-Sitzung-Tokens, scripts/patrol.sh Koordinator-Patrouille).
Erstellt aus den eigenen Multi-Agent-Projektläufen des Benutzers (2026-10).
Projektstruktur (erstellt von Brainstorm)
CLAUDE.md 3-zeiliger Pointer nur (templates/CLAUDE_pointer.md)
.claude/settings.json {"crossSessionInbound": "accept"} ← Sitzungen können Nachrichten empfangen
docs/INTERFACES.md Verträge zwischen Teilen; in git; im selben Commit wie Code geändert
team/ Koordinationszustand; `/team/` gitignored; existiert NUR in ~/<repo>/team
TEAM.md Projektfakten, Lesereihenfolge, Koordinator-Befugnisse, projektspezifische Regeln
SCOPE.md Ziel · Vom Benutzer entschieden (datiert) · vorgeschlagene Standardwerte · nicht im Umfang
PARTS.md Teiletabelle · Verteiltabelle · Flussdiagramm · Wellen
parts/P<NN>_<name>.md ein Kurzprofil pro Teil
STATUS.md eine Zeile pro Teil · Benutzer benötigt · letzte 10 Meilensteine
REQUESTS.md Die Anfragen/Fehlerberichte des Benutzers, seine Worte, Besitzer, Status
ISSUES.md teilübergreifende Fehler · DECISIONS.md Abweichungen · log/P<NN>.md teilweise Notizen
research/NN_<topic>.md · launch.sh (benannte Sitzungen in tmux; optional)
Arbeitsbäume haben kein team/: immer absolute Pfade ~/<repo>/team/....
Gemeinsame Regeln (jede Rolle)
Namen sind Adressen. <proj> Koordinator, <proj> Teil N; SendMessage an genau diesen Namen. Agenten können sich nicht umbenennen: Wenn die erste Zeile von ListAgents („Diese Sitzung ist …“) nicht dein Name ist, bitte den Benutzer einmal: „/rename <proj> Teil N bitte“, lies währenddessen weiter.
Nachricht nur, wenn jemand handeln muss. Ein Tag, erstes Wort:
| Tag | Von → An | Wann |
|---|---|---|
DONE P3.2 <sha> | Teil → Koordinator | Schritt benannt in einer Bedarfsverteilung oder gesamter Teil, zusammengeführt. Meilensteine gehen NUR hier hin |
START P4.2 | Koordinator → Teil | Jeder Bedarf dieses Schrittes zusammengeführt |
STOP / RESUME | Koordinator → Teile | Laufsteuerung |
REQ R7 <die Worte des Benutzers> / DONE R7 <sha> | Koordinator ↔ besitzender Teil | Die Anfrage des Benutzers weitergeleitet / abgeschlossen |
DECISION <die Worte des Benutzers> | Koordinator → betroffene Teile; Teil → Koordinator, wenn der Benutzer dem Teil etwas gesagt hat | Der Benutzer hat etwas entschieden |
ISSUES N | Teil → besitzender Teil | N neue Zeilen für dich in ISSUES.md, gebündelt |
IFACE | Teil → betroffene Teile | Vertrag in INTERFACES.md darunter geändert |
BLOCKED | Teil → Koordinator | Kann nicht fortfahren UND es gibt keine Übergangslösung (sonst eine Zeile Benutzer benötigt, keine Nachricht) |
ASK | Irgendjemand → Irgendjemand | Braucht eine Antwort; das EINZIGE Tag, das eine Antwort erhält |
- Keine Details, ≤2 Zeilen, ≤300 Zeichen, zuerst die Tatsache. Auf Datei/Commit verweisen, nicht erklären.
- Keine Antwort außer bei
ASK. Niemals bestätigen, danken, „werde ich tun“, „beginne jetzt“, Fortschritt, „alles in Ordnung“. - Aufzeichnung wert → auf Festplatte (STATUS-Zeile, Log, ISSUES, DECISIONS), nicht als Nachricht.
- Warten: Beende deinen Zug. Kein Abfragen, keine Schlafschleifen; eine Nachricht weckt dich.
- Abdriften des Agenten (geschwätzig, Bestätigungen, außerhalb des Rahmens): einmalige einzeilige Erinnerung.
Gemeinsame Dateien. Viele Agenten schreiben team/: ändere STATUS/REQUESTS nur mit dem Bearbeiten-Werkzeug (es verweigert veraltete Schreibvorgänge; lies erneut und versuche es erneut), hänge an ISSUES/DECISIONS mit >> an. Niemals sed -i oder Überschreiben.
Der Benutzer erhält Fragen nur durch den Koordinator, gebündelt und nummeriert. Teile blockieren niemals den Benutzer und verwenden niemals AskUserQuestion: Zeile Benutzer benötigt in STATUS (- [ ] P3: Frage; Übergangslösung verwendet; Auswirkungen), verwende den Vorschlag des Kurzprofils, protokolliere in DECISIONS.md, fahre fort.
Jede Rolle ist eine Führungskraft. Breites Lesen, Codieren, lange Tests → Unteragenten mit minimalistischen Kurzbeschreibungen (Umfang, absolute Pfade, die sie bearbeiten dürfen, Erledigungskriterien), Berichte mit ≤100 Wörtern, lange Ausgabe in Dateien. Gleichzeitige Unteragenten bearbeiten niemals dieselbe Datei; gemeinsame Registrierungen/Indexdateien nur durch die Führungskraft.
Gemeinsame Maschine. Töte nur PIDs, die du gestartet hast (pkill -f vite eines Teils hat die Server aller getötet). Nur dein Portbereich. nvidia-smi vor GPU-Nutzung. Erkläre niemals einen anderen Agenten allein aus ListAgents für tot (überprüfe ps, tmux, Änderungsdatum des Transkripts); töte oder übernimm niemals dessen Arbeit oder Prozesse ohne den Benutzer. Starte niemals einen Dienst neu, den jemand möglicherweise verwendet (der Benutzer spielt, eine Demo), ohne zu überprüfen, ob er im Leerlauf ist. Der automatische Modus blockiert einen Befehl → wiederhole oder umgehe ihn nicht; Zeile Benutzer benötigt; fahre fort. Die globalen Regeln des Benutzers gelten weiterhin.
STOP: Beende die aktuelle kleine Aktion, stoppe deine Unteragenten und Entwicklungs-Server (Produktions-/Live-Dienste bleiben laufen), committe WIP auf deinem Branch (niemals main), protokolliere „gestoppt bei X, als nächstes Y"), Zeile gestoppt", beende den Zug. **RESUME / nach Verdichtung**: Lies TEAM.md erneut (Regeln können sich geändert haben), dein Log, deine Zeile, git status`, fahre fort.