我: 要是让你用英文简洁的表达一条写注释写文档的原则：只说代码现在做了什么，不保留对已弃方案的引用，你会怎么写？我想把它留到最重要的地方。这样后续所有的agent都能避免犯这个犯（这个发生的很频繁！）
Opus:
▎ Comment the code that exists — not the road you didn't take.
▎ Comments and docs state what the current code does and why. Never reference abandoned approaches, earlier iterations, or "rather than X / instead of Y" contrasts with alternatives that aren't in the tree. A later reader never saw the struggle, so that narrative is pure noise — or worse, a mystery reference to code that was deleted.
Opus:
▎ Comment the code that exists — not the road you didn't take.
▎ Comments and docs state what the current code does and why. Never reference abandoned approaches, earlier iterations, or "rather than X / instead of Y" contrasts with alternatives that aren't in the tree. A later reader never saw the struggle, so that narrative is pure noise — or worse, a mystery reference to code that was deleted.
