skills.rest
jankneumann
jankneumannCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

openspec-beads-worktree

Convert OpenSpec proposals into Beads tasks and isolated Git worktrees.

Updated Dec 26, 2025
Search Tags:#beads#openspec#parallel-execution#git-worktree#task-coordination
One-click install
npx skills add https://github.com/jankneumann/agentic-content-analyzer --skill openspec-beads-worktree
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-beads-worktree
Source: https://github.com/jankneumann/agentic-content-analyzer/tree/main/.gemini/skills/openspec-beads-worktree
Command: npx skills add https://github.com/jankneumann/agentic-content-analyzer --skill openspec-beads-worktree

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Development teams often struggle to translate OpenSpec specifications into actionable tasks, track progress, and execute work in parallel without manual overhead. This Skill automates the end‑to‑end flow, bridging OpenSpec, Beads task tracking, and Git worktree isolation.

Core Features & Use Cases

  • Spec‑to‑Task conversion: Parses tasks.md and creates a Beads epic with linked issues.
  • Worktree provisioning: Generates isolated Git worktrees for each task, enabling safe parallel development.
  • Orchestration scripts: Builds execution and monitoring scripts to launch agents and track status.
  • Integration & archiving: Merges completed work, cleans up worktrees, and archives the OpenSpec proposal.

Quick Start

Run the skill to convert an OpenSpec proposal into Beads tasks, set up git worktrees, and execute the implementation in parallel.

Frequently Asked Questions about openspec-beads-worktree

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

FAQPage Schema
How do I convert OpenSpec proposals into tracked tasks and isolated Git worktrees?▼

OpenSpec proposals are parsed into Beads epics with linked issues, and isolated Git worktrees are provisioned for each task, enabling safe parallel development. This automates the end-to-end flow bridging spec-driven planning with task coordination.

What is the best way to run parallel agent execution using Git worktrees and task coordination?▼

Parallel agent execution is handled by building orchestration scripts that launch agents and track status across isolated Git worktrees. This approach ensures safe concurrent development without manual overhead from worktree management.

Does this work with my existing Beads and Git worktree setup for spec-driven planning?▼

It requires Beads (bd) version 0.21.5 or higher, Git with worktree support, and the OpenSpec CLI. Your software development project must need spec-driven planning and task coordination to function properly.

How do I merge completed work and clean up Git worktrees after parallel execution?▼

Completed work is merged back into the main branch, after which the isolated Git worktrees are cleaned up and the OpenSpec proposal is archived. This integration and archiving step finalizes the parallel development cycle.

Can I use OpenSpec with Beads for task coordination without manual worktree setup?▼

Yes, worktree provisioning is fully automated, generating isolated Git worktrees for each task created from the OpenSpec tasks.md file. This eliminates manual overhead when translating specifications into actionable parallel work.

Why do I need Git worktrees for parallel agent execution in software development?▼

Git worktrees provide isolated environments for each task, preventing branch conflicts during parallel agent execution. This isolation is essential for safely running multiple development agents concurrently on the same project.

Related Skills

Explore More Software Engineering Skills→
jankneumannjankneumann
4

openspec-coordinator-worktree

Convert OpenSpec proposals into coordinator issues and isolated git worktrees.

Community
Advanced
jankneumannjankneumann

linear-cleanup-feature

Merge approved OpenSpec feature pull requests and archive proposals.

Community
Advanced
J-StaR-Films-StudiosJ-StaR-Films-Studios
23

git-worktree

Creates, synchronizes, and removes isolated Git worktrees for parallel agent development.

Official
Intermediate
Geralt1983Geralt1983
1

sparc-methodology

Orchestrate multi-agent software development using the SPARC methodology with TDD.

Community
Advanced