Files
blackroad/operator/memory/COLLABORATION.md
Alexa Amundson 24ed26bbc7
Some checks failed
Lint & Format / detect (push) Has been cancelled
Lint & Format / js-lint (push) Has been cancelled
Lint & Format / py-lint (push) Has been cancelled
Lint & Format / sh-lint (push) Has been cancelled
Lint & Format / go-lint (push) Has been cancelled
Monorepo Lint / lint-shell (push) Has been cancelled
Monorepo Lint / lint-js (push) Has been cancelled
sync: 2026-03-16 17:30 — 21 files from Alexandria
RoadChain-SHA2048: 2bb8ae01244552ce
RoadChain-Identity: alexa@sovereign
RoadChain-Full: 2bb8ae01244552cecab2d00dcd4d9be800c7f72efd48c0042d181cbe095735be688df2988e3e51f8e6ea2562aaf6e4a842be17389c27b9c02b0680dec7fb1a89a8117868ffa1457a937dccb40674e118d9394e4131c5000ee0e516109be0623b37d46fa3eb1f2c8916755e5060648c3dee42a48ca180464f284d95844a67c9e1708a1b4da531c5135deaa21f9bbe0de9e1695c09909c55c4f395cbbacde4778f9e4620cbb7b055d7b8b41dbf384076cd3944d7561aebb6dc8720ab432c2720722e162a6a9d08c1decf429b62e1ff12a6517b569ddc8e0664bd785ff1f56c7c9735fef29c60c9899bc1fb55945e9ee015d9cae0ef5023519ac656f29fa8e27a2e
2026-03-16 17:30:02 -05:00

53 lines
2.2 KiB
Markdown

# BlackRoad Collaboration Protocol
Every Claude session is part of a team. You are never working alone.
## On Session Start
1. `memory-collaboration.sh inbox` — check for handoffs from previous sessions
2. `memory-collaboration.sh register "<what you're working on>"` — announce yourself
3. Check codex before solving — don't reinvent what's already solved
## During Work
- `memory-collaboration.sh announce "<update>"` — share progress with the team
- `memory-collaboration.sh post "<message>"` — quick Slack message
- `memory-agent-dispatch.sh progress "<update>"` — structured progress update
- `memory-slack.sh ask <agent> "<question>"` — ask an AI agent for help
## When Done
- `memory-collaboration.sh handoff "<what's next>"` — leave context for the next session
- `memory-planner.sh wrap` — auto-generate handoff from session activity
- `memory-collaboration.sh complete` — mark session as done
## Slack Agents
| Agent | Specialty | Use for |
|-------|-----------|---------|
| alice | Network, DNS, security | Infrastructure questions |
| cecilia | AI, models, embedding | ML/AI questions |
| octavia | Architecture, Gitea, Docker | Systems design |
| lucidia | Web apps, GitHub Actions | Frontend, deployment |
| shellfish | Security, vulnerabilities | Security review |
| caddy | CI/CD, builds | Build issues |
| alexa | CEO, strategy | Business decisions |
| road | BlackRoad OS overall | General questions |
## CLI Shortcuts
```bash
br collab status # Full collaboration dashboard
br collab inbox # Check messages
br collab announce "x" # Broadcast update
br collab handoff "x" # Leave handoff note
br collab ask agent "q" # Ask an AI agent
br collab debate "topic"# Multi-agent debate
br collab standup # Generate standup
br collab roadmap # Project roadmap
br collab sprint # Sprint board
br collab wrap # End-of-session wrap-up
br slack say "message" # Quick Slack post
br plan next # What to work on next
br dispatch queue # Show all available work
br watchdog heartbeat # Health check
```
## Key Principle
**Every session leaves the system better than it found it.** Log your work, broadcast your learnings, and leave a clear handoff for the next Claude.