theplenkov/bro
Agent's sidekick: review-debt pipeline, PR review loop, scoped drill frames, and wtf→retrospect self-correction — all mechanics in the bro CLI over gh + beads
Use when the user invokes /act on an open PR or a 'bro: PR #N ...' status ping arrives — the review-fix loop. Thin wrapper over the bro CLI: bro act status is the exit gate as code; resolve/reply are mutations. Requires bro (npx -y @theplenkov/bro@0) and gh.
Use when the user invokes /convoy or asks to run a beads workflow — a molecule's DAG of steps executed inside the agent. Thin wrapper over the bro CLI: bro convoy next is the scheduler as code; bro convoy done advances it. Requires bro (npx -y @theplenkov/bro@0) and bd.
Use when the user invokes /debt or asks about review debt on merged PRs. Thin wrapper over the bro CLI — all mechanics live in bro debt * commands; this skill carries policy only. Requires bro (npx -y @theplenkov/bro@0) and gh.
Use when the user invokes /drill or /unwind, or when a task needs scoped descent — narrower investigation frames with mandatory result+prevention memos. Thin wrapper over the bro CLI: drill frames are beads; bd owns storage, bro drill owns the invariants. Requires bro (npx -y @theplenkov/bro@0) and bd.
Use when the user says 'work the backlog', 'clean the queue', invokes /next, or sets a /goal over open beads — the autonomous backlog loop. Thin wrapper over the bro CLI: bro next is the scheduler as code — it claims the top ready bead and emits the work order. Requires bro (npx -y @theplenkov/bro@0) and bd.
Use when the user invokes /sync or asks to publish/restore bro artifacts (review-debt ledger, evidence packs) across machines or agents. Thin wrapper over bro sync — mechanics live in the CLI.
Use when the user invokes /wtf or vents sharp frustration at the agent's own work. Thin wrapper over the bro CLI — bro wtf captures the complaint as a bead, bro retrospect record stores a TOML retro plan and fans prevention actions out to beads. Requires bro (npx -y @theplenkov/bro@0) and bd.