GitHub issue analysis
Do not implement the fix.
- Fetch every referenced issue, comments, labels, and linked PRs or discussions.
- Restate the observable problem, constraints, and acceptance criteria; identify missing or conflicting information.
- Inspect the relevant code, tests, history, and nearest
AGENTS.mdbefore forming a root-cause hypothesis. - Apply domain-specific constraints only when the affected code or acceptance criteria make them material.
- Distinguish verified cause, likely inference, and open question.
- Produce a sequenced plan with files/surfaces, behavior changes, tests, compatibility risks, and documentation impact.
- Link the source issues and relevant repository evidence.
When multiple issues overlap, explain the dependency or shared root and propose an order that keeps each change reviewable.
Example
Input: “Investigate why the player stalls after switching live sources.”
Output: A verified problem statement, evidence-ranked root-cause analysis, open questions, and a sequenced implementation plan without code changes.