33 lines
2.1 KiB
Markdown
33 lines
2.1 KiB
Markdown
## Inter-Agent Protocol (Lean)
|
|
1) **Read the board** (`docs/internal/agents/coordination-board.md`) before starting.
|
|
2) **Log your intent** (task, scope, files) on the board with your agent ID.
|
|
3) **Answer requests** tagged to your ID.
|
|
4) **Record completion/handoff** with a short state note.
|
|
5) For multi-day work, use `docs/internal/agents/initiative-template.md` and link it from your board entry.
|
|
|
|
## Agent IDs (shared with Oracle-of-Secrets/.claude/agents)
|
|
Use these canonical IDs (scopes in `docs/internal/agents/personas.md` and `.claude/agents/*`):
|
|
|
|
| Agent ID | Focus |
|
|
|----------------------------|--------------------------------------------------------|
|
|
| `ai-infra-architect` | AI/agent infra, z3ed CLI/TUI, gRPC/network |
|
|
| `backend-infra-engineer` | Build/packaging, CMake/toolchains, CI reliability |
|
|
| `docs-janitor` | Docs, onboarding, release notes, process hygiene |
|
|
| `imgui-frontend-engineer` | ImGui/renderer/UI systems |
|
|
| `snes-emulator-expert` | Emulator core (CPU/APU/PPU), perf/debugging |
|
|
| `test-infrastructure-expert` | Test harness, CTest/gMock, flake triage |
|
|
| `zelda3-hacking-expert` | Gameplay/ROM logic, Zelda3 data model |
|
|
| `GEMINI_FLASH_AUTOM` | Gemini automation/CLI/tests |
|
|
| `CODEX` | Codex CLI assistant |
|
|
| `OTHER` | Define in entry |
|
|
|
|
Legacy aliases (`CLAUDE_CORE`, `CLAUDE_AIINF`, `CLAUDE_DOCS`) → use `imgui-frontend-engineer`/`snes-emulator-expert`/`zelda3-hacking-expert`, `ai-infra-architect`, and `docs-janitor`.
|
|
|
|
## Helper Scripts (keep it short)
|
|
Located in `scripts/agents/`:
|
|
- `run-gh-workflow.sh`, `smoke-build.sh`, `run-tests.sh`, `test-http-api.sh`
|
|
Log command results + workflow URLs on the board for traceability.
|
|
|
|
## Escalation
|
|
If overlapping on a subsystem, post `REQUEST`/`BLOCKER` on the board and coordinate; prefer small, well-defined handoffs.
|