Probably good to establish canonical spec documents up front that it can use and maintain as an independent reference?

That doesn't solve the problem of it hallucinating more design details and putting them in comments. The solution to too much authoritative documentation isn't more authoritative documentation.

▲

pc86 6 hours ago | parent [-]

Comments exist for humans to understand the why of the code, including perhaps external dependencies/assumptions/requirements.

LLMs inserting code comments makes zero sense by definition.

	▲	pavlov 5 hours ago \| parent [-]
		That’s not true because LLMs clearly benefit from having multiple statements representing aspects of the same thing. That’s why they’re always doing the “it’s not X, it’s Y” kind of patterns. It’s reinforcement.

▲

lupire 8 hours ago | parent | prev [-]

Doesn't need to be "up front", but you do need to curate the context.

AI can't read your mind, and it will read what you (or anyone else) wrote.

	▲	Sharlin 7 hours ago \| parent \| next [-]
		Humans can’t read minds either, but most humans aren’t so dumb as to forget what is a normative spec and what is just their own current, evolving model of the problem space. (Though some humans certainly are…)
	▲	pydry 8 hours ago \| parent \| prev [-]
		It can't but it will try and getting it to stop is often infeasible.