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.