debug-stack

Community

Diagnose production failures in minutes

Authormichaelayoade
Version1.0.0
Installs0

System Documentation

What problem does it solve?

It helps you quickly identify why production requests fail or background jobs misbehave by correlating application container logs with the database records and Redis state.

Core Features & Use Cases

  • Docker log triage for root-cause signals: Pinpoint FastAPI tracebacks, Celery task exceptions, and scheduler (beat) scheduling issues by container and time.
  • Database verification of affected entities: Validate whether tickets, subscriber syncs, campaigns, and notification delivery records are stuck in unexpected statuses or contain failure reasons.
  • Redis cache/queue inspection: Detect rate-limiting counters, stale cache TTL problems, and Celery task state/queue backlogs that can amplify or mask app bugs.
  • Cross-reference diagnosis workflow: Combine evidence across Docker, DB, and Redis to produce an actionable root-cause narrative and next steps.

Quick Start

Diagnose a failing issue by asking the AI to guide you through Step 1 Docker log triage, then Step 2 database queries for the impacted IDs and statuses, and finally Step 3 Redis inspection for rate limits, cache freshness, and Celery/task backlog.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: debug-stack
Download link: https://github.com/michaelayoade/dotmac_crm/archive/main.zip#debug-stack

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.