parallel-worktree-dev

Create and manage git worktrees for parallel feature development with cloud-agent handoffs.

Updated Oct 8, 2025
One-click install
npx skills add https://github.com/ichabodcole/project-docs-scaffold-template --skill parallel-worktree-dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: parallel-worktree-dev
Source: https://github.com/ichabodcole/project-docs-scaffold-template/tree/main/plugins/project-docs/skills/parallel-worktree-dev
Command: npx skills add https://github.com/ichabodcole/project-docs-scaffold-template --skill parallel-worktree-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Orchestrates parallel development by creating and managing multiple git worktrees, enabling teams to work on several features simultaneously without blocking the main repository.

Core Features & Use Cases

  • Create and manage separate worktrees for different features to enable concurrent development.
  • Provide lightweight handoff documents (WORKTREE_TASK.md) to guide cloud agents through discovery, planning, and implementation.
  • Coordinate parallel work across proposals and investigations with clear status tracking and dependency management.

Quick Start

Create one or more feature worktrees and write a concise WORKTREE_TASK.md to initiate cloud-agent driven development.

Frequently Asked Questions about parallel-worktree-dev

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

FAQPage Schema
How do I work on multiple git features in parallel without blocking the main repository?

Git worktrees allow you to manage multiple features concurrently by creating separate working directories from a single repository. This approach orchestrates parallel development by providing each cloud agent with an isolated worktree and a handoff document to guide implementation without blocking the main branch.

What is a git worktree and when do I need it for parallel development?

A git worktree creates an additional working directory linked to your main repository, needed when orchestrating parallel development across multiple features. It enables concurrent work on separate proposals or investigations by providing isolated environments for cloud agents to handle discovery, planning, and implementation.

How do I hand off a feature task to a cloud agent using a worktree?

To hand off a feature task, you write a concise WORKTREE_TASK.md document inside the newly created worktree. This lightweight handoff file guides cloud agents through discovery, planning, and implementation, initiating parallel development across multiple features simultaneously.

Can I coordinate parallel work across multiple investigations with git worktrees?

Yes, you can coordinate parallel work across multiple proposals and investigations using git worktrees. The orchestration process provides clear status tracking and dependency management across all active worktrees, ensuring concurrent feature development remains organized and effectively managed.

What is the best way to orchestrate cloud agents for concurrent feature development?

The best way to orchestrate cloud agents is by creating separate git worktrees for each feature and providing lightweight handoff documents. This enables cloud agents to concurrently drive discovery, planning, and implementation across multiple features without blocking the main repository.