Remix.run Logo
▲ dabinat 21 hours ago

> developers could barely be bothered to write comments before (which in the AI age are free

I consider the comments AI writes to be far worse than the code. I am rewriting them a lot more often than I rewrite the actual code. They are overly wordy and include a lot of unnecessary asides that make it sound like a LinkedIn post. Or it will reference specific irrelevant things in the prompt that won’t matter when someone looks at it 6 months from now.

▲CharlieDigital 2 hours ago | parent [-]

That purely depends on how you write comments.

Things that are really useful in comments:

    - URLS to llms.txt or other authoritative docs so agents see it, read it
    - Related entities that may require multiple hops to deduce; you can short circuit the agents read by directly pointing your comment to a related entity that may not show up directly in the call path (e.g. separated by a message queue)
    - Reasoning and "why" a decision was made so in a future pass, an agent understands why a condition or rule exists
You can write bad comments, but you can now just prompt/instruct your agents to write good comments and use it as long-term memory.