viktor/beadboard
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
beadboard/skills/beadboard-driver/references/command-matrix.md
zenchantlive 1ae7efb31b feat(skills): formalize agent coordination via beadboard-driver 
We moved from ad-hoc task claims to a strictly defined 'Skill' system.

Triumphs:
- Implemented the 'beadboard-driver' skill, which encodes our project-specific coordination protocols (claim, reservation, handoff).
- This ensures that any AI operative (or human supervisor) can participate in the project lifecycle using a unified CLI-driven state machine.
- Decoupled high-level mission logic from low-level file mutations, allowing for easier agent skill composition in the future.

Raw Honest Moment:
Initially, we were just 'winging it' with manual status updates. Formalizing this into a skill was a necessary step to ensure our collaboration is repeatable and resilient to agent context swaps.
2026-02-14 00:23:41 -08:00

1.4 KiB
Raw Blame History

Command Matrix

Preflight and Identity

  • node skills/beadboard-driver/scripts/resolve-bb.mjs
    • Output: { ok, source, resolved_path, reason, remediation }
  • node skills/beadboard-driver/scripts/session-preflight.mjs
    • Output: { ok, tools.bd, bb } or { ok:false, error_code }
  • node skills/beadboard-driver/scripts/generate-agent-name.mjs
    • Output: { ok, agent_name, attempts, collisions } or { ok:false, error_code }
  • node skills/beadboard-driver/scripts/readiness-report.mjs --checks <json> --artifacts <json>
    • Output: { ok, checks, artifacts, dependency_sanity, summary }

Coordination Commands (bb)

  • bb agent register --name <agent> --role <role>
  • bb agent list
  • bb agent show --agent <agent>
  • bb agent send --from <agent> --to <agent> --bead <id> --category <HANDOFF|BLOCKED|DECISION|INFO> --subject <text> --body <text>
  • bb agent inbox --agent <agent> [--state unread|read|acked]
  • bb agent read --agent <agent> --message <message-id>
  • bb agent ack --agent <agent> --message <message-id>
  • bb agent reserve --agent <agent> --scope <path> --bead <id> [--ttl <minutes>] [--takeover-stale]
  • bb agent release --agent <agent> --scope <path>
  • bb agent status [--bead <id>] [--agent <agent>]

Lifecycle Commands (bd)

  • bd ready
  • bd show <bead-id>
  • bd update <bead-id> --status in_progress --claim
  • bd update <bead-id> --notes "<evidence>"
  • bd close <bead-id> --reason "<summary>"