bd-workflow

Manage issue tracking with dependency-aware beads and JSON export.

2|Updated Nov 11, 2025
One-click install
npx skills add https://github.com/lambdamechanic/sk --skill bd-workflow
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bd-workflow
Source: https://github.com/lambdamechanic/sk/tree/main/skills/bd
Command: npx skills add https://github.com/lambdamechanic/sk --skill bd-workflow

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill streamlines task management by providing a Git-native, dependency-aware issue tracking system (bd - beads). It eliminates fragmented task lists, ensures all work is tracked, and optimizes for AI agent interaction, making project coordination effortless.

Core Features & Use Cases

  • Dependency-Aware Tracking: Manages tasks with explicit blockers, dependents, and "discovered-from" links, providing a clear project graph.
  • Git-Native History: Automatically syncs task history to .beads/issues.jsonl, ensuring task data is version-controlled alongside code.
  • Agent-Optimized Interface: Offers machine-readable JSON output and "ready" filtering, allowing AI agents to efficiently discover, claim, and update tasks.
  • Use Case: An AI agent needs to find the next available task in a project, claim it, and update its status as work progresses. This skill provides the exact commands to interact with the bd system, ensuring seamless integration into automated workflows.

Quick Start

Find the next unblocked task using bd, claim it as 'in_progress', and add a note 'Starting work on feature X'.

Frequently Asked Questions about bd-workflow

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I track issues and dependencies in a Git repository?

Issue tracking in Git repositories uses dependency-aware task management to link blockers, dependents, and discovered-from relationships. The `bd` system stores task history in `.beads/issues.jsonl`, keeping all task data version-controlled alongside code for complete project visibility.

Can I automate task status updates across my software project?

Automated task updates work through machine-readable JSON output and status filtering in `bd`. Agents can discover unblocked tasks, claim them as 'in_progress', add notes, and sync changes automatically to `.beads/issues.jsonl` with a 5-second debounce, ensuring all updates are Git-tracked.

What's the best way to manage workflow automation for AI agents?

Workflow automation for agents uses a Git-native task system optimized for machine interaction. The `bd` system provides 'ready' filtering to identify available work, JSON export for programmatic access, and mandatory Git push integration, enabling seamless agent-driven project coordination.

How do I resolve task tracking conflicts in collaborative Git workflows?

Merge-friendly conflict resolution in `bd` prevents fragmented task lists when multiple contributors work on the same project. Task state, blockers, and discovered-from links are tracked with automatic syncing, ensuring consistent task graphs across collaborators without manual reconciliation.

Do I need version control integration for issue tracking?

Git-native issue tracking eliminates the need for separate task management systems. The `bd` system integrates directly with Git repositories, auto-syncing task data to `.beads/issues.jsonl` and requiring Git push for all updates, keeping task history auditable and versioned with code changes.

Can I export task data for external workflow systems?

Task data export from `bd` uses JSON format with optional MCP integration for downstream workflow systems. The `--json` flag outputs machine-readable task information including dependencies and status, enabling integration with external automation platforms and reporting tools.