DEV Community

Cover image for Your AI Wrote the Spec. Why Does the Team Still Disagree on What to Build?
Yura Solovey
Yura Solovey

Posted on

Your AI Wrote the Spec. Why Does the Team Still Disagree on What to Build?

Your AI Wrote the Spec. Why Does the Team Still Disagree on What to Build?

AI is very good at making documents look finished.

Give it meeting notes, a few old documents, a customer request, and a short explanation from a product manager. A few minutes later, there is a PRD. It has a problem statement, goals, user stories, acceptance criteria, edge cases, and sometimes even a list of risks.

Not long ago, preparing that package could take half a week.

That is exactly why it is so easy to feel that the work is already done.

But a well-written specification does not mean the team has agreed on what it is building.

The document looked ready

Consider a fairly ordinary change.

A company wants to change its order-approval rules. The meeting notes say that orders above a certain limit need an additional review. Old documentation says VIP customers have a simplified path. A message from Finance mentions that the limit depends on the contract type.

A product manager asks AI to turn all of that into one specification.

The model produces a perfectly readable rule:

If an order exceeds the approval threshold, block processing until a manager approves it.

Then come the user story, the acceptance criteria, and QA scenarios. The developer sees a clear rule. The tester sees clear conditions. Work begins.

The problem is that the sentence above already contains several decisions nobody actually made.

What is the approval threshold? Is it one limit for everyone, or a separate limit for each contract? Should an order really be blocked, or merely marked for review after processing? Does the rule apply to VIP customers? Who is a manager in this process? What happens if approval does not arrive before the end of the business day?

The AI did not necessarily invent something obviously wrong. It turned incomplete information into coherent language.

And teams are very good at mistaking coherence for a decision.

The problem is not that the model wrote the text

A product specification has never been just text.

Behind it are sources, contradictions, clarifications, agreements, versions, and people who can say: yes, this is what we mean.

When a person writes the document, part of that work often happens naturally. An analyst notices an inconsistency. A product manager goes back to the customer. A developer asks what “block” means. Someone takes ownership of the decision, and the decision stays somewhere in the history of the work.

AI can ask clarifying questions too. But it is also very good at continuing when no one asks it to stop.

The faster it produces polished artifacts, the cheaper it becomes to scale ambiguity.

Before AI, an unclear requirement might have sat in a draft for several days and triggered a discussion. Now the same unclear requirement can become a PRD, a technical design, a Jira ticket, acceptance criteria, and QA scenarios in an hour.

Every document may be internally consistent.

Every document may also be built on an assumption nobody approved.

AI accelerates bad decisions too

At this point, people often say that product managers and analysts will not be replaced because AI does not understand the business. That is too simple.

AI can understand a surprising amount of described business context. It can find relationships across documents, formulate alternatives, surface missing edge cases, and produce a much better first draft than a person staring at a blank page.

But there is a difference between proposing a decision and having the authority to finish one.

The model does not know which of two conflicting requirements the company is willing to postpone. It is not accountable to the customer for a costly interpretation. It does not own the trade-off between speed, risk, revenue, and technical debt.

Sometimes the right response to a requirement is not a specification.

Sometimes the right response is: this needs a decision from the owner of the process.

What becomes the new work of product management

AI removes part of the mechanical work of drafting and structuring.

But that makes the things that used to disappear between meetings more important:

  • which sources are canonical;
  • where requirements conflict;
  • what is a fact and what is an assumption;
  • who has the authority to approve a decision;
  • which artifacts become outdated after a change;
  • under which conditions the team is allowed to start implementation.

This is not bureaucracy for its own sake.

If one rule changes and the Jira ticket, technical design, and QA scenarios remain untouched, the team is already working with several versions of reality. AI simply helps make that problem faster and more neatly formatted.

The minimum state for such a process can be very small:

decision:
  question: "Should VIP orders bypass manual approval?"
  sources:
    - customer_meeting_2026_09_15
    - finance_policy_v3
  owner: product_manager
  status: unresolved

dependent_artifacts:
  prd: draft
  technical_design: blocked
  qa_scenarios: blocked

completion_allowed: false
Enter fullscreen mode Exit fullscreen mode

There is nothing intelligent about this fragment. It does not solve the problem for a person.

But it does not allow the process to pretend that the problem has been solved.

From a good prompt to a controlled process

You can put all these rules into a long prompt: do not make assumptions, ask clarifying questions, check contradictions, do not move on without approval.

But after a few iterations, those rules get mixed with examples, corrections, and earlier responses.

Then one requirement changes. The model updates the PRD but not the QA scenarios. Or it keeps generating artifacts even though the key question still has no answer.

For work like this, we need more than better instruction text.

We need to make state, sources, dependencies, checks, and human decision points explicit.

That is the problem Ordo is trying to address: a way to describe AI-assisted processes so a model can help create and validate artifacts without turning unapproved assumptions into apparently finished decisions.

AI can write the specification.

But if the team still does not know what it is building after the specification appears, the problem is not the quality of the prose.

The problem is that the document finished before the decision did.

Explore Ordo on GitHub

Top comments (0)