Adding t_wada's commenting principles to AGENTS.md slashed noisy AI code comments
4310sy · x · 2026-10-07
tagucch shares that after adding twada's well-known principles to his AGENTS.md — "code explains How, tests explain What, commit logs explain Why, comments explain Why (not What), and nothing else" — his AI coding assistant almost stopped generating unnecessary code comments. A simple, practical rule set for taming AI coding agents.
More from coding & agent
- Pre-registered study: selection beats extraction in agent memory, 3061x cheaper to write — Rishabh Sharma · 2026-10-07
- Cursor iOS app adds remote control for local coding agents, on by default — tetsuoai · 2026-10-07
- Claude Code v2.1.292 adds effort-level control for subagents — lydiahallie · 2026-10-07
- 100B decisions in 5 minutes: a layered agent pipeline where Opus only probes 96 hotspots — Arindam_1729 · 2026-10-07
- requarks-wiki-mcp: 29-Tool MCP Server Lets AI Agents Query Wiki.js Knowledge Bases — modelcontextprotocol · 2026-10-07
- Cursor's Origin API ships four breaking changes, email fields now scope-gated — tetsuoai · 2026-10-07