beads-workflow

# Beads Workflow for SDLC

Beads is a git-native issue tracker that stores work items as files. This skill teaches how to use Beads effectively for autonomous SDLC workflows.

## Core Commands

### Finding Work

```bash
bd ready                         # Show tasks with no blockers (ready to implement)
bd list --status=open           # All open tasks
bd list --status=in_progress    # Active work
bd show <bead-id>               # Full task details with dependencies
bd blocked                      # Show all blocked tasks
```

### Creating Work

```bash
# Create a task (priority: 0=critical, 1=high, 2=medium, 3=low, 4=backlog)
bd create --title="Implement feature X" --type=task --priority=1

# Create with full details
bd create --title="Add JWT authentication" --type=feature --priority=1

# Types: task, feature, bug, epic, chore
```

### Managing Dependencies

```bash
# Add dependency: first arg DEPENDS ON second arg
bd dep add <task-that-needs> <task-it-needs>

# Example: tests depend on feature implementation
bd create --title="Implement auth" --type=feature  # → beads-001
bd create --title="Write auth tests" --type=task   # → beads-002
bd dep add beads-002 beads-001  # tests depend on auth

# Remove dependency
bd dep remove <task> <dependency>
```

### Completing Work

```bash
bd close <bead-id>                    # Mark complete (unblocks dependents)
bd close <id1> <id2> <id3>           # Close multiple at once
bd close <bead-id> --reason="Done"   # Close with reason
```

### Synchronization

```bash
bd sync              # Sync with git remote
bd sync --status     # Check sync status
bd stats             # Project statistics
bd doctor            # Check for issues
```

## SDLC Workflow Pattern

### 1. Architect Creates Feature Graph

The architect agent breaks down requirements into Beads with dependencies:

```bash
# Create features in dependency order
bd create --title="Database schema for users" --type=task --priority=1     # → beads-abc
bd create --title="User