beads-worker

Implement a single Beads task in an isolated git worktree with plan publication and summary.

Updated Jan 26, 2026
One-click install
npx skills add https://github.com/vega113/beads-orchestration-skills --skill beads-worker
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: beads-worker
Source: https://github.com/vega113/beads-orchestration-skills/tree/main/beads-worker
Command: npx skills add https://github.com/vega113/beads-orchestration-skills --skill beads-worker

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Executes a strict, end-to-end single-task implementation within a dedicated git worktree, ensuring plan→code→self-review while keeping changes scoped to the task.

Core Features & Use Cases

  • Isolates work to a single Beads task using a dedicated worktree/branch.
  • Enforces publishing a plan before coding, self-review, and a final implementation summary posted back to the task.
  • Useful for implementing one-off Beads tasks, debugging in isolation, or conducting focused task demonstrations.

Quick Start

Create a dedicated worktree for the Beads task, publish the plan, implement the task, perform self-review, and post the implementation summary back to the task.

Frequently Asked Questions about beads-worker

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

FAQPage Schema
How do I implement a single coding task in an isolated git worktree?▼

Single-task implementation in an isolated git worktree requires creating a dedicated branch, publishing a plan, coding changes, performing self-review, and posting a final implementation summary back to the task.

What is the best way to isolate Beads task coding from my main branch?▼

Isolating Beads task coding from your main branch involves using a dedicated git worktree, ensuring changes remain strictly scoped to the task and enforcing deterministic commits without affecting your main branch.

Does single-task worktree coding require publishing a plan before writing code?▼

Yes, single-task worktree coding enforces publishing a plan before coding begins. This ensures structured execution through a strict plan, code, and self-review workflow within the isolated environment.

Can I use a git worktree to debug a single Beads task in isolation?▼

Yes, you can use a git worktree to debug a single Beads task in isolation. This approach confines your debugging changes to a dedicated branch, ensuring deterministic commits and a clean main branch.

What are the limitations of executing single-task implementations in isolated worktrees?▼

The limitation of single-task implementations in isolated worktrees is that work is strictly scoped to one task. This approach is not suited for multi-task branching or parallel feature development within the same workspace.