Skip to content

Debugging guide should add a hard gate before declaring root cause #6

@wtmoose

Description

@wtmoose

Friction

Agents repeatedly declare a root cause and apply fixes without sufficient discriminating evidence or human approval. The current guide mentions getting human approval but doesn't make it a prominent hard gate, leading to the most common failure mode in LLM-assisted debugging: premature root cause declaration followed by speculative fixes.

Suggestion

Add a prominent stop-gate to the debugging guide: "STOP GATE: Before declaring a root cause, you MUST have discriminating evidence that rules out alternative explanations. Before applying a fix, you MUST present the root cause and proposed fix to the human and get explicit approval. Violations of this gate are the #1 failure mode in LLM-assisted debugging."

Affected files

Guides/Core/debugging-guide.md or Policies/debugging-process-rule.md

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions