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

2.2 KiB

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

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.