Beads Workflow Optimizer

Files (14)

• SKILL.md
• ADVANCED.md · docs/
• API_REFERENCE.md · docs/
• README.md · resources/examples/basic-workflow/
• README.md · resources/examples/complex-dependencies/
• README.md · resources/examples/parallel-execution/
• config.schema.json · resources/schemas/
• issue.schema.json · resources/schemas/
• issue-template.md · resources/templates/
• workflow-config.json · resources/templates/
• analyze.py · scripts/
• optimize.py · scripts/
• parallel.py · scripts/
• sync.py · scripts/

SKILL.md (first lines)

# Beads Workflow Optimizer

## Overview

The Beads Workflow Optimizer skill provides intelligent automation for Beads task management, including workflow activation, parallel processing optimization, and dependency resolution. This skill helps Claude identify optimal task sequences, activate workflows based on dependencies, and maximize parallel execution efficiency.

## Prerequisites

- Beads workflow system initialized in the project (`bd init` completed)
- Active git repository with Beads integration
- Understanding of task dependencies and blocking issues

## What This Skill Does

1. **Workflow Activation**: Automatically identify when to activate Beads workflows based on project state
2. **Parallel Processing**: Optimize task execution for maximum parallelism while respecting dependencies
3. **Dependency Resolution**: Analyze and resolve blocking issues efficiently
4. **Task Prioritization**: Prioritize tasks based on dependencies and project needs
5. **Workflow Sync**: Ensure Beads and git workflows stay synchronized

---

## Quick Start (60 seconds)

### Basic Workflow Activation
```bash
# Check available work and activate optimal workflow
bd ready
```

### Parallel Task Execution
```bash
# Run multiple tasks in parallel when dependencies allow
bd sync --parallel
```

### Dependency Analysis
```bash
# Analyze blocking issues and resolve dependencies
bd blocked
```

### Workflow Optimization
```bash
# Optimize workflow for current project state
bd optimize
```

Expected output:
```
✓ Workflow analysis complete
→ 3 tasks ready for parallel execution
→ 2 blocking issues identified
→ Recommendations generated
```

---

## Configuration

### Basic Configuration
Beads workflow is configured through the project's `.beads/` directory. No additional configuration needed.

### Advanced Configuration
Edit `.beads/config.json` for custom workflow settings:
```json
{
  "parallel_threshold": 4,
  "dependency_analysis": true,
  "auto_optimize": true,
  "sync_frequency": "commit"
}
```

---

## Step-by-Step Guide

### 1. Initialize Workflow
```bash
# Initialize Beads in the project
bd init
```

### 2. Analyze Current State
```bash
# Check available work and project health
bd ready
bd stats
bd blocked
```

### 3. Optimize Workflow
```bash
# Analyze and optimize task dependencies
bd optimize
```

### 4. Execute Tasks
```bash
# Run tasks in parallel when dependencies allow
bd sync --parallel
```

### 5. Monitor Progress
```bash
# Check workflow status and sync
bd status
bd sync
```

---

## Advanced Features

### Parallel Task Execution
```bash
# Execute multiple independent tasks in parallel
bd run --parallel "task1 task2 task3"

From aegntic/cldcde, MIT.

More from aegntic/cldcde