← Blog
Product

Prompts are the new specs

Joaquín Soto·May 06, 2026·5 min read

What happens to product documentation when the spec is also the build instruction?

When the document that describes the feature is also the input that builds it, the document stops drifting. Ambiguity is no longer a review comment — it is a wrong screen you can see immediately.

Teams that adapt fastest write prompts the way they used to write acceptance criteria: user, intent, constraints, and the edge case that usually breaks.

The knowledge file becomes the long-lived artefact. Prompts are the diff; knowledge is the state.