Rspack Debugging

What it does

This skill enables AI agents to debug Rspack build configurations and resolve compilation errors within the Rspack ecosystem. It facilitates deep inspection of the bundler's internal state to identify misconfigurations or dependency issues preventing successful builds.

When to use it

• Build Failures: When a project fails to compile due to obscure Rspack configuration syntax errors.
• Dependency Conflicts: To diagnose version mismatches between rspack, plugins, and the underlying webpack ecosystem.
• Performance Bottlenecks: To analyze why specific modules are causing excessive build times or cache invalidation loops.
• Plugin Integration: When custom loaders or plugins fail to initialize correctly during the bundling process.

Key capabilities

• Parses Rspack configuration files (rspack.config.js, webpack.config.js) for syntax and logic errors.
• Simulates build environments to reproduce and isolate specific compilation failures.
• Analyzes error logs generated by the Rspack compiler to pinpoint root causes.
• Suggests corrective actions for plugin compatibility issues.

Example prompts

• "Analyze my rspack.config.js file and explain why the build is failing with a 'module not found' error."
• "Debug this Rspack compilation error log and suggest a fix for the missing dependency."
• "Why is my custom loader not working in Rspack? Check the configuration and provide a corrected version."

Tips & gotchas

Ensure your environment has the correct rspack CLI installed globally or locally before attempting to debug, as the skill relies on accurate tooling versions. This skill is specific to the Rspack bundler; it will not resolve issues related to Vite, Webpack 5 (without Rspack), or other build tools.