skills.rest
richardthe3rd
richardthe3rdCOMMUNITY
Explore all skills by this author →
GitHub

debugging-playbook

Triage recurring Flutter app bugs with symptom-to-fix guidance.

2|3|Updated Nov 28, 2025
Search Tags:#debugging#flutter#widget testing#bug triage#cache debugging#ci troubleshooting#web crash fixes
One-click install
npx skills add https://github.com/richardthe3rd/cambridge-beer-festival-app --skill debugging-playbook-richardthe3rd
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: debugging-playbook
Source: https://github.com/richardthe3rd/cambridge-beer-festival-app/tree/main/.claude/skills/debugging-playbook
Command: npx skills add https://github.com/richardthe3rd/cambridge-beer-festival-app --skill debugging-playbook-richardthe3rd

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates hours of wasted time debugging recurring, known failure modes in the Cambridge Beer Festival Flutter app by providing pre-verified symptom-to-fix guidance instead of requiring you to start every investigation from scratch.

Core Features & Use Cases

  • Symptom triage table: Covers common bugs including state management issues, cache/offline staleness, web release crashes, widget test failures, CI pipeline errors, and Cloudflare worker API errors, each with a likely cause, quick discriminating experiment, and proven fix pattern.
  • Dead-end trap list: Documents previously tried, rejected fixes to save you from repeating past mistakes that waste review cycles.
  • Cross-skill references: Links to related skills for deeper investigation, such as full incident history, diagnostic tooling workflows, and change control processes.
  • Use Case: If your app shows stale drinks after switching festivals, or web release builds crash with a "Null check operator" error, use this playbook to find the exact root cause and fix in minutes instead of hours of manual debugging.

Quick Start

Use the debugging-playbook skill to look up your app bug symptom in the triage table, run the listed discriminating experiment, and apply the provided fix pattern to resolve the issue.

Frequently Asked Questions about debugging-playbook

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
Why does my Flutter web release build crash with a Null check operator error?▼

A Null check operator error during Flutter web release builds is a known failure mode. This debugging playbook provides a pre-verified root cause hypothesis and a targeted fix pattern to resolve the crash quickly.

How do I fix stale drinks data showing after switching festivals in my Flutter app?▼

Stale data after switching festivals indicates a cache or offline staleness bug. The playbook's symptom triage table links this to a likely cause and provides a discriminating experiment to confirm the cache issue.

What is the best way to triage widget test failures in a Flutter project?▼

The best way to triage widget test failures is using a symptom-first playbook. It provides pre-verified root causes and discriminating experiments to narrow diagnosis, bypassing hours of manual debugging.

How do I troubleshoot Cloudflare worker API errors in my Flutter app?▼

Troubleshooting Cloudflare worker API errors is handled by looking up the specific symptom in the triage table. The playbook delivers proven fix patterns aligned with project code conventions and historical incident records.

How do I avoid repeating rejected fixes when debugging CI pipeline errors?▼

To avoid repeating rejected fixes for CI pipeline errors, consult the playbook's dead-end trap list. It documents previously tried fixes to save review cycles and prevent wasted debugging time.

Can I use this bug triage process for state management issues in any Flutter app?▼

This bug triage process is specifically tailored for the Cambridge Beer Festival Flutter application. It covers state management bugs with fix patterns aligned to that specific codebase's conventions and historical incidents.

Related Skills

Explore More Software Engineering Skills→
richardthe3rdrichardthe3rd
2

research-frontier

Identify open research problems for the Cambridge Beer Festival Flutter app.

Community
Advanced
janekbaraniewskijanekbaraniewski
160

dev-workflow-improvements

Audit development workflows and synchronize tool configurations across projects.

Community
Intermediate
yash-gargyash-garg

dart-run-static-analysis

Run Dart static analysis and apply automated fixes for code quality issues.

Community
Intermediate
visualityplvisualitypl
4

debug

Analyze logs, SQLite database state, and git history to diagnose software issues.

Official
Intermediate