Picture this: you write a requirement. Clear, specific. The agent reads it, does exactly what you wrote — and breaks three things you never mentioned.
Not because the agent is bad at its job. Because the spec was written for a human reader, not a machine.
Human developers tolerate ambiguity. They fill gaps from experience. They ask before doing something irreversible. AI agents don't work that way — they fill gaps with whatever their training data suggests. Sometimes that's fine. Sometimes it destroys an afternoon.
After hitting this wall enough times, I stopped trying to write better prompts and started thinking about the spec format itself.
The real problem: spec formats haven't evolved
