Troubleshooting Execute FAQs

Question 1

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

Accepted Answer

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.

Question 2

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

Accepted Answer

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.

Question 3

How do I clean up after abandoning a feature implementation?

Accepted Answer

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

Question 4

How do I handle merge conflicts during branch stacking?

Accepted Answer

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.

Question 5

Can I resume an execution after a manual fix?

Accepted Answer

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

Key Features

Use Cases

Troubleshooting Execute

Key Features

Use Cases