Dev Workflow Orchestrator
/Dev Workflow Orchestrator
Full development workflow from idea to parallel execution. Use when planning features/bugfixes/refactors, breaking work into beads tasks, selecting tasks to parallelize (max 4), launching Claude instances in tmux worktrees, and cleaning up after completion. Triggers: "plan feature", "plan refactor", "plan bugfix", "start parallel work", "launch parallel", "cleanup worktrees", "kill parallel", or /dev-workflow.
- Author
- spartDev ↗
- Repository
- My-Prompt-Manager ↗
- Licence
- MIT
- Last repository change
- 23.10.2026
Assessment and security
- Files in this package
- 2
- Scripts
- 1
- HTML comments
- 0
- URLs in SKILL.md
- 1
No signals detected. Repository changed on 23.10.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
- 1 scripts in this package. Review them before installing, as Claude may execute them.
Scripts: scripts/dev-workflow.sh
What it does and when to use it
Full development workflow from idea to parallel execution. Use when planning features/bugfixes/refactors, breaking work into beads tasks, selecting tasks to parallelize (max 4), launching Claude instances in tmux worktrees, and cleaning up after completion. Triggers: "plan feature", "plan refactor", "plan bugfix", "start parallel work", "launch parallel", "cleanup worktrees", "kill parallel", or /dev-workflow.
Triggers from the description
Original author description
Full development workflow from idea to parallel execution. Use when planning features/bugfixes/refactors, breaking work into beads tasks, selecting tasks to parallelize (max 4), launching Claude instances in tmux worktrees, and cleaning up after completion. Triggers: "plan feature", "plan refactor", "plan bugfix", "start parallel work", "launch parallel", "cleanup worktrees", "kill parallel", or /dev-workflow.
How it works
- Workflow Overview
- Quick Commands
- Phase 1: Planning
- Phase 2: Task Selection
- Phase 3: Parallel Execution
- Phase 4: Monitoring
- Phase 5: Cleanup
- AI Assistant Behavior
- Error Recovery
- Best Practices
SKILL.md preview
--- name: Dev Workflow Orchestrator description: | Full development workflow from idea to parallel execution. Use when planning features/bugfixes/refactors, breaking work into beads tasks, selecting tasks to parallelize (max 4), launching Claude instances in tmux worktrees, and cleaning up after completion. Triggers: "plan feature", "plan refactor", "plan bugfix", "start parallel work", "launch parallel", "cleanup worktrees", "kill parallel", or /dev-workflow. --- # Dev Workflow Orchestrator Orchestrates the full development cycle: Plan → Create Tasks → Select → Execute in Parallel → PR → Cleanup. ## Workflow Overview ``` ┌─────────────┐ ┌──────────────┐ ┌────────────────┐ ┌──────────────┐ ┌─────────┐ │ 1. PLAN │ → │ 2. CREATE │ → │ 3. SELECT │ → │ 4. EXECUTE │ → │ 5. DONE │ │ Idea/scope │ │ Beads tasks │ │ N tasks (≤4) │ │ Parallel PRs │ │ Cleanup │ └─────────────┘ └──────────────┘ └────────────────┘ └──────────────┘ └─────────┘ ``` ## Quick Commands ```bash # Full workflow (interactive) .claude/skills/dev-workflow/scripts/dev-workflow.sh # Individual steps .claude/skills/dev-workflow/scripts/dev-workflow.sh plan # Plan & create tasks .claude/skills/dev-workflow/scripts/dev-workflow.sh select # Select & launch parallel .claude/skills/dev-workflow/scripts/dev-workflow.sh cleanup # Kill tmux & clear worktrees .claude/skills/dev-workflow/scripts/dev-workflow.sh status # Check parallel session status ``` ## Phase 1: Planning When user describes a feature, bugfix, or refactor: ### Step 1.1: Understand the Scope Ask clarifying questions: - What is the goal? - What files/components are involved? - Any constraints or dependencies? ### Step 1.2: Break Down into Tasks Create beads tasks for each discrete piece of work: ```bash # Create tasks in parallel for efficiency bd create --title="Implement X component" --type=feature --priority=2 bd create --title="Add tests for X" --type=task --priority=2 bd create --title="Update documentation for X" --type=task --priority=3 ``` **Task creation guidelines:** - Each task should be independently completable - Tasks touching different files are ideal for parallelization - Use appropriate types: `feature`, `task`, `bug`, `refactor` - Priority: 0=critical, 1=high, 2=medium, 3=low, 4=backlog ### Step 1.3: Set Dependencies (if any) ```bash bd dep add <tests-id> <implementation-id> # Tests depend on implementation ``` ## Phase 2: Task Selection ### Step 2.1: Show Available Tasks ```bash bd ready # Shows tasks with no blockers ``` ### Step 2.2: Ask User for Selection Use `AskUserQuestion` to present ready tasks: ``` Which tasks do you want to tackle in parallel? (Maximum 4) Ready tasks: 1. [P2] beads-abc: Implement X component 2. [P2] beads-def: Add Y validation 3. [P2] beads-ghi: Refactor Z service 4. [P3] beads-jkl: Update docs Enter task IDs (e.g., "abc def ghi"): ``` **Selection criteria for parallelization:** - Tasks should touch different files (avoid merge conflicts) - No dependencies between selected tasks - Same priority level preferred - Maximum 4 concurrent instances ### Step 2.3: Validate Selection Check for conflicts: ```bash # Verify no dependencies between selected tasks bd show abc | grep -A5 "Dependencies" bd show def | grep -A5 "Dependencies" ``` ## Phase 3: Parallel Execution ### Step 3.1: Claim Tasks ```bash bd update abc --status in_progress bd update def --status in_progress ``` ### Step 3.2: Launch Parallel Instances ```bash .claude/skills/dev-workflow/scripts/dev-workflow.sh select abc def ghi ``` This will: 1. Create git worktrees (`~/.claude-worktrees/<repo>/fix-<id>`) 2. Launch tmux session `claude-parallel` 3. Start Claude in each pane with task-specific prompts ### The Prompt Each Instance Receives Each Claude instance gets a detailed prompt: ``` You are working on issue <ID>: <TITLE> ## Task Details <Full bd show output> ## Your Mission 1. Implement the fix/feature in this worktree 2. Run tests: npm test 3. Run lint: npm run lint 4. Run typecheck: npm run typecheck 5. Commit your changes with a descriptive message 6. Create a detailed PR with: - Summary of what the issue was - What changes were made and WHY - Testing done 7. Close the issue: bd close <ID> ## PR Template Use this format for your PR: gh pr create --title "<type>(<scope>): <description>" --body "$(cat <<'EOF' ## Summary - What problem this solves - High-level approach taken ## Changes Made - Specific code changes with reasoning ## Technical Details - Architectural decisions - Why this approach over alternatives ## Testing - [ ] Unit tests pass - [ ] Lint passes - [ ] TypeScript checks pass - [ ] Manual testing: <describe> ## Related - Fixes issue <ID> 🤖 Generated with [Claude Code](https://claude.com/claude-code) EOF )" ## Important - Work ONLY in this worktree - Do NOT merge to main - create PR only - Push your branch: git push -u origin fix-<ID> ``` ## Phase 4: Monitoring ### tmux Navigation ``` Ctrl+B, arrow keys → Switch between panes Ctrl+B, z → Zoom/unzoom current pane Ctrl+B, [ → Enter scroll mode (q to exit) Ctrl+B, d → Detach (instances keep running) ``` ### Check Status ```bash # Reattach to session tmux attach-session -t claude-parallel # Check without attaching .claude/skills/dev-workflow/scripts/dev-workflow.sh status # Preview pane content tmux capture-pane -t claude-parallel:0.0 -p | tail -20 ``` ## Phase 5: Cleanup After all PRs are created and merged: ```bash .claude/skills/dev-workflow/scripts/dev-workflow.sh cleanup ``` This will: 1. Kill the tmux session 2. Remove all worktrees 3. Prune git worktree references 4. Sync beads: `bd sync && git push` ### Manual Cleanup ```bash # Kill tmux session only tmux kill-session -t claude-parallel # List worktrees git worktree list # Remove specific worktree git worktree remove ~/.claude-worktrees/<repo>/fix-<id> --force # Prune all stale worktrees git worktree prune ``` ## AI Assistant Behavior When `/dev-workflow` is invoked: ### If user has an idea/plan to discuss: 1. Help break it down into discrete tasks 2. Create beads issues with appropriate types and priorities 3. Set up any dependencies 4. Proceed to selection phase ### If user wants to start parallel work: 1. Run `bd ready` to show available tasks 2. Ask which tasks to parallelize (max 4) 3. Validate no conflicts 4. Launch parallel instances ### If user wants to cleanup: 1. Run the cleanup script 2. Confirm all worktrees removed 3. Ensure beads synced ## Error Recovery ### If one instance fails: - Other instances continue - Fix manually in that worktree, or - Kill pane and retry: `tmux kill-pane -t claude-parallel:0.1` ### If tmux session dies: - Worktrees persist - Relaunch: `.claude/skills/dev-workflow/scripts/dev-workflow.sh select <ids>` ### If merge conflicts occur: - This shouldn't happen if tasks touch different files - Resolve manually in the conflicting worktree - Consider sequential execution for tightly coupled changes ## Best Practices 1. **Plan before parallelizing** - Clear task boundaries prevent conflicts 2. **Max 4 instances** - More becomes hard to monitor and review 3. **Independent tasks only** - No dependencies between parallel tasks 4. **Different files** - Avoid parallel work on same files 5. **Review all PRs** - Don't auto-merge, review each PR carefully 6. **Cleanup promptly** - Don't leave worktrees lingering
Files in this package (2)
- SKILL.md 8 KB
- scripts/dev-workflow.sh 17 KB
Versions
The database has no other skills named Dev Workflow Orchestrator.
Database snapshot: 13.11.2026 · package version 537f0a3aeaee (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100parallel-claude
Launch multiple Claude Code instances in parallel using tmux and git worktrees to tackle beads tasks concurrently. Use when user mentions parallel execution, multi-agent, parallel claude, or wants to run multiple Claude instances simultaneously on different tasks. - 100using-git-worktrees
Git worktree management with tmux integration and task dispatch. Use when creating isolated dev environments, launching parallel feature work, running multiple Claude instances, managing worktrees, dispatching tasks to worktree terminals, or cleaning up after merge. Covers… - 100git-worktree
Manage Git worktrees for isolated parallel development. Use when creating, switching, or cleaning up worktrees for parallel bead work. - 100workmux
Manage terminal agents, git worktrees, and tmux sessions with workmux. Use when the user asks to open or start an agent in a project, check running agents or their progress in a tmux session, or work with workmux, worktrees, or parallel agent workflows. - 90dev-workflow-orchestrator
High-level entry point for development workflows. Routes to start work, check deploy readiness, prepare MR, monitor pipelines, standup, or handle review. Use when user says "dev workflow" or "orchestrate". - 90worktrees:orchestrator
Use for multi-subagent parallel development. A main Claude instance manages multiple concurrent subagents, each working in isolated worktrees. Invoke with "/worktrees:orchestrator <feature>" or when user mentions "orchestrate agents", "parallel subagents", "coordinate…