I think this is the right direction.
A repo is only 'agent ready' if it can answer boring questions up front:
Most of the pain isn't that the agent is clueless. It's that the repo never told it what a safe, valid run actually looks like.
Treating that as a machine-readable contract feels way more useful than hoping the prompt carries all of it.