A Reproducible Prompt Workflow for Multi-File Bug Fixing
This article shares a repeatable prompt workflow for fixing multi-file bugs, including steps for reconnaissance, planning, patching, and verification. It also includes a free tool to generate this type of prompt pack automatically.
Why it matters
This workflow can help engineers tackle complex, multi-file bugs in a more systematic and reproducible way.
Key Points
- 1Multi-file bugs often span boundaries like page templates, global CSS, and content rendering
- 2The workflow includes 4 steps: Recon (understand files involved), Plan (define minimal fix), Patch (scoped edits), Verify (prove it works)
- 3The article includes a real bug scenario and a copy-paste prompt pack example for a low-contrast blog detail page issue
Details
The article discusses the challenges of multi-file bug fixes, where agents often start editing too early and end up with messy, unreviewable changes. It proposes a 4-step workflow - Recon, Plan, Patch, Verify - to address this. The Recon step involves understanding the minimum set of files involved and forming a root-cause hypothesis. The Plan step defines the smallest patch that meets acceptance criteria. The Patch step keeps the diffs auditable by grouping edits by file. The Verify step provides evidence that the fix works through manual checks and quick regressions. The article also includes a real bug scenario and a copy-paste prompt pack example for fixing a low-contrast issue on a blog detail page.
No comments yet
Be the first to comment