debug-session

Diagnose Django bugs from symptom to root cause with regression tests.

Updated Mar 23, 2026
One-click install
npx skills add https://github.com/rafaelcostaf4-afk/SurveyHub --skill debug-session-rafaelcostaf4-afk
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug-session
Source: https://github.com/rafaelcostaf4-afk/SurveyHub/tree/main/.claude/skills/debug-session
Command: npx skills add https://github.com/rafaelcostaf4-afk/SurveyHub --skill debug-session-rafaelcostaf4-afk

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Conduz sessão científica de debug em projeto Django — do sintoma à causa raiz. A abordagem sistemática coleta evidências, formula hipóteses ordenadas por probabilidade, isola o problema ao mínimo reproduzível, identifica a causa raiz real (não o sintoma), aplica a correção preservando o comportamento e cria um teste de regressão. Inclui padrões específicos do SurveyHub: Django FBV, Fat Model, ORM com soft delete, signals, middleware, forms com Bleach, sistema de segurança de surveys, multi-tenancy e RBAC.

Core Features & Use Cases

  • Sessão científica de debug para Django que guia do sintoma até a raiz do problema com evidência organizada.
  • Suporte a diagnóstico de erros comuns, traces, exceções, e falhas de testes com documentação de evidências e hipóteses.
  • Geração de testes de regressão para evitar que o problema volte, mantendo o comportamento existente.

Quick Start

Descreva passo a passo como conduzir uma sessão de debugging para Django, desde a coleta de evidências até a identificação da raiz do problema e a criação de um teste de regressão.

Frequently Asked Questions about debug-session

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

FAQPage Schema
How do I find the root cause of a Django exception using hypothesis-driven debugging?

Hypothesis-driven debugging in Django isolates the root cause by collecting evidence, formulating probability-ordered hypotheses, and reproducing the issue minimally before applying a fix. This structured approach moves from symptom to root cause rather than addressing surface errors.

What is the best way to debug failing Django tests without breaking existing behavior?

Debug failing Django tests by isolating the failure to a minimal reproducible example, identifying the actual root cause, and applying a correction that preserves existing behavior. A regression test is then generated to ensure the specific failure does not reoccur.

How do I systematically debug Django ORM soft delete and signal issues?

Systematic Django debugging handles ORM soft delete and signal issues by collecting error traces as evidence and testing targeted hypotheses. This method ensures the identified root cause reflects the actual systemic failure rather than just the observed symptom.

Does structured debugging work with multi-tenancy and RBAC security patterns in Django?

Structured debugging applies to multi-tenancy and RBAC security patterns in Django by guiding systematic evidence collection and hypothesis testing. It ensures the debugging workflow aligns with specific SurveyHub patterns like Fat Model and middleware to isolate root causes accurately.

When should I use scientific debugging instead of ad-hoc troubleshooting for Django errors?

Use scientific debugging for Django errors when you need to isolate complex issues to a minimal reproducible state and generate regression-proof fixes. It replaces ad-hoc troubleshooting by enforcing a disciplined workflow of ordered hypotheses and evidence collection.