issue-tracer

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 Codex 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.1.0"}

Issue Tracer

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

Codex Execution Notes

• File-edit tool: apply_patch. Plan/tasklist tool: update_plan for substantial work. Web tool: web (current external framework/API behavior, advisories, release notes — cite URLs). Use the shell execution tool for rg, git, gh, tests, builds, and local validation, in parallel where the files are independent.
• The independent critic (Phase 3), implementation review (Phase 4.5), and final critic (Phase 4.6) run only when a separate subagent/delegation mechanism is available and authorized. When none is available, record the unavailability and run the labeled fallback pass from .opencode/skills/issue-tracer/references/critic-gate.md ("Fallback self-critic/self-review/final-critic: independent … unavailable"), disclosed in the artifact and final response.
• For opencode-swarm specifically, read AGENTS.md and docs/engineering-invariants.md for touched invariants, use repo shell commands (not broad OpenCode test_runner scopes) for validation, and load writing-tests before changing tests.
• 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); 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 via the commit-pr skill (.agents/skills/commit-pr/SKILL.md, which routes to .claude/skills/commit-pr/SKILL.md). Switch to it only when the user asks to commit, push, or open/update a PR.