What should I do if a parallel agent fails during execution?

You can fix the issue within the specific task's worktree, commit the fix, and proceed with stacking, or restart that specific agent after cleaning the worktree and removing failed branches.

Why does it say 'worktree not found' during the execute command?

This error typically occurs if the initial spec command was skipped or the worktree was deleted. Run the /spectacular:spec command first to establish the required directory structure.

How do I clean up after abandoning a feature implementation?

Use the recovery strategies provided to remove all associated worktrees, delete feature-specific branches via Git, and remove the corresponding spec directory.

How do I handle merge conflicts during branch stacking?

Navigate to the main worktree, attempt the merge manually, resolve conflicts in your editor, and commit the results. Update your future plan to mark these tasks as sequential rather than parallel.

Can I resume an execution after a manual fix?

Yes. Once you have manually verified that the state is clean and the necessary commits exist on the branch, you can continue to the next task or phase.

Troubleshooting Execute

Name: Troubleshooting Execute
Author: arittr

byarittr

•

デプロイメントとDevOps

Provides comprehensive diagnostic guides and recovery strategies for handling failures during automated task execution and branch stacking.

概要

This skill serves as an essential reference for developers using the Spectacular framework with Claude Code, offering step-by-step instructions to diagnose and resolve errors encountered during the execution phase. It covers a wide range of failure scenarios, including parallel agent breakdowns, merge conflicts during branch stacking, and Git worktree creation issues, ensuring that complex development workflows can be resumed or recovered without loss of progress.

主な機能

Strategies for manual task fixing and agent resumption
6 GitHub stars
Step-by-step resolution for sequential and parallel phase failures
Git worktree management and diagnostic command reference
Merge conflict resolution guide for stacked branch dependencies
Phase reset and clean-up procedures for fundamental implementation issues

ユースケース

Recovering from a failed parallel agent task without restarting the entire execution flow
Fixing environment errors such as 'worktree not found' or path collisions during task setup
Resolving merge conflicts that arise when stacking independent feature branches in a workflow

概要

主な機能

Strategies for manual task fixing and agent resumption
6 GitHub stars
Step-by-step resolution for sequential and parallel phase failures
Git worktree management and diagnostic command reference
Merge conflict resolution guide for stacked branch dependencies
Phase reset and clean-up procedures for fundamental implementation issues

ユースケース

Recovering from a failed parallel agent task without restarting the entire execution flow
Fixing environment errors such as 'worktree not found' or path collisions during task setup
Resolving merge conflicts that arise when stacking independent feature branches in a workflow