debug-helper

Automate cross-stack debugging workflows for Angular, NestJS, and Nx build issues.

1|Updated Sep 15, 2023
One-click install
npx skills add https://github.com/emiljuchnikowski/smartsoft001 --skill debug-helper-emiljuchnikowski
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug-helper
Source: https://github.com/emiljuchnikowski/smartsoft001/tree/main/.claude/skills/debug-helper
Command: npx skills add https://github.com/emiljuchnikowski/smartsoft001 --skill debug-helper-emiljuchnikowski

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Cross-stack debugging workflows for Angular, NestJS, and Nx build issues, helping teams quickly identify and fix root causes across multiple frameworks.

Core Features & Use Cases

  • Common debug scenarios span builds, tests, and dependency analysis across Angular, NestJS, and Nx monorepos.
  • Build Failures: identify TypeScript compilation errors, inspect the build pipeline, and isolate the failing project or step.
  • Test Failures: run targeted tests with verbose output to reproduce failures and locate flakey tests.
  • Dependency Issues: analyze dependency graphs, verify versions, detect duplicates, and resolve conflicts.
  • Nx Cache Issues: clear or bypass the Nx cache to validate reproducibility and speed up debugging.
  • Angular & NestJS Debugging: verify module imports, DI tokens, provider configuration, and integration points for cross-stack fixes.
  • Use Case: In a monorepo with multiple apps, use this workflow to trace a failure from a top-level command down to the specific package and file.

Quick Start

Describe the failure and involved stack to generate a guided debugging plan.

Frequently Asked Questions about debug-helper

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

FAQPage Schema
How do I debug build failures across Angular, NestJS, and Nx monorepos?

Debugging cross-stack build failures involves inspecting the build pipeline, isolating the failing project or step, and identifying TypeScript compilation errors across Angular, NestJS, and Nx environments to pinpoint root causes.

What is the best way to trace a top-level command failure down to a specific package in an Nx monorepo?

Tracing a top-level command failure to a specific package requires a structured workflow that isolates the failing step and analyzes the dependency graph within the Nx monorepo to locate the exact file and root cause.

How do I resolve dependency conflicts and duplicates in an Angular and NestJS monorepo?

Resolving dependency conflicts involves analyzing the dependency graph, verifying package versions, detecting duplicates, and resolving conflicts across the Angular and NestJS stack to ensure stable builds.

Why are my Nx cache issues causing non-reproducible build failures?

Nx cache issues cause non-reproducible build failures when cached outputs are corrupted or stale. Clearing or bypassing the Nx cache validates reproducibility and speeds up the debugging process.

Can I use this workflow to locate flaky tests and run targeted tests with verbose output in NestJS?

Yes, the workflow supports running targeted tests with verbose output in NestJS to reproduce failures and locate flaky tests, ensuring failures are documented and reproducible across the stack.

How do I verify module imports and provider configuration for cross-stack fixes in Angular?

Verifying module imports, DI tokens, and provider configuration in Angular is required to identify integration points and apply targeted cross-stack fixes across the monorepo environment.