issue-tracer v2.0.0A

Immutable. This exact content is served forever at /api/v1/blob/355f1e5292b32e23.

---
name: issue-tracer
audience: swarm-plugin
description: >
  Use when asked to trace, investigate, root-cause, reproduce, plan, fix,
  resolve, close, or prepare a PR for an issue, bug report, defect, regression,
  failing test, or confusing runtime behavior. This Claude Code adapter's
  canonical protocol lives in .opencode and owns the Full-Resolution Contract,
  reproduction, reasoning-guided localization, no-gap fix planning, recurrence-
  class eradication, independent critic and implementation review, and PR-ready
  closure.
metadata:
  version: 2.0.0
---

# Issue Tracer

Read and follow `../../../.opencode/skills/issue-tracer/SKILL.md` as the
canonical workflow.

## Claude Code Execution Notes

- File-edit tool: `Edit` / `Write` / `MultiEdit`. Plan/tasklist tool:
  `TodoWrite`. Web tool: `WebFetch` / `WebSearch`. Repository search: `Grep` /
  `Glob` / `Read` (use them in parallel for independent files).
- Independent gates (Phase 3 plan critic, Phase 4.5 implementation review,
  Phase 4.6 final critic) use the `Agent` / `Task` subagent tool. Launch a
  separate context for each; give the reviewer only the diff and the artifacts
  named in the canonical `references/critic-gate.md`, never your own reasoning
  narrative.
- When running AS the `.claude/agents/issue-tracer.md` subagent, Claude Code
  cannot spawn nested subagents. Record that limitation as the delegation
  failure, run the labeled fallback pass from `references/critic-gate.md`
  ("Fallback self-critic/self-review/final-critic: independent … unavailable"),
  and disclose it in the artifact and final response.
- Trace directory and its VCS exclusion are created by the canonical
  `.opencode/skills/issue-tracer/scripts/trace-init.sh <issue-slug>` (run from
  the repo root; writes `.git/info/exclude`); the deferred-work gate is
  `.opencode/skills/issue-tracer/scripts/scan-deferred.sh`.
- Publication (commit/push/PR) is governed by the repo's canonical publish
  protocol, `.claude/skills/commit-pr/SKILL.md`. Switch to that skill only when
  the user asks to commit, push, or open/update a PR, and only after confirming
  there are no unrelated changes.