Trace NestJS layers to diagnose zoppy-api bugs and runtime failures.
npx skills add https://github.com/Zoppy-crm/.github --skill root-cause-zoppy-crm
Please help me install this Agent Skill. Skill: root-cause Source: https://github.com/Zoppy-crm/.github/tree/main/skills/backend/root-cause Command: npx skills add https://github.com/Zoppy-crm/.github --skill root-cause-zoppy-crm
Provides a deterministic, layer-by-layer methodology to find the root cause of errors, failing tests, unexpected behavior, permission failures, and stalled queue jobs in the zoppy-api NestJS codebase so engineers stop guessing and quickly produce actionable fixes.
Investigate the failing endpoint by following the trace path from HTTP controller into application, domain, session, and queue layers and report the root cause, evidence lines, a concrete fix, and a prevention suggestion.
High-intent search queries and answers about installing and using this skill.
Debug stalled NestJS queue processors by inspecting for missing setSession calls and floating Promises in background job handlers. A structured root-cause analysis traces from queue processors through session context to identify where silent successes or stalled jobs originate.
Unexpected 403 or 401 permission errors in NestJS often stem from wrong guard order or missing session context. Root-cause analysis inspects controllers, session context, and domain layers to produce concrete evidence confirming the exact permission failure trigger.
Troubleshoot empty NestJS Sequelize query results by checking for Sequelize include pitfalls within repository adapters. A systematic trace path inspects application and domain layers to find where query expectations diverge from actual database returns.
Trace incorrect external provider routing in NestJS by inspecting provider strategies and external integrations layer-by-layer. Root-cause analysis follows a stepwise inspection order from controllers through application layers to identify the exact routing divergence.
Yes, this root-cause analysis method applies to failing HTTP endpoints, tests, queue processors, and external integrations. It inspects controllers, application layers, domain layers, and session context to produce reproducible findings and concrete code fixes across all scenarios.
Zoppy-crmOrchestrate validate, persist, and enqueue workflows for zoppy-api Application Services.
Zoppy-crmRegister recurring BullMQ jobs from NestJS modules with cron or interval schedules.
joviconAnalyze NestJS project architecture against Clean Architecture and DDD boundaries.
zenobi-usTrace errors backward through call stacks to identify original triggers.
