implement-worktree

Implement feature plans in isolated git worktrees with validation and registry updates.

Updated Jan 18, 2026
One-click install
npx skills add https://github.com/girarda/civ --skill implement-worktree
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: implement-worktree
Source: https://github.com/girarda/civ/tree/main/.claude/skills/implement-worktree
Command: npx skills add https://github.com/girarda/civ --skill implement-worktree

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a structured approach to implementing planned features by using isolated git worktrees, enabling full validation with end-to-end tests, code review, and human-readable documentation before merging changes.

Core Features & Use Cases

  • Isolated feature implementation via dedicated worktrees to prevent cross-branch contamination.
  • Parallel review workflow with automated validation steps and a registry-backed plan tracking.
  • Phase-based progress: derive branch/worktree details from plan files and update the workstream registry.

Quick Start

From the repository root, run the implement-worktree command with a plan file path, e.g.: /implement-worktree .swarm/plans/2026-01-18-my-feature.md Then follow prompts or CLI options to select base, phase, and reviewers.

Frequently Asked Questions about implement-worktree

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

FAQPage Schema
How do I implement a feature plan using an isolated git worktree?

To implement a feature plan using an isolated git worktree, run the implement-worktree command with a plan file path like .swarm/plans/my-feature.md. This creates a dedicated worktree, derives branches, and runs validations to prevent cross-branch contamination during feature development.

What is the best way to prevent cross-branch contamination during feature implementation?

Using isolated git worktrees is the best way to prevent cross-branch contamination during feature implementation. This approach creates separate working directories for each feature, ensuring parallel development and automated validation steps do not interfere with the main branch.

How does a worktree workflow handle E2E test scaffolding and code review?

A worktree workflow handles E2E test scaffolding and code review by generating end-to-end test scaffolding automatically and enabling parallel review workflows. It tracks progress through phase-based checkpoints and updates a registry before merging feature changes.

Do I need plan files in .swarm/plans to use a plan-driven worktree workflow?

Yes, you need plan files stored under the .swarm/plans directory to use a plan-driven worktree workflow. The system derives branch and worktree details from these plan files to update the .swarm/workstreams.json registry and manage phase-based progress.

Can I run parallel reviews and checkpoints in a git worktree setup?

Yes, you can run parallel reviews and checkpoints in a git worktree setup. The workflow applies automated validation steps and registry-backed plan tracking to ensure thorough code review and human-readable documentation are completed before merging changes.