← ClaudeAtlas

bug-reportlisted

Write a bug report someone can act on, and file it to whatever tracker the project uses. Use when a test fails for a real reason, when exploring turns something up, or when the user says file a bug, raise a ticket, or report this.
eduramos21/qa-automation-framework · ★ 0 · Data & Documents · score 66
Install: claude install-skill eduramos21/qa-automation-framework
# Report a bug A bug report has one job: get the defect fixed with the fewest round trips. Every round trip costs a day. Most of what makes a report bad is the reporter knowing something and not writing it down. ## Steps **1. Reproduce it.** From a clean state, following your own steps. If you cannot, say so in the report and say how many times you tried. An intermittent bug is still worth filing, but it has to be labelled as one or someone will close it as not reproducible. **2. Narrow it.** Cut every step that is not needed. Ten steps become four. Then ask which is the real variable: does it happen with a different account, a different browser, a different amount? The answer usually points at the cause and saves the developer the search. **3. Check it is new.** Search the tracker before filing. A duplicate splits the discussion across two tickets. **4. Work out what it costs.** Not how annoying it is. How many users, how often, what happens if it ships, and whether there is a workaround. That is what someone prioritises on. **5. Write it.** Shape below. **6. File it.** Per `tracker` in `qa.config.yml`: - `jira`: create the issue with the Atlassian tools, in `tracker.project_key`. - `github-issues`: `gh issue create`. - `none`: write it to a file and tell the user where. Attach what you have: screenshot, trace, video, the failing test output, the network log if the failure is a request. ## Shape ```markdown # <One line. What is wrong, where. Not "checkout broken"