The interesting shift here isn’t “AI needs better docs”, but that docs start behaving like build input. Once agents are in the loop, ambiguity isn’t just inconvenient but becomes a failure mode.