https://specdd.ai/how-to/troubleshooting/Spec-driven development troubleshooting guides for agent setup, editor recognition, CLI installs, Node versions, spec resolution, path references, stale criteria, and plugin or skill installs.Hugoen-ushttps://specdd.ai/how-to/troubleshooting/how-to-fix-an-agent-that-ignores-your-specs/https://specdd.ai/how-to/troubleshooting/how-to-fix-an-agent-that-ignores-your-specs/Fix an agent that ignores SpecDD specs by checking bootstrap setup, agent entrypoint wiring, plugin or skills installation, working directory, content root, and prompt scope.https://specdd.ai/how-to/troubleshooting/how-to-fix-sdd-files-not-being-recognized-or-highlighted/https://specdd.ai/how-to/troubleshooting/how-to-fix-sdd-files-not-being-recognized-or-highlighted/Fix .sdd files not being recognized or highlighted by checking editor plugins, file associations, workspace trust, filename extensions, reloads, and conflicting extensions.https://specdd.ai/how-to/troubleshooting/how-to-fix-a-failing-specdd-cli-install-or-command-not-found/https://specdd.ai/how-to/troubleshooting/how-to-fix-a-failing-specdd-cli-install-or-command-not-found/Fix SpecDD CLI install failures and command not found errors by checking Node, npm or Yarn globals, PATH, shell refresh, package manager output, Docker, and specdd --help.https://specdd.ai/how-to/troubleshooting/how-to-fix-specdd-node-version-errors/https://specdd.ai/how-to/troubleshooting/how-to-fix-specdd-node-version-errors/Fix SpecDD Node version errors by checking node -v, installing Node.js 22 or newer, avoiding mixed Node environments, and using Docker or another install path when needed.https://specdd.ai/how-to/troubleshooting/how-to-resolve-ambiguous-spec-match-warnings/https://specdd.ai/how-to/troubleshooting/how-to-resolve-ambiguous-spec-match-warnings/Resolve ambiguous SpecDD spec match warnings by fixing case-only same-basename collisions, preferring exact filenames, and renaming specs so tools do not guess.https://specdd.ai/how-to/troubleshooting/how-to-fix-path-references-that-do-not-resolve/https://specdd.ai/how-to/troubleshooting/how-to-fix-path-references-that-do-not-resolve/Fix unresolved SpecDD path references by checking explicit prefixes, relative location, content root, moved files, case sensitivity, stale references, and globs.https://specdd.ai/how-to/troubleshooting/how-to-debug-spec-resolution-problems/https://specdd.ai/how-to/troubleshooting/how-to-debug-spec-resolution-problems/Debug SpecDD resolution problems by tracing the selected content root, ancestor specs, directory specs, same-basename matching, references, globs, and CLI resolve output.https://specdd.ai/how-to/troubleshooting/how-to-fix-specs-that-are-too-vague-to-be-useful/https://specdd.ai/how-to/troubleshooting/how-to-fix-specs-that-are-too-vague-to-be-useful/Fix vague SpecDD specs by replacing generic goals with local ownership, observable Must rules, realistic Must not boundaries, scenarios, tasks, and Done when criteria.https://specdd.ai/how-to/troubleshooting/how-to-fix-a-spec-that-conflicts-with-a-parent-spec/https://specdd.ai/how-to/troubleshooting/how-to-fix-a-spec-that-conflicts-with-a-parent-spec/Fix a SpecDD child spec that conflicts with a parent spec by reading the inherited chain, applying stricter-wins logic, rewriting invalid tasks, and escalating unsafe changes.https://specdd.ai/how-to/troubleshooting/how-to-fix-an-agent-that-cannot-find-the-right-local-spec/https://specdd.ai/how-to/troubleshooting/how-to-fix-an-agent-that-cannot-find-the-right-local-spec/Fix an agent that cannot find the right SpecDD local spec by checking working directory, content root, same-basename placement, directory specs, references, and target path.https://specdd.ai/how-to/troubleshooting/how-to-fix-stale-done-when-criteria/https://specdd.ai/how-to/troubleshooting/how-to-fix-stale-done-when-criteria/Fix stale SpecDD Done when criteria by comparing current behavior, tasks, tests, and review needs, then updating completion criteria with the code change.https://specdd.ai/how-to/troubleshooting/how-to-fix-broken-specdd-plugin-or-skill-installs/https://specdd.ai/how-to/troubleshooting/how-to-fix-broken-specdd-plugin-or-skill-installs/Fix broken SpecDD plugin or Agent Skills installs by checking install paths, universal skills deployment, scope, reloads, discovery, and smoke-test prompts.