Requirements document: what you need, written down before anyone builds

A conversation, one question at a time, that ends with a document your build team can start from.

The requirements document is a skill in Ai1, the AI agent platform by MyZone AI. The Requirements Agent interviews you one question at a time and writes what you need into a structured document, with open questions flagged rather than guessed. Once you agree it, the Scoping Agent turns it into a sized plan for the build.

  • Part of Ai1
  • Open questions flagged
  • Nothing built on a guess

    Open questions are flagged, so your build team knows what is confirmed and what still needs a decision.

  • Tests anyone can check

    Each user story comes with acceptance criteria written so a non-technical tester can tick them off.

  • A clean handover

    The agreed document passes to the people and agents who scope, design and build, with nothing lost.

The requirements document in short

The requirements document at a glance
Starts fromWhatever is on your mind, or a brief you already wrote
HowOne focused question at a time, in plain language
ContainsThe problem, who it is for, user stories with tests, what is in and out of scope, and open questions
Checked withEach team that owns a step, before it is signed off
Delivered asA link you can share
NeverBuilds anything or writes code

Why write the requirements down first

A request like "make onboarding faster" means something different to every person who hears it. If the details are settled halfway through the build, work gets redone and deadlines slip. A requirements document fixes the target first: the problem in numbers, who needs what, and how each piece will be tested, with the unknowns named instead of assumed.

How this differs from the Scoping Agent: the Scoping Agent starts from the approved requirements document and turns it into a sized, ordered technical scope; this skill is the document it starts from.

From a conversation to an agreed document

Four steps. You sign the document off before any scoping or build begins.

How the Requirements Agent works: you ask through the Comms Hub and Ai1 runs the steps: start talking, focused questions, document produced, delivered to you and build team takes over. It works with Slack. It returns a requirements document.
Tap the diagram to enlarge it

Step 1: You start talking

Describe a problem to solve or hand over a brief you already wrote. It asks only about the gaps.

Step 2: It asks one question at a time

Each answer is acknowledged, and it moves on only when it has what it needs.

Step 3: It writes the document

Everything goes into a structured document, checked with each team that owns a step.

You approve

Step 4: You sign it off

Once you agree the requirements, they pass to the people and agents who scope, design and build.

Example: onboarding a new client site for a cleaning company

Example with a fictional company. Names and figures are invented to show the kind of output you get.

What it was asked: Turn our sticky-note map of how we onboard a new client site into a proper requirements document, so we get from signed contract to first clean faster.

What the document set out, Jolmerby (fictional), new-site onboarding
The problem17 working days from signed contract to first clean, through 9 handoffs across 5 teams. The target is 10 or fewer.
First-week trouble13 of 56 sites had a problem in week one last year, mostly missing keys, wrong supplies or no trained cleaner booked.
User storiesNine, six must-haves each with a given, when, then test, including a go or no-go check two days before the first clean.

It documents, your team builds

Where the requirements document ends and the build begins.

  • It never builds anything or writes code. It captures and documents what you need.
  • Open questions are flagged, never assumed away.
  • Scoping, design and build go to the right team only once your requirements are agreed.

Works well with

The agents that write and use this document.

  • Scoping Agent

    Agent. Sizes and orders the build from the approved document.

  • Designer

    Agent. Turns the agreed requirements into wireframes and finished design.

Frequently asked questions about the requirements document

Do I need to prepare anything first?

No. Start with whatever is on your mind. If you already wrote a brief, hand it over and it asks only about the gaps.

What goes into the document?

The problem and the business case, who it is for, user stories with acceptance criteria, what is in and out of scope, and the open questions with who owns each one.

Who checks it before it is final?

It is checked with each team that owns a step in the process, and you sign it off. Nothing moves to scoping or building until the requirements are agreed.

What happens after I sign it off?

The Scoping Agent turns it into a technical scope, with every task sized and ordered. A person on your team approves that scope before any build task is created.

Turn one of your ideas into requirements

Bring a process that eats your team's time and we will show you the document it becomes.

  • Your own private serverEvery Ai1 plan runs on a private server that belongs to your business alone.
  • Your data stays yoursStored on your server, not used to train AI models, and you can export everything you build at any time.
  • Choose your AI modelBring your own AI provider account and pay it directly, with no markup from us.
  • No lock-inMonthly plans run month to month with no long-term commitment, and everything you build can be exported.