I thought the agents are mostly self-documenting since they usually write just as much Markdown documentation autonomously as they do code/unit tests, not sure why they would need extra tools here.

▲

mcbuilder 3 hours ago | parent | next [-]

Because of old outdated info that gets left behind, causing confusion for future agents.

	▲	dboreham an hour ago \| parent [-]
		You can tell it to update the docs to be consistent with whatever changed in the code (or whatever is is the authoritative product form). After a while it usually gets with the program and updates the docs automatically. But not always.

▲

dboreham an hour ago | parent | prev [-]

You don't. But as was ever the case before AI most humans don't know to or want to have documentation written. So the tools have workarounds to try to reduce the number of "AI sucks because I told it X and it did Y" posts.