OpenCode Session Debugging

Use this skill to investigate a broken OpenCode session from evidence first, then fix the responsible code only after the failure mechanism is pinned by a test.

Non-Negotiables

1. Inspect the latest OpenCode source before relying on OpenCode behavior.
2. Find every child session recursively. A parent transcript alone is incomplete evidence.
3. Build a timestamped timeline from transcripts, OpenCode logs, plugin logs, and background-task state.
4. Use git history and blame for the failing subsystem before changing code.
5. If a fix is needed, switch to work-with-pr: create a new worktree, write the failing test first, open a PR, and do not merge until all required gates pass.
6. Treat raw session.prompt and session.promptAsync paths as suspect until the shared prompt gate has been audited.

Phase 0: Capture Inputs

Accept any of these as the starting point: