beads-workflow

Name: beads-workflow
Availability: InStock
Author: timequity

Automate beads issue tracker task management with session-start workflows.

6|Updated Dec 7, 2025

Search Tags:#workflow #beads #bd #task-management #project-management

Ready to run

npx skills add https://github.com/timequity/plugins --skill beads-workflow-timequity

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: beads-workflow
Source: https://github.com/timequity/plugins/tree/main/vibe-coder/skills/beads-workflow
Command: npx skills add https://github.com/timequity/plugins --skill beads-workflow-timequity

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Proactive task management for projects using beads issue tracker. It helps orchestrate task flow, readiness, and progress between beads-based tasks.

Core Features & Use Cases

Session Start: Initialize beads workflow and CLAUDE Beads.md prompts
Task Decomposition: Break down beads tasks with TodoWrite
Ready/Progress Sync: Sync and switch between in-progress and ready tasks
Next Task Guidance: Present next high-priority task from ready queue

Quick Start

When starting a beads session, use the beads workflow to show current in_progress task or pick from ready tasks, then break work into subtasks and proceed.

Frequently Asked Questions about beads-workflow

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

FAQPage Schema

How do I automate task management in a beads project?▼

Beads-workflow automates task orchestration by managing work initiation, task selection, and progress tracking within beads issue tracker projects. Start the workflow in a directory containing .beads/ to initialize session, select ready tasks, and advance them through in_progress and completion states using triggers like 'next task', 'done', or 'refresh'.

What triggers activate the beads workflow?▼

Beads-workflow responds to multiple trigger phrases including 'next task', 'pick task', 'done', 'tasks', 'refresh', 'sync', 'какие задачи', 'что делать', 'готово', 'следующая задача', 'создай задачу', and 'обнови задачи'. These commands initiate task selection, completion workflows, subtask creation, and synchronization actions.

Do I need CLAUDE.md to use beads workflow?▼

Yes, beads-workflow requires CLAUDE.md provisioning as a mandatory environment check before managing tasks. The workflow validates beads presence and CLAUDE.md setup during session initialization to ensure proper context and prompt configuration.

How do I break down beads tasks into subtasks?▼

Beads-workflow implements task decomposition through TodoWrite, enabling you to create subtasks and structure work within existing beads tasks. Use workflow triggers to initiate subtask creation while tracking progress and managing task transitions.

Can beads workflow synchronize across multiple tasks?▼

Yes, beads-workflow includes synchronization capabilities through 'bd sync' and environment context retrieval. It syncs ready and in_progress task states, allowing you to refresh task queues and switch between active work items across beads projects.

What happens during beads workflow session start?▼

Session start initializes beads workflow by checking for .beads/ directory presence, provisioning CLAUDE.md, retrieving current context, and presenting task status. The workflow then guides you to either continue an in_progress task or select from ready tasks.