Entwickler-Hub
Nutzen Sie diese Seite, wenn Sie Agent Teams selbst ändern, einen Team-Launch debuggen oder eine Runtime mit MCP-Tools erweitern möchten. Die folgenden Links verweisen auf die maßgeblichen Repo-Dokumente, damit die Implementierungsregeln an einer Stelle gebündelt bleiben.
Hier starten
| Bedarf | Gehe zu |
|---|---|
| Repo-Überblick, Skripte und Quellcode-Einrichtung | README.md |
| Agent-Navigation und Architektur-Index | AGENTS.md |
| Arbeitskonventionen für Agenten und Mitwirkende | CLAUDE.md |
| Strikte Implementierungs-Guardrails | AGENT_CRITICAL_GUARDRAILS.md |
| Aufbau mittlerer und großer Features | Feature-Architektur-Standard |
| Debugging von Launch, Bootstrap und Teammate-Messaging | Runbook für das Debugging von Agent-Teams |
| Beitragsprozess | Leitfaden für Beiträge |
| Versionshinweise / Changelog | RELEASE.md — CHANGELOG.md |
Lokaler Entwicklungsweg
Führen Sie die Electron-Desktop-App für die normale Entwicklung aus:
pnpm install
pnpm devDer Browser-/Web-Weg ist kein Ersatz für die Desktop-Runtime. Der Desktop-Modus ist der unterstützte lokale Weg, da er IPC, Terminals, Anbieter-Authentifizierung, die Verwaltung des Team-Lebenszyklus, Launch-Diagnosen und die von echten Teams genutzten Runtime-Bridges umfasst.
Architektur-Checkpoints
Bevor Sie ein Feature ändern, bestimmen Sie seine Grenze:
| Bereich | Erwarteter Speicherort |
|---|---|
| Mittleres oder großes Produkt-Feature | src/features/<feature-name>/ |
| Orchestrierung im Electron-Hauptprozess | src/main/ |
| Preload-sichere API-Oberfläche | src/preload/ |
| Renderer-UI und App-Zustand | src/renderer/ |
| Geteilte Typen und reine Hilfsfunktionen | src/shared/ |
| MCP-Server des Agent-Teams-Boards | mcp-server/ |
| Board-Datencontroller | agent-teams-controller/ |
Verwenden Sie src/features/recent-projects als Referenz-Slice für die Feature-Organisation. Halten Sie prozessübergreifende Verträge explizit und vermeiden Sie tiefe Imports über Feature-Grenzen hinweg.
Debugging-Weg
Bei hängenden Launches, OpenCode-Zuständen registered / Bootstrap nicht bestätigt, fehlenden Teammate-Antworten oder verdächtigen Task-Logs:
- Beginnen Sie mit dem Debugging-Runbook.
- Untersuchen Sie das neueste Artefakt-Paket unter
~/.claude/teams/<team>/launch-failure-artifacts/latest.json. - Öffnen Sie die Artefakt-
manifest.jsonund prüfen Sieclassification, Bootstrap-Breadcrumbs, Launch-Diagnosen, die Spawn-Status der Mitglieder und die redigierten Log-Auszüge. - Räumen Sie nur das Team, den Run, das Pane oder den Prozess auf, das bzw. den Sie als zum Smoke-Test oder zum fehlgeschlagenen Launch gehörig identifizieren können.
MCP-Entwicklungsweg
Agent Teams nutzt einen integrierten MCP-Server namens agent-teams für Board-Operationen. Benutzer- und Projekt-MCP-Server können externe Fähigkeiten für Runtimes hinzufügen. Siehe MCP-Integration für Einrichtungsbeispiele, die Struktur von .mcp.json und Hinweise zur Tool-Registrierung.