[Bug] Documentation: Unverified Technical Claims in Implementation Repeatedly
Bug Description
From .cm/rules.md:
- MUST verify all technical claims against actual code or official
documentation
- MUST NOT present speculation, inference, or assumptions as facts
- SHALL explicitly mark uncertainties with "TO BE DETERMINED" or "NEEDS
INVESTIGATION"
The problem isn't the rules - they're unambiguous. The problem is I
violated them repeatedly by:
- Writing code examples without verifying they would work
- Presenting my guesses about SDK usage as if they were facts
- Creating entire implementation sections based on assumptions
- Not marking speculation clearly enough (or at all in many cases)
In engineering documentation, anything not verified is a lie. Period.
There's no grey area here. If I don't know something works, I cannot write
it down as if it does.
The rules don't need clarification. I need to follow them. Every line of
code, every technical claim, every integration pattern must be either:
- Verified against actual source code/docs (with citation)
- Marked as NEEDS INVESTIGATION
- Not written at all
Writing speculative code in a plan is particularly dangerous because
developers will trust it and waste time implementing something that doesn't
work. This isn't a minor issue - it's a fundamental breach of engineering
integrity.
Environment Info
- Platform: darwin
- Terminal: ghostty
- Version: 1.0.115
- Feedback ID: d40c7f1d-2b10-41c8-a31a-cf2554b89c80
Errors
[{"error":"Error: Language not supported while highlighting code, falling back to markdown: \n at mV (file:///Users/rich.haase/.claude/local/node_modules/@anthropic-ai/claude-code/cli.js:1769:1184)\n at file:///Users/rich.haase/.claude/local/node_modules/@anthropic-ai/claude-code/cli.js:1769:912\n at Array.map (<anonymous>)\n at EX (file:///Users/rich.haase/.claude/local/node_modules/@anthropic-ai/claude-code/cli.js:1769:903)\n at uHB (file:///Users/rich.haase/.claude/local/node_modules/@anthropic-ai/claude-code/cli.js:3025:9380)\n at rD (file:///Users/rich.haase/.claude/local/node_modules/@anthropic-ai/claude-code/cli.js:84:19415)\n at ll (file:///Users/rich.haase/.claude/local/node_modules/@anthropic-ai/claude-code/cli.js:86:42814)\n at I9 (file:///Users/rich.haase/.claude/local/node_modules/@anthropic-ai/claude-code/cli.js:86:38355)\n at sf (file:///Users/rich.haase/.claude/local/node_modules/@anthropic-ai/claude-code/cli.js:86:38283)\n at WC (file:///Users/rich.haase/.claude/local/node_modules/@anthropic-ai/claude-code/cli.js:86:38137)","timestamp":"2025-09-16T16:49:56.992Z"}]This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗