elixir-root-cause-only

Trace Elixir runtime errors through a four-phase reproduce, trace, fix, and verify workflow.

10|2|Updated Oct 24, 2025
One-click install
npx skills add https://github.com/mkreyman/bmad-elixir --skill elixir-root-cause-only
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: elixir-root-cause-only
Source: https://github.com/mkreyman/bmad-elixir/tree/main/priv/skills/elixir-root-cause-only
Command: npx skills add https://github.com/mkreyman/bmad-elixir --skill elixir-root-cause-only

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill mandates systematic debugging to trace issues to their root cause, avoiding quick symptom fixes and random changes.

Core Features & Use Cases

  • Four-Phase Debugging: Reproduce, Trace, Fix, Verify with strict steps.
  • Root Cause First: Ensures fixes address the actual problem rather than symptoms.
  • Documentation of Fixes: Clear notes on where and why a change was made.

Quick Start

When an error occurs, follow Phase 1: Reproduce, Phase 2: Trace, Phase 3: Fix, Phase 4: Verify as outlined in the skill.

Frequently Asked Questions about elixir-root-cause-only

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

FAQPage Schema
How do I trace root causes in Elixir when my code fails at runtime?

Root-cause tracing in Elixir involves systematically reproducing the error, inspecting stack traces and execution flow to identify where the actual problem originates, then fixing only that root issue rather than masking symptoms. This Skill guides you through a four-phase workflow: Reproduce the issue reliably, Trace execution to pinpoint the source, apply a single Fix, and Verify the solution works.

Why should I avoid quick patches when debugging Elixir errors?

Quick patches treat symptoms rather than underlying causes, creating technical debt and recurring failures. Systematic root-cause debugging in Elixir prevents random code changes by enforcing reproducible steps, documented diagnosis, and verified minimal fixes that address the actual problem, saving time and code quality.

What's the best way to debug undefined-function errors in Elixir projects?

Undefined-function errors in Elixir require tracing the call stack and module dependencies to find where the function should be defined or imported. A structured debugging approach reproduces the error with exact steps, traces execution paths, identifies the root cause in module structure or imports, and applies a verified fix.

How do I verify that my Elixir bug fix actually solves the root problem?

Verification in Elixir debugging confirms your fix resolves the original error without introducing new ones. Execute your reproduction steps against the corrected code, run relevant tests, and document the root cause and fix location to prevent symptom recurrence and ensure the solution is minimal and complete.

Can I use a systematic debugging approach for failing Elixir tests?

Yes. Failing tests in Elixir benefit from root-cause tracing: reproduce the test failure with exact inputs, trace test execution and assertions to find where expectations diverge from actual behavior, fix only the root cause in your code, and verify the test passes alongside related tests.

What documentation should I keep when fixing Elixir bugs?

Document the root cause you discovered, the module and line where you made the change, the reason for that specific fix, and verification results showing the error no longer occurs. This record prevents re-introducing the bug and helps teammates understand why the fix was necessary.