← Back to Opportunity Radar
GUIDED VALIDATION BRIEF

bug(codegraph): MCP codegraph tool fails on Windows (execFile without shell cannot spawn .cmd shim)

Evidence observed in Gentleman-Programming/gentle-pi, a Coding project.

6 comments0 positive reactions9 days openProject Radar 84
Start free validation sprint4 guided steps · private notes · cloud sync
SOURCE EVIDENCE

Start with what users actually said

Reporter context: Bug Description Pi's MCP tool ( ) spawns with without shell. On Windows the npm global is only / , so Node's without shell throws for bare and for . Repro: → ENOENT on win32, with → ok. Sub-agents therefore get and fall back to grep/find, losing graph intelligence. Steps to Reproduce Windows, Pi MCP call operation or…Excerpted from the public Issue. Read the complete thread before interpreting it.

Read original GitHub Issue ↗
01 · Reliability

Write the problem hypothesis

For [operator], the workflow fails during [condition], forcing [recovery work] and costing [time, money or trust].

You can name one user, one situation and one measurable consequence without proposing a feature.
02 · EVIDENCE INTERVIEW

Interview five affected users

  • Show me the last failure and its logs.
  • What triggered it and how often does it recur?
  • How do you detect it today?
  • What does recovery require?
  • What would a safe failure look like?
At least three people independently describe the same painful workflow with recent examples.
03 · MINIMUM TEST

Run the smallest experiment

Add one narrow guardrail, retry or recovery path around the failing step. Replay three real failure cases and compare recovery time.

The same failure is recovered faster in three real cases without creating a new incident.
04 · DECISION GATE

Make a build decision

  • Build: repeated pain and active commitment
  • Narrow: pain is real but the audience or job differs
  • Stop: weak frequency or no behavioral proof
Do not let GitHub engagement replace direct validation.

Why this brief exists

Information has value only when it changes action. This page turns one public signal into a bounded validation exercise. It is a research aid, not proof of demand, investment advice or a product recommendation.