
poteto@poteto
los comentarios son texto sin estructura y que no se puede hacer cumplir. los agentes sí los leen, pero muchas veces los ignoran, se quedan desactualizados y le dan a tu agente una salida fácil para meter un parche, un hack o un workaround en vez de arreglarlo bien. usa este prompt para auditar los comentarios de tu código, encontrar oportunidades de mejorarlo con tipos más fuertes y mejor diseño de API, y crear reglas de lint para que los comentarios ya no hagan falta!
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