workflow-setup

Create per-ticket git worktrees and set up development environments.

Updated Jan 26, 2026
One-click install
npx skills add https://github.com/dohernandez/claude-skills --skill workflow-setup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: workflow-setup
Source: https://github.com/dohernandez/claude-skills/tree/main/plugins/workflow-setup/skills/workflow-setup
Command: npx skills add https://github.com/dohernandez/claude-skills --skill workflow-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates the creation of per-ticket git worktrees and environment setup for ticket-based development workflows.

Core Features & Use Cases

  • Creates a dedicated git worktree per ticket and establishes a isolated development space
  • Copies environment files (.env*) into the new worktree and opens the configured IDE
  • Installs dependencies by automatically detecting and running the appropriate setup command
  • Creates a workflow directory structure under .claude/workflow/<branch> with plan, context, and handoff files
  • Writes context.json and pending-action.json to enable smooth handoff to the next Claude session
  • Integrates with the workflow skill to streamline ticket-based development

Quick Start

Configure workflow settings with /workflow configure and then start a ticket workflow to create a per-branch worktree and open the IDE.

Frequently Asked Questions about workflow-setup

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

FAQPage Schema
How do I create a git worktree for a specific ticket?

To create a git worktree for a specific ticket, you configure your workflow settings and start a ticket workflow. This automatically spins up an isolated per-branch worktree, copies your environment files, and opens your configured IDE.

What is the best way to automate development environment setup across multiple tickets?

Automating development environment setup is best handled by spinning up per-ticket git worktrees. This process automatically copies environment files, detects and installs dependencies, and generates workflow context files for seamless handoff.

Does git worktree automation handle dependency installation and environment file copying?

Yes, git worktree automation handles dependency installation by detecting and running the appropriate setup command. It also copies .env files into the new worktree to ensure the isolated development space is ready.

Can I preserve workflow context and pending actions between Claude sessions?

You can preserve workflow context between Claude sessions by writing context.json and pending-action.json files. These files are generated under the .claude/workflow/<branch> directory to enable smooth handoff to the next session.

How do isolated worktrees integrate with existing ticket-based development workflows?

Isolated worktrees integrate with ticket-based development workflows by creating a dedicated branch workspace and initializing workflow context. This streamlines the process by managing worktree lifecycles and updating the main branch.

Where does the workflow configuration file get stored during environment setup?

During environment setup, the workflow configuration file is stored under .claude/workflow-config.json. This file exposes the configuration settings applied when booting isolated worktrees and initializing the workflow.