Guide

Write a software project brief developers can actually price.

A good brief is two to five pages explaining the problem, the users, what must be built and the constraints around it. It is the cheapest way to get comparable quotes and avoid a project built on assumptions. AI can help you draft one quickly, as long as the thinking stays yours.

Vague briefs do not produce cheaper quotes. They produce different ones.

When a brief leaves gaps, every vendor fills them with its own assumptions. One imagines a simple web form, another a mobile app with an admin portal. The quotes differ several-fold and there is no way to compare them, so the decision defaults to price or personality.

The gaps do not disappear after signing either. They resurface as change requests, missed expectations and arguments about what "done" meant. A clear brief does not need technical language or a full specification. It needs to describe the problem, the people and the outcome precisely enough that two competent teams would propose roughly the same thing.

Template

Software project brief template: what to include

Work through these sections in order. Short, specific answers beat long, general ones, and anything you are unsure about should be marked as an open question rather than guessed.

  • 1. Background and problem

    Who you are, what problem the software solves, and what happens today without it.

  • 2. Goals and success measures

    The outcomes you expect, such as hours saved, conversion or revenue, and how you will measure them.

  • 3. Users and roles

    Each type of user, what they need to achieve, and roughly how many there will be at launch and a year later.

  • 4. Core user journeys

    The step-by-step flows that must work, written from the user's point of view. Three to seven is typical for a first release.

  • 5. Must-have, nice-to-have and out of scope

    A prioritised feature list, plus an explicit list of what this phase will not include.

  • 6. Integrations and data

    Existing systems to connect, data to migrate, and where information comes from and goes to.

  • 7. AI features and data rules

    Any AI capabilities you expect, the data they would draw on, and limits on what may be sent to third-party AI services.

  • 8. Platforms and technical constraints

    Web, iOS or Android, mandated technologies, hosting requirements and accessibility needs.

  • 9. Security, privacy and compliance

    Personal or regulated data involved, the regulations that apply, and customer requirements such as audits.

  • 10. Budget, timeline and decision process

    A budget range, key dates and why they matter, who decides, and how proposals will be evaluated.

Avoid these

Common project brief mistakes

Describing solutions instead of problems

"We need a dashboard" gets you a dashboard. "Managers only see late orders when customers complain" gets you the right solution.

Marking every feature essential

If everything is a must-have, vendors cannot show you where to save money, and you cannot decide either.

Hiding the budget

A range lets vendors propose what is achievable for it, instead of pricing a fantasy or lowballing to win.

Forgetting admin and support users

Someone must manage accounts, correct data and issue refunds. Those back-office journeys can add a lot of scope.

Unexplained deadlines

A date tied to a trade show is a constraint; a date picked at random is a preference. Say which one yours is.

Writing a novel

Fifty pages bury the priorities. If a section does not change what gets built or what it costs, cut it.

Using AI

How to use AI to write a project brief, and where to be careful

AI assistants make good brief-writing partners. Describe your idea conversationally, then ask the assistant to organise it into the template above, list the questions a developer would ask, suggest journeys or roles you have missed, and point out contradictions. Getting to a solid first draft becomes a matter of hours rather than days.

The risk is that AI fills gaps with confident, generic detail. It will happily invent user roles, add features you never asked for and assume integrations that do not exist. Read every line and delete anything you would not defend in a meeting with a vendor. A brief is only useful if it reflects your decisions.

Be careful what you paste in. Customer data, commercially sensitive plans and internal documents belong only in AI tools your organisation has approved. And use the brief itself to ask vendors how they use AI in delivery and how that affects their estimate, so proposals can be compared on that too.

Process

Writing your brief in a week

Talk to the people affected

Day 1

Interview a few future users and the staff who will support the system. Note the problems in their own words.

Draft against the template

Day 2

Work through each section, using an AI assistant to structure your notes and surface missing questions.

Challenge every must-have

Day 3

For each feature, ask what happens if it launches a month later. If the answer is "not much", move it down the list.

Get a technical read

Day 4

Ask an experienced engineer or advisor to review it for gaps, risks and unrealistic assumptions.

Finalise and send

Day 5

Add evaluation criteria and a response deadline, then send the identical brief to every vendor.

FAQ

Questions we often hear

What should a software project brief include?

A software project brief should cover the background and problem, goals, users, core user journeys, prioritised features, integrations and data, any AI requirements, technical constraints, security and compliance needs, and your budget, timeline and decision process. Two to five pages is usually enough.

How long should a software project brief be?

For most projects, two to five pages: long enough to describe the problem, users, key journeys and constraints clearly, and short enough that vendors read it properly. Detailed specifications usually come later, during a paid discovery phase.

Can I use ChatGPT or other AI tools to write a project brief?

Yes. AI assistants are good at structuring notes, suggesting missing questions and spotting contradictions. Review everything they add, because they tend to invent plausible but unwanted features and assumptions, and avoid pasting in sensitive data unless the tool is approved for it.

Is a project brief the same as a requirements specification?

No. A brief explains the problem, goals, users and constraints so vendors can propose and price a solution. A requirements specification defines that solution in detail and is usually produced during discovery, ideally with the team that will build it.

Should I include my budget in a software project brief?

Yes, at least as a range. It lets vendors propose what is realistically achievable and makes proposals far easier to compare. Leaving it out tends to produce quotes that are either inflated or unrealistically low.

Sharpen your brief

Want a second pair of eyes on your brief?

Paste in your draft or describe the project. We will point out gaps and risky assumptions, and suggest what a realistic first phase could include.

Working with companies globally · Response within 24 hours