beads-workflow

Coordinate beads task tracking with Git branch setup and recovery workflows.

Updated Feb 9, 2026
One-click install
npx skills add https://github.com/msanssouci/opencode --skill beads-workflow-msanssouci
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: beads-workflow
Source: https://github.com/msanssouci/opencode/tree/main/skills/beads-workflow
Command: npx skills add https://github.com/msanssouci/opencode --skill beads-workflow-msanssouci

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Beads workflow provides comprehensive guidance for tracking tasks with beads, ensures proper git branch setup before starting work, and supplies troubleshooting steps to recover from interruptions.

Core Features & Use Cases

  • Beads task tracking guidance for multi-step projects, including branching and recovery workflows
  • Decision trees and best-practice patterns for using beads with git to keep work auditable and connected to commits
  • Troubleshooting and recovery guidance for interrupted sessions and stale tasks with concrete examples

Quick Start

When you begin work, follow the pre-task git branch setup and create a beads task to start tracking changes

Frequently Asked Questions about beads-workflow

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

FAQPage Schema
How do I track software development tasks with git branches to prevent lost work?

To prevent lost work, beads task tracking coordinates with git workflows by enforcing pre-task branch setup and structured task lifecycles. This ensures changes remain auditable and properly connected to commits throughout development sessions.

What is a beads-driven workflow for software projects?

A beads-driven workflow applies structured task tracking patterns and decision trees to software development projects. It guides task creation, branch setup, and synchronization to keep project work auditable and connected to git commits.

How do I set up a git branch before starting a new tracked task?

Setting up a git branch before starting a tracked task follows pre-task guidelines provided by the beads workflow. You create a beads task to start tracking changes, ensuring the branch is properly configured before development begins.

How do I recover from interrupted development sessions with stale tasks?

Recovering from interrupted sessions with stale tasks uses troubleshooting steps and concrete examples provided by the beads workflow. It supplies recovery guidance to restore session state and resume interrupted task tracking safely.

Can I use beads task tracking for multi-step software development projects?

Yes, beads task tracking is designed for multi-step software development projects. It provides branching and recovery workflows with best-practice patterns to manage structured task lifecycles across complex project stages.

What's the best way to keep task tracking connected to git commits?

The best way to keep task tracking connected to git commits is applying beads-patterns with decision trees that enforce synchronization. This structured approach maintains an auditable link between task lifecycles and branch commits.