* feat(docs): version Docusaurus site and align llms-full with snapshots Add docs version 1.0.0, version dropdown, lastVersion defaulting to stable, merged markdown config, and RELEASING steps for future doc snapshots. generate-llms-full.sh reads the latest entry in versions.json. README links the published documentation site. Closes #2644 Made-with: Cursor * fix(docs): update org URLs to gastownhall and refresh 1.0.0 snapshot - Update default orgName in docusaurus.config.ts from steveyegge to gastownhall to match the repo's new home - Update hardcoded steveyegge URLs in generate-llms-full.sh - Refresh versioned_docs 1.0.0 snapshot to include quickstart changes from #3032 which merged after the original snapshot was taken - Regenerate llms-full.txt with corrected URLs and updated content Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> --------- Co-authored-by: matt wilkie <maphew@gmail.com> Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1.7 KiB
1.7 KiB
| id | title | sidebar_position |
|---|---|---|
| index | Multi-Agent | 1 |
Multi-Agent Coordination
Beads supports coordination between multiple AI agents and repositories.
Overview
Multi-agent features enable:
- Routing - Automatic issue routing to correct repositories
- Cross-repo dependencies - Dependencies across repository boundaries
- Agent coordination - Work assignment and handoff between agents
Key Concepts
Routes
Routes define which repository handles which issues:
{"pattern": "frontend/*", "target": "frontend-repo"}
{"pattern": "backend/*", "target": "backend-repo"}
{"pattern": "*", "target": "main-repo"}
Work Assignment
Pin work to specific agents:
bd pin bd-42 --for agent-1 --start
bd hook --agent agent-1 # Show pinned work
Cross-repo Dependencies
Track dependencies across repositories:
bd dep add bd-42 external:other-repo/bd-100
Architecture
┌─────────────────┐
│ Main Repo │
│ (coordinator) │
└────────┬────────┘
│ routes
┌────┴────┐
│ │
┌───▼───┐ ┌───▼───┐
│Frontend│ │Backend│
│ Repo │ │ Repo │
└────────┘ └────────┘
Getting Started
- Single repo: Standard beads workflow
- Multi-repo: Configure routes and cross-repo deps
- Multi-agent: Add work assignment and handoff
Navigation
- Routing - Auto-routing configuration
- Coordination - Agent coordination patterns