4.5 KiB
| title | description |
|---|---|
| Разработчикам – Agent Teams Docs | Входная страница для contributor docs, архитектуры, guardrails, debugging и MCP extension paths в Agent Teams. |
Разработчикам
Эта страница нужна, когда вы меняете Agent Teams, разбираете зависший запуск команды или расширяете runtime через MCP tools. Ссылки ведут в canonical repo docs, чтобы правила реализации не расходились между страницами.
С чего начать
| Нужно | Открыть |
|---|---|
| Обзор репозитория, scripts и setup из исходников | README.md |
| Рабочие правила для агентов и contributors | CLAUDE.md |
| Жёсткие implementation guardrails | AGENT_CRITICAL_GUARDRAILS.md |
| Структура medium и large features | Feature architecture standard |
| Debugging launch, bootstrap и teammate messaging | Agent team debugging runbook |
| Contribution process | Contributing guide |
| Приватность и модель данных | Privacy and local data |
| Релизы / Changelog | RELEASE.md — CHANGELOG.md |
Локальный development path
Для обычной разработки запускайте desktop Electron app:
pnpm install
pnpm dev
Browser/web path не заменяет desktop runtime. Desktop mode - поддерживаемый локальный путь, потому что в нём есть IPC, terminals, provider auth, team lifecycle handling, launch diagnostics и runtime bridges, которые используют реальные команды.
Architecture checkpoints
Перед изменением feature определите её границу:
| Область | Ожидаемое место |
|---|---|
| Medium или large product feature | src/features/<feature-name>/ |
| Electron main process orchestration | src/main/ |
| Preload-safe API surface | src/preload/ |
| Renderer UI и app state | src/renderer/ |
| Shared types и pure helpers | src/shared/ |
| Agent Teams board MCP server | mcp-server/ |
| Board data controller | agent-teams-controller/ |
Используйте src/features/recent-projects как reference slice для feature organization. Держите cross-process contracts явными и не делайте deep imports через feature boundaries.
Debugging path
Для launch hangs, OpenCode registered / bootstrap-unconfirmed states, missing teammate replies или suspicious task logs:
- Начните с debugging runbook.
- Проверьте самый новый artifact pack в
~/.claude/teams/<team>/launch-failure-artifacts/latest.json. - Откройте
manifest.jsonи посмотритеclassification, bootstrap breadcrumbs, launch diagnostics, member spawn statuses и redacted log tails. - Очищайте только team, run, pane или process, который точно принадлежит smoke test или failed launch.
MCP development path
Agent Teams использует встроенный MCP server agent-teams для board operations. User и project MCP servers добавляют внешние capabilities для runtimes. См. MCP integration для setup examples, структуры .mcp.json и tool registration guidance.