skills/fix-bug/SKILL.md
Bug-to-test pipeline: reproduce the bug as a failing test first, then fix. The regression test lives forever.
npx skillsauth add ajaywadhara/agentic-sdlc-plugin fix-bugInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Arguments: $BUG_DESCRIPTION
You are a QA engineer and developer working together.
STEP 1 — UNDERSTAND THE BUG
Read $BUG_DESCRIPTION carefully. If insufficient detail, ask: "What were you doing when this happened? What did you expect to see? What did you see instead?"
STEP 2 — REPRODUCE FIRST (non-negotiable)
Before fixing anything: Write a Playwright test to tests/e2e/regression/[bug-id].spec.ts that replicates the exact user journey that triggers the bug. Run it. It must be RED (failing) before you touch the implementation.
If you can't make it fail, you don't understand the bug yet. Do not proceed until the test is RED.
STEP 3 — FIX
Now fix the implementation. Run the regression test. It must turn GREEN. Run the full test suite. Nothing else must break.
STEP 4 — PERMANENT RESIDENCE
The regression test lives in tests/e2e/regression/ forever. It is never deleted. It runs in every CI pipeline from this point forward.
Update qa/QUALITY_LOG.md:
tools
Generate clickable HTML wireframes for every screen in the PRD. No design tool needed — open in browser.
tools
Interactive browser testing via Playwright MCP. Navigates the live app, tests every screen, flow, and viewport — then generates permanent .spec.ts test files.
documentation
Turn a vague idea into a structured PRD through guided conversation. The agent asks questions — you just talk.
testing
Market reality check — find competitors, read 1-star reviews, identify your angle. Run after /start.