# Coordinate Beads and bv Workflows

Teams lose time when dependent work is tracked across scattered notes and stale task lists. This skill guides Claude, Codex, and Claude Code through Beads and bv commands for ready work, graph planning, and session closeout.

## Install

```bash
npx skillstore add agentworkforce/using-beads-bv
```

## Metadata

- - Status: approved
- - Slug: agentworkforce-using-beads-bv
- - Version: 1.0.0
- - Author: AgentWorkforce
- - GitHub username: AgentWorkforce
- - License: MIT
- - Repository: https://github.com/AgentWorkforce/relay/tree/main/.claude/skills/using-beads-bv
- - Ref: main
- - Supported tools: Claude, Codex, Claude Code
- - Risk level: medium
- - Risk factors: external\_commands, network
- - Quality score: 73
- - Public page: https://skillstore.pages.dev/skills/agentworkforce-using-beads-bv
- - Manifest: https://skillstore.pages.dev/api/skills/agentworkforce-using-beads-bv/manifest

## Capabilities

- Explains when to use Beads instead of a simple session task list.
- Lists bd commands for ready work, task details, updates, creation, and closure.
- Shows bv robot-mode commands for graph insights, plans, priorities, recipes, and diffs.
- Defines priority levels from P0 through P4 with intended usage.
- Documents conventions for issue identifiers in commits and messages.
- Provides a session close protocol for syncing tasks and repository changes.

## Use Cases

- Select Ready Engineering Work: Find open work with no blockers, inspect dependencies, and claim the next issue in a Beads queue.
- Plan Parallel Agent Execution: Use bv robot outputs to understand graph metrics, parallel tracks, and items that unblock other work.
- Close a Coordinated Session: Sync Beads state, include task identifiers in commits, and prepare local work for remote publication.

## Prompt Templates

### Find Ready Work

```
Use the Beads workflow to find ready work, show the most relevant issue, and explain why it is unblocked.
```

### Claim a Task

```
Review the selected Beads issue, summarize its dependencies, and update it to in progress if it is ready.
```

### Plan Parallel Tracks

```
Use bv robot planning to identify parallel tracks, priority recommendations, and the work that unblocks the most issues.
```

### Prepare Session Closeout

```
Follow the Beads close protocol, list pending sync or git actions, and highlight anything that needs review before pushing.
```

## Limitations

- Requires bd and bv to be installed and configured outside the skill.
- Does not validate command output or enforce repository permissions.
- Does not provide a full Beads tutorial or troubleshooting guide.
- Includes git push guidance that should be reviewed before use.

## Best Practices

- Run bv with robot flags so agents receive deterministic, noninteractive output.
- Use Beads issue identifiers in commit messages and coordination notes.
- Review git staging, commits, and pushes before publishing repository changes.

## Anti Patterns

- Using bv without robot flags in an automated assistant session.
- Tracking coordinated work only in Markdown while Beads is the source of truth.
- Using high, medium, or low labels instead of P0 through P4 priorities.

## Security Audit

- - Safe to publish: true
- - Audited at: 2026-06-28T06:05:42.515\+00:00
- - Summary: Static analysis flagged many shell-command patterns and several weak-crypto patterns. The weak-crypto detections are false positives, and the network finding is only a project link, but the skill does instruct agents to run bd, bv, and git commands that can alter local and remote state. No prompt injection, credential access, obfuscation, or data exfiltration intent was found in SKILL.md.

## Stats

- - Views: 297
- - Downloads: 8
- - Favorites: 0
- - Popularity score: 0