BugBlitz Β· Workshop Materials

Workshop Recap

Goals, debugging mindset, AI prompting tips, and release day perspectives to support your team during the exercise.

Workshop Goals

By the end of the hour, you'll have practiced four things that actually matter on release day.

πŸ’ͺ

Confidence Building

Walk into your next launch day knowing you have a repeatable playbook for the moment things break.

🀝

Teamwork & Communication

Bring different release day perspectives into the discussion, share context, and land at a decision the whole War Room can back.

🎯

Triage Mastery

Sort a pile of incoming bug reports into severity levels and effort levelsβ€” quickly, and with reasoning you can defend.

πŸ› οΈ

Debugging & DevTools

Practice using the browser Console, Elements, and Network tabs (plus AI as a debugging partner) to isolate root causes fast.

Bug-Busting Mindset

Bugs on release day come with the territory. A calm War Room isn't one where nothing broke β€” it's one that knows how to react. Three pillars carry that.

Pillar 1

Psychological Safety

Reward Curiosity

Respond together, not with blame or panic. Surface what's broken and share context.

Pillar 2

Strategic Triage & Trade-Offs

Functional over Flawless

Weigh impact against effort. Resolve true release blockers now; defer the rest.

Pillar 3

Leveraging Your Voice

Own Your Reasoning

Back your decisions with clear rationale. Make sure your reasoning is visible, not just assumed.

True success is getting a different console error than before.

Bug Severity Levels

Severity describes how badly a bug affects the product. Priority describes how urgently your team should address it. Use severity alongside customer impact, available workarounds, and release timing to choose a priority: P1 (High), P2 (Medium), or P3 (Low).

Workaround vs. root-cause fix β€” pick on purpose. A workaround shrinks the blast radius today (a feature flag, a hidden button, a "we know" banner). A root-cause fix removes the bug for good but takes longer to land.
Critical

Blocker β€” Feature Completely Broken

No workaround exists. Prevents a primary user flow. Causes severe loss of revenue, data loss, security vulnerabilities, or widespread app crashes.

Example impact: Users can't check out, the cart total is wrong by orders of magnitude, or the app crashes on load.
Major

Behavioral β€” Badly Frustrating UX

A workaround exists but causes highly frustrating user experience. Frustrated users can still eventually check out, but something important is clearly wrong.

Example impact: The cart doesn't update correctly, a promotional code fails to apply, or a form rejects valid input.
Minor

Cosmetic β€” Polish & Alignment

Typographical errors or minor alignment issues with negligible impact. The app functions correctly but looks less polished. Users can still shop without friction.

Example impact: A button has the wrong shade of color, a label has a typo, or icons are slightly misaligned.

Bug Categories

The Bug Report contains a variety of issue types. Each requires different debugging tools and approaches.

🎨

Visual / CSS

Layout breaks, z-index conflicts, pop-ups that won't close, mobile responsiveness issues.

πŸ”’

Logic & Calculation

Incorrect totals, wrong price references, off-by-one errors, string math instead of number math.

πŸ“‹

Form Validation

Overly strict regex, stale state carried between selections, generic error messages that don't help the user.

πŸ—„οΈ

Database / Data

Incorrect data references, sale prices not honored, data fetching errors.

πŸ–±οΈ

Interaction & State

Buttons not responding, double-click registering twice, sold-out items silently added to cart.

πŸ“±

Device-Specific

Touch targets too small on mobile, scroll bugs on iOS, viewport-specific rendering issues.

Prompting

AI agents can accelerate your debugging β€” but only if you prompt them well. Know where they shine and where they need a push, then use the three-step framework below on every prompt.

AI's strong suits

  • Decoding a cryptic error β€” paste the surrounding code and one sentence about what you were doing; you'll usually get a real lead.
  • Spotting the mechanical stuff: typos, missing semicolons, swapped argument order. Anything a second read would catch.
  • Drafting unit tests once you've told it the behavior you want. Coverage without the boilerplate.

Where AI needs a nudge

  • It can't see your app. Describe what's on screen and what you expected instead β€” vague prompts get vague fixes.
  • Don't accept the first suggestion. Make it defend its logic, then read the diff before you click accept.
  • Feed it the framework, file paths, and data shape β€” otherwise you'll get textbook Angular answers to your very specific bug.

You can't throw a vague request at an agent and expect production-ready code. To get the most out of AI during a high-pressure release, use a three-step framework: Brief, Audit, and Own.

Step 1

Brief the Agent

  • Define your role and the specific issue.
  • Provide full context β€” logs, code, environment.
  • State the current behavior vs. the expected behavior.
Step 2

Audit the Output

  • Don't assume AI is correct β€” watch for hallucinations.
  • Force the agent to defend its logic.
  • Stress-test for missing edge cases.
Step 3

Own the Solution

  • Never just click "Accept."
  • Ask for step-by-step breakdowns.
  • Cross-reference with reputable documentation.

Release Day Stakeholders & Bug Reporters

A release day War Room brings together people with different responsibilities. These stakeholders bring different perspectives to triage, fixes, and launch decisions.

Software Engineer / Developer
The builder, the fixer, and the realist.

Engineers investigate errors, read stack traces, and write fixes. They assess technical risk and estimate how much work a fix will take.

Focus
Technical health of the app, state management, errors in the console, and writing the actual fix.
Product Owner / Product Manager
The voice of the business and the customer.

Product managers connect bugs to customer experience and business impact. They help the team prioritize issues that affect revenue, conversion, and trust.

Focus
Business impact, customer experience, and how the bug makes the company look.
Design
The voice of usability and a clear, consistent experience.

Designers spot confusing interactions, layout problems, and barriers to using the product. They help the team assess whether a fix works across screen sizes and input methods.

Focus
Usability, visual hierarchy, accessibility, and interaction consistency.
People Leader / Engineering Manager
The shield, the translator, and the resource allocator.

Engineering managers protect the team from unnecessary panic, keep work scoped, and make sure the right people work on the right issues.

Focus
Team capacity, project prioritization, and shielding engineers so they can actually focus on debugging.
QA Tester
The gatekeeper of quality and the customer advocate.

QA testers reproduce issues, identify edge cases, and verify fixes. They check for regressions and help the team assess whether the release is ready.

Focus
Identifying edge cases, ensuring the fix doesn't create new bugs, and validating from the user's perspective.
Leadership / Director
The big picture and the bottom line.

Leaders weigh release timing, business risk, and customer impact. They need clear status updates to support launch decisions and communicate with stakeholders.

Focus
Revenue impact, brand risk, and high-level status updates for stakeholders.
Customer Support
The frontline voice, calming the waters.

Customer support brings reports from affected customers into the release day conversation. They collect details engineering needs, spot patterns across tickets, and keep customers informed while a fix is on its way.

Focus
Triaging incoming customer-reported issues, surfacing patterns to engineering, and keeping affected customers informed while a fix lands.

Hints for Success

πŸ“
Document clearly. Write down what you found, how you found it, and your fix. Collaborative notes help the whole team.
🀝
Collaborate often. Share your screen, pair up, and talk through problems. Two perspectives catch more than one.
πŸƒ
Reach for the guide. Stuck? Check the Bug Report for reproduction steps and Brief Β· Audit Β· Own for prompting AI.
πŸ”
Use DevTools. The Console, Network tab, and Elements inspector are your best friends. Check for errors, failed requests, and DOM state.
πŸ†
Own the solution. Don't just fix it β€” understand why it broke and explain your reasoning to your teammates.
πŸ’‘
Advocate with intent. Practice justifying technical decisions and driving team priorities with the perspectives of the release day team in mind.