debug git:20260916.3ebf0e9A

Immutable. This exact content never changes and is served at /api/v1/blob/bd81cf6aeecb9bca.

---
name: debug
description: 'Use when encountering any bug, test failure, build break, or unexpected behavior — runs a 4-phase systematic debugging process before proposing any fix. Iron Law: NO FIXES WITHOUT ROOT CAUSE INVESTIGATION FIRST. Produces a `.orchestrator/debug/` artifact the fixer agent must reference.'
metadata:
  model: inherit
  color: red
  user-invocable: 'true'
  argument-hint: '[bug-description-or-issue-ref]'
allowed-tools:
  - Read
  - Grep
  - Glob
  - Bash
  - Write
---

<!-- Generated by scripts/generate-codex-skills.mjs; do not edit. -->

# debug

Read [`skills/debug/SKILL.md`](../../../skills/debug/SKILL.md) in full before taking any action, then follow its complete workflow.
The linked document is authoritative, including its prechecks, argument rules, and stop conditions.

Resolve this link relative to this SKILL.md, not the project working directory. The plugin root is three directories above this file. Resolve package paths such as `skills/` and `scripts/` from that root; resolve relative links inside the canonical document from its own directory. Keep the user’s project as the target of project operations.

`$ARGUMENTS` means the trailing user input after the selected command skill, or an empty string when absent. Preserve flags, quoted text, and Unicode as data. Do not perform global substitution in the command document, shell expansion on the argument string, or execution of that string as shell code. When the workflow needs a command, pass its arguments through structured tool parameters or safely quoted individual arguments.

Regenerate with `node scripts/generate-codex-skills.mjs`.