Claude leaves essay-length comments in code — here's how to redirect them to a side file
Birchlabs · x · 2026-08-25
Birchlabs observes that Claude tends to write long comments in code: these are effectively its CoT sequences, or "tombstone" comments explaining diffs during code review — which likely helps the model more than the human reader.
The suggested fix: let it write, but elsewhere. Keep code comments minimal pointers like "guard for obscure case, see service.annex.md for rationale", moving lengthy reasoning into a separate annex file — preserving the model's reasoning benefits without burying the code.
More from coding & agent
- Fine-tune Qwen3.8-27B for free using Kaggle GPUs and Unsloth — danielhanchen · 2026-08-25
- RAG explained with C# implementation guide — adnan_hashmi · 2026-08-25
- Practical tip: set up Tailscale on your Grok bot's computer to cut interruptions by 60-75% — IndraVahan · 2026-08-25
- One person built a 3D fishing game in 4 weeks with Claude Code and Godot for ~$300 — jocarrasqueira · 2026-08-25
- Prime Agent: Open-Source Framework Boosts ARC-AGI Score from 30% to 95.5% — dair_ai · 2026-08-25
- Expert suggests keeping AI coding environment vanilla for better focus — johnowhitaker · 2026-08-25