The situation
A customer reports that an export screen produces an incorrect total after a particular edit sequence. The repository contains tests and unrelated cleanup opportunities. You need to establish what fails before accepting an assistant's plausible explanation. Gather the report, a representative nonprivate fixture, and the affected environment details. Build a repeatable reproduction, trace the relevant path, and keep any proposed fix focused on the demonstrated behavior rather than a modernization.
Build a small, reviewable version
Write the observable contract
Translate the report into starting state, exact input, action sequence, expected result, and observed result. Identify missing details that prevent reproduction and obtain them from the reporter or existing records. Keep suspected causes separate from facts established by the report or environment.
Check: Another developer can follow the described steps without guessing missing actions.
Reproduce before explaining
Run the case in the affected version with the supplied fixture. Ask the coding assistant to help narrow the relevant execution path using the actual result. Reduce unrelated setup while preserving the failure, and record the command or interaction sequence that still demonstrates it.
Check: The unmodified application exhibits the reported failure with the retained fixture.
Propose the smallest correction
Inspect the code path responsible for the reproduced difference between expected and observed behavior. Request a focused explanation and patch tied to that evidence. Review changed assumptions and nearby callers, leaving unrelated cleanup outside the patch unless it is necessary to correct the demonstrated issue.
Check: Every changed line supports the reproduced behavior or its focused verification.
Compare the same case again
Rerun the reproduction after the patch, then check one relevant neighboring case that could expose an incorrect generalization. Record actual results. Package the fixture, commands, explanation, and patch so a reviewer can assess the correction.
Check: The original case now meets the contract and the relevant neighboring case passes.
Your acceptance checklist
- The original failure is reproduced before any patch is accepted.
- The retained fixture removes unrelated setup without losing the observed failure.
- The patch explanation connects directly to the failing execution path.
- Recorded results cover the original case and a relevant neighboring behavior.
Where the process can go wrong
- A convincing explanation without reproduction can address a different problem.
- Updating dependencies while investigating can erase the environment that exposed the bug.
- Broad cleanup obscures which change actually corrected the observed failure.
Choose the workflow deliberately
Consider Cursor, GitHub Copilot, or Cline within the workflow your team uses. Favor the candidate that keeps the reproduction, diff, and command results easy to inspect. If the environment cannot be recreated, deliver an explicit investigation gap rather than presenting a speculative patch as proven.
A working brief to copy
Help reproduce [ISSUE REPORT] in [AFFECTED VERSION AND ENVIRONMENT]. Use [EXPECTED BEHAVIOR], [ACTION SEQUENCE], and [INPUT FIXTURE]. First separate observed facts from suspected causes, then identify missing reproduction details. Trace only the relevant execution path and suggest a minimal case that still fails before changing code. After the failure is confirmed, propose a focused patch and one neighboring verification case. Record the exact commands and actual results; do not claim reproduction or success from code inspection alone.
Tool context and original sources
This is an editorial task plan using the products’ published positioning, rather than a record of controlled product testing. The steps describe a trial for you to run. Confirm current access and terms, and review each tool’s limitations.
- Cursor official website ↗ — Work with AI assistance inside an editor built around your codebase. Profile and source-check notes →
- GitHub Copilot official website ↗ — Bring code assistance into supported editors and GitHub workflows. Profile and source-check notes →
- Cline official website ↗ — Use an open-source coding agent to inspect projects, edit files and run developer commands. Profile and source-check notes →
