debug-runbook

Map production and staging symptoms to data sources and log queries.

2|Updated Feb 23, 2026
One-click install
npx skills add https://github.com/jonmumm/skills --skill debug-runbook
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug-runbook
Source: https://github.com/jonmumm/skills/tree/main/debug-runbook
Command: npx skills add https://github.com/jonmumm/skills --skill debug-runbook

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Structured debugging for production and staging issues requires a disciplined, symptom-driven approach to quickly identify root causes and shorten MTTR.

Core Features & Use Cases

  • Symptom-first workflow: start from user-visible symptoms and trace to boundaries, data sources, and tools.
  • Data source reference: select appropriate sources (Sentry, PostHog, wrangler logs) to assemble evidence.
  • Reference-guided investigation: leverage references/symptom-map.md for detailed investigation steps and commands.
  • Configuration guidance and Gotchas: check configuration prerequisites and common pitfalls to ensure reliable debugging.

Quick Start

Tail the deployed worker to reproduce the issue and reference the symptom map to guide your investigation.

Frequently Asked Questions about debug-runbook

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

FAQPage Schema
How do I debug production issues using Sentry and wrangler logs?

Debug production issues by starting from user-visible symptoms and mapping them to data sources like Sentry, PostHog, and wrangler logs to assemble evidence and identify root causes. A symptom-map reference guides the investigation steps.

What is symptom-driven debugging for web services and edge workers?

Symptom-driven debugging is a structured approach that traces user-visible symptoms back through system boundaries to data sources and tools. It rapidly identifies root causes in production and staging environments to shorten mean time to resolution.

How do I troubleshoot staging issues with a symptom map?

Troubleshoot staging issues by tailing the deployed worker to reproduce the problem, then referencing the symptom map to select appropriate data sources and log queries for investigation. This workflow ensures disciplined evidence gathering.

Do I need Sentry and PostHog configured before debugging production issues?

You need configured data sources like Sentry and PostHog, access to wrangler and logs, and a symptom-map reference to guide investigation. Checking configuration prerequisites and common pitfalls beforehand ensures reliable debugging sessions.

What's the best way to investigate mobile app production issues?

The best way to investigate mobile app production issues is using a symptom-first workflow that maps user-visible symptoms to appropriate data sources and log queries. This structured approach rapidly identifies root causes across web services and mobile apps.

Why does my debugging workflow fail to identify root causes in edge workers?

Debugging workflows fail when they lack a structured symptom-map reference or misconfigure data sources like Sentry and PostHog. Checking configuration prerequisites and common pitfalls ensures reliable evidence assembly for edge worker troubleshooting.