{"slug": "stop-asking-ai-coding-agents-to-fix-vague-bugs", "title": "Stop Asking AI Coding Agents to Fix Vague Bugs", "summary": "A developer warns that AI coding agents often produce confident but wrong patches when given vague bug reports like 'The upload sometimes fails. Please fix it.' The developer recommends capturing exact errors, environment details, and minimal reproduction steps before handing off to an agent, and provides a free MIT-licensed Bug Reproduction Brief workflow to standardize the process.", "body_md": "A coding agent can produce a confident patch for the wrong problem when the input is only:\n\nThe upload sometimes fails. Please fix it.\n\nThat sentence does not identify the smallest failing input, exact error, environment, expected result, frequency, or even whether the reporter reproduced it personally.\n\nIf the first instruction is “fix it”, the agent has room to turn a suspected cause into a fictional fact. The safer sequence is:\n\nCapture the exact error, status code, incorrect output, affected route or command, timestamp, and smallest known input.\n\nRemove secrets and personal data before putting logs into an agent context. If the report came from another person and you have not reproduced it, label it as second-hand rather than silently upgrading it to fact.\n\nWeak:\n\n```\nCSV imports are broken.\n```\n\nUseful:\n\n```\nAt 14:22 UTC, POST /imports returned HTTP 500 for minimal.csv.\nResponse: \"column index out of range\".\nThe same account can import one-column.csv successfully.\n```\n\nInspect rather than guess:\n\nDo not infer production configuration from your laptop. Environment differences are often part of the bug.\n\nWrite two observable statements:\n\n```\nExpected: POST /imports accepts the smallest valid two-column CSV and returns HTTP 201.\nActual:   The same fixture returns HTTP 500 with \"column index out of range\".\n```\n\nNeither statement should include the suspected root cause.\n\n“Expected: parser handles the off-by-one bug” already assumes the diagnosis. You have not earned that conclusion yet.\n\nStart with the reported path. Remove unrelated records, services, fields, and steps one at a time.\n\nKeep the smallest fixture that still fails. When removing one condition stops the failure, restore it and record the boundary.\n\nUseful reductions include:\n\nDo not mutate production data merely to make reproduction convenient.\n\nRun the minimal case at least twice where safe.\n\nIf it fails two times out of ten, report `2/10 over 90 seconds`\n\n. Do not call it deterministic. Frequency and duration are evidence too.\n\nA useful handoff looks like this:\n\n```\n# Bug Reproduction Brief\n- Target and commit:\n- Environment:\n- Expected:\n- Actual:\n- Minimal steps:\n- Minimal fixture:\n- Reproduced: yes / no / intermittent\n- Evidence:\n- Unknowns:\n- Safe next hypothesis to test:\n```\n\nA verified reproduction is a stable contract for the next step. Now the agent can inspect the responsible code, rank hypotheses, create a failing regression test, apply the smallest fix, and prove that the fixture passes.\n\nWithout that contract, a green test may only prove that the agent tested its own assumption.\n\nThe MIT-licensed Bug Reproduction Brief is public and readable before installation:\n\n```\nnpx skills add skyestrela/ai-agent-skill-preview \\\n  --skill bug-reproduction-brief --agent codex --global --yes --copy\n```\n\nSource and three other free engineering workflows:\n\nThe full Markdown workflow can also be read directly:\n\nIf you want the wider engineering set, the £19 AI Agent Skills Pack contains ten editable workflows for review, debugging, TDD, security, APIs, migrations, deployment, refactoring, PR shipping, and incident analysis:\n\nThe free workflow is complete on its own. The paid pack is optional, sold once with no subscription.", "url": "https://wpnews.pro/news/stop-asking-ai-coding-agents-to-fix-vague-bugs", "canonical_source": "https://dev.to/skyestrela/stop-asking-ai-coding-agents-to-fix-vague-bugs-4ji6", "published_at": "2026-07-25 15:34:38+00:00", "updated_at": "2026-07-25 16:02:04.476589+00:00", "lang": "en", "topics": ["ai-agents", "developer-tools", "ai-tools"], "entities": ["Skye Strela"], "alternates": {"html": "https://wpnews.pro/news/stop-asking-ai-coding-agents-to-fix-vague-bugs", "markdown": "https://wpnews.pro/news/stop-asking-ai-coding-agents-to-fix-vague-bugs.md", "text": "https://wpnews.pro/news/stop-asking-ai-coding-agents-to-fix-vague-bugs.txt", "jsonld": "https://wpnews.pro/news/stop-asking-ai-coding-agents-to-fix-vague-bugs.jsonld"}}