Questions about specifying software
How much time do my experts need to give?
Last updated
It varies with the application and with how much each person knows, so there isn't a fixed number. What doesn't vary is how they spend it: each expert answers short questions about their own part of the work, many with a tap and some in their own words, whenever it suits them. There are no group workshops to schedule.
What does an expert actually do?
Three kinds of things:
- Answer questions about how their part of the work happens: the steps, the rules, the exceptions, the information they use. Some need a few sentences; others are a quick Yes, No or Not sure.
- Check what was written down from their answers. Each item comes back as a card: tap Right, or say what's not quite right.
- Settle disagreements, if they're a decision maker for an area. They see each side and record the decision and why.
They can type or speak their answers, from a phone or a computer. "I don't know" is a fine answer; it tells the owner the question needs someone else.
How do questions reach them?
In their own inbox in the app, a few at a time rather than all at once, so it doesn't turn into a long form. When something is waiting, they get one short email a day saying so. When nothing is waiting, they get nothing.
Do they need to be in a meeting?
No. Each expert answers privately, on their own time. That's part of the point: people say more about the exceptions when they don't have to say it in front of the room, and nobody waits for a calendar slot.
What drives the time up?
The same things that make any application bigger: more processes, more rules, more exceptions, more systems to connect to. An expert who covers several areas gets more questions than one who covers one. Questions that come back from the readiness checks before sign-off, or from the builder later, add a few more.
Who should I invite?
People who know the work well and can speak for how it should be done, not only how it's done today. There is no limit on experts, and all of them are included. More people means more of the business is covered, and more chances to find a disagreement before the build instead of during it.
Can an AI agent answer some of it?
Yes. If you have an AI agent that knows your systems, you can add it as an expert. It answers its own questions like anyone else; only people decide, approve and sign off.
Related questions
See a finished specification
The sample is a complete Build Specification for a made-up company, free to read.