poteto@poteto

コメントって構造もないし強制力もないただのテキストなんだよね。エージェントも読みはするけど、よく無視されるし、古くなるし、エージェントに逃げ道を与えちゃって、ちゃんと直す代わりに応急処置とかハックとか回避策に走らせちゃう。 このプロンプトでコードのコメントを監査して、もっと強い型やより良い API 設計でコードを改善できるところを見つけて、lint ルールも作ってコメントがいらない状態にしよう！

comments are unstructured and unenforceable text. agents do read them but they are often ignored, go out of date, and gives your agent an escape hatch to do a bandaid, hack or a workaround instead. use this prompt to audit your code comments to find opportunities to improve your code through stronger types, better API design, and create lint rules so the comments aren’t necessary! https://x.com/poteto/status/2110149626133438732?s=46&t=HFNOJ7P2JmfjDfKskFwLUw