karvey-investigatelisted

# Karvey Investigate — Root-Cause Analysis ## Purpose A **cross-cutting** skill of the Karvey Method: a debugging and root-cause-analysis support layer (the Debugger role, inspired by gstack `/investigate`). **It is NOT a phase of the linear pipeline**: it does not modify `spec.json:phase` nor advance the phase flow. It is invoked any time a symptom, bug or unexpected behavior shows up, and when it finishes the pipeline continues exactly where it was. **Iron Law:** NEVER apply fixes without first investigating the root cause. The investigation produces evidence and a recommendation; the fix is applied by `karvey-impl`, respecting the corresponding gates. It is **stack-agnostic**: it uses the target's real runtime (see `karvey/rules/targets.md`), whether it's Python/Azure Functions, Vue, SQL Server, Node-RED, Asterisk, etc. ## Steps 1. **Capture the exact symptom and how to reproduce it.** - Write down the observed behavior vs. the expected one, the literal error message, stack trace, exit code, and the minimal steps to reproduce. - If there is no reliable repro, get one before continuing. Without a repro there is no serious investigation. 2. **Trace the data flow / relevant code path.** - Use Grep/Glob to locate the entry point and follow the data flow down to the symptom. - Read (Read) the files involved end to end along the path: input → transformations → output. - Identify the boundaries (SP calls, webhooks, external APIs, queues/events) where the dat