Stop Guessing — Development skill for Claude Code
Debugging discipline for coding agents: reproduce, localize, evidence, minimal fix, verify.
How to install Stop Guessing
This entry records only its repository, not the path inside it, so there is no
exact command to give. Open cv-superding/stop-guessing and copy the folder into
~/.claude/skills/, or the file into ~/.claude/agents/.
What Stop Guessing does
Debugging discipline for coding agents: reproduce, localize, evidence, minimal fix, verify. Never edit code to see if it helps.
Alternatives in Development
- Discipline — Toggle discipline mode — auto-invoke verification, brainstorming-before-coding, and review checks 2.8k ★
- AWorld — Search, understand, reproduce, and improve an idea with ease 1.2k ★
- Academic Pptx Skill — A Claude Skill for creating academic presentations (conference talks, seminar slides, thesis defenses, grant b 811 ★
README
English · 简体中文
你的 agent 从来不读报错信息。这个技能让它读。
一个给编程 agent 用的调试纪律技能,用固定流程替换 **"大概是 X 吧,我改一下试试"**:复现 → 定位 → 证据 → 最小修复 → 验证。加载这个技能后,agent 不能再把一个猜的修法叠在另一个猜的修法上面——必须先给你看证据。
兼容所有支持 [Agent Skills](https://agentskills.io) 的 agent:Claude Code、Codex CLI、Cursor、Gemini CLI、OpenCode 等。
纪律,画成一张图
上图由 [Archify](https://github.com/tt-a1i/archify) 生成——在浏览器中打开 [`docs/stop-guessing-diagram.html`](docs/stop-guessing-diagram.html) 可查看交互版(缩放、路径追踪、暗色主题)。
问题
让 agent 修一个 bug,通常会看到这样的对话:
**Agent:** 啊,这大概是因为环境变量没加载。*(加了 `dotenv.config()`)* 我再顺手加个空值检查以防万一。*(又改了一处)* 现在应该可以了。
没有复现、没有证据、两次修改之间什么都没运行
Related Skills
Accuracy Verify Claims
Accuracy-scout step 3 — run minimal examples to reproduce issue claims (if applicable)
Shared Rules
Portable Claude Code rules, installed as a plugin into ~/.claude/rules: pre-register tests, check hand-offs, v
ClaudPer
ClaudPer v4: zero-hallucination, self-correction and token-saving skill for Claude Code - asks instead of gues
Evidence Verify Gate
You are auditing a proposed skill edit for cluster 0. The edit was inferred from a cluster of FAILING agent tr
Architect Verify
Run the independent verification stage in a fresh context. Re-derives every evidence pointer. Never edits the
GPU
Diagnose GPU health, discover bounded recipes, and collect typed numeric evidence without guessing from screen
Related Agents
Al Triage
Reactive support for EXISTING Business Central AL code — reproduce, localize, root-cause, and recommend a mini
Part 19: Repowise — Codebase Intelligence For Coding Agents
60% fewer tokens. 4x faster. Your coding agents stop guessing and start knowing. ---
Bug Fix
Use when diagnosing and fixing a bug. Chains reproduce → isolate → hypothesize → fix → verify → learn with hum