TROUBLESHOOTING

Diagnose worktree creation failures and apply remediation steps.

2|2|Updated Feb 9, 2017
One-click install
npx skills add https://github.com/sumik5/dotfiles --skill troubleshooting-sumik5
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: TROUBLESHOOTING
Source: https://github.com/sumik5/dotfiles/tree/main/claude-code/skills/managing-as-aramaki/TROUBLESHOOTING.md
Command: npx skills add https://github.com/sumik5/dotfiles --skill troubleshooting-sumik5

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This guide provides troubleshooting steps for common issues when running PO/Manager skills, including worktree creation flows and policy violations.

Core Features & Use Cases

  • Common errors: Submodule handling, worktree conflicts, and environment copy issues.
  • Recovery steps: Safe rollback and remediation guides.

Quick Start

Identify a failure in a new worktree creation and apply the remediation template.

Frequently Asked Questions about TROUBLESHOOTING

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

FAQPage Schema
How do I resolve worktree creation failures when running manager skills?

Worktree creation failures typically stem from submodule handling, environment copy issues, or policy violations. Identify the specific failure type, apply the remediation template provided in the troubleshooting guide, and use safe rollback steps to recover before retrying delegation to developer agents.

What are common git worktree conflicts and how do I fix them?

Git worktree conflicts arise from incomplete checkouts, stale references, or simultaneous access. The troubleshooting guide covers detection and recovery steps for each scenario, enabling you to safely remediate and resume skill execution without data loss.

When should I apply policy checks before creating a new worktree?

Apply policy checks before worktree creation to prevent constraint violations during strategy execution. This qualifying step ensures your project's technology choices, task prioritization, and requirement analysis align with organizational standards before delegation.

Can I recover from a failed worktree creation without losing work?

Yes. The skill provides safe rollback and remediation guides that preserve your work during recovery. Follow the step-by-step recovery process to resolve the underlying issue—submodule handling, environment setup, or policy conflict—then retry worktree creation.

How do I handle environment copy issues in worktree workflows?

Environment copy failures occur when source state doesn't transfer correctly to new worktrees. Use the provided recovery steps to diagnose missing variables, dependency mismatches, or permission problems, then reapply the environment before resuming manager-ready directive generation.