Troubleshooting

ADDP includes comprehensive troubleshooting documentation with purchase. You will find solutions for all common scenarios there.

What is covered

• Guard blocks: Check worktree path, verify sprint status
• TDD Gate blocks: Name test files correctly
• BuildCheck blocks: Fix build errors before committing
• SkipTest blocks: Implement tests instead of skipping
• Teammate not responding: Stop the agent and start a fresh one
• Worktree errors: Check and clean worktree status
• Worktree ticket---help created: up to v6.10.0 --help counted as a ticket number; from v6.10.1 it only prints the help
• Merge conflicts: Keep owner version
• addp-hook not found: Check PATH configuration
• OpenCode does not load ADDP: pick /skills → addp or accept the @addp suggestion instead of writing "use addp"
• Cannot type @ in the macOS Terminal: set "Use Option as Meta key" to the right Option key only