What should be included in a software development proposal?

· 6 min read

A proposal is the first substantial piece of work a firm does for you, and it is usually free — which makes it the cheapest evidence you will ever get about how they think. What it contains, and what it leaves out, tells you a great deal.

It should restate your problem back to you

Before anything about the solution, a proposal should demonstrate that the firm understood the problem — in their words, not copied from your email. If you read that section and think "that is not quite it", you have learned something important before spending anything.

It should define scope precisely enough to argue with

Scope written as a list of features is weak. Scope written as what the system will do, for whom, including what it will not do, is strong. The exclusions matter as much as the inclusions: a proposal that says nothing about what is out of scope has not made any commitments you can hold it to.

What a complete proposal contains

  • The problem, restated, and what success looks like in measurable terms.
  • What is being built, and explicitly what is not.
  • Assumptions — things taken as true that would change the price if wrong.
  • Who does the work, and who your point of contact is.
  • Timeline with stages, and what you receive at the end of each.
  • Price, what it includes, and how changes are handled.
  • Ownership of code, data and infrastructure.
  • What happens after launch: support, maintenance, and what each costs.

Assumptions are the most revealing section

Every estimate rests on assumptions — that an existing system has a usable API, that content will be supplied by a date, that one department rather than four needs to approve. A proposal listing them is a firm that has thought about what could go wrong. A proposal without them has the same assumptions; it has just not told you, and you will meet them later as change requests.

Comparing proposals that look nothing alike

Look atRather than
What is excludedThe headline price
Who is named as doing the workThe size of the company
How change is handledWhether the timeline looks fast
What happens at month sixWhat happens at launch
Assumptions listedConfidence expressed

Two proposals differing by 40% usually differ in what they include, not in hourly rate. Normalising them against each other — feature by feature, exclusion by exclusion — is tedious and almost always changes which one looks better.

If a proposal arrives as a single page with a price and a timeline, that is the answer to your question about how the project will be run.

What it should not contain

Pages of boilerplate about methodology, a technology stack presented as a selling point without reference to your problem, or a list of industries served that includes yours as one of thirty. None of it is about you, and its presence usually means the specific thinking is thin.

Our own proposals are a scope document with fixed line items, agreed before work starts — the process around them is written down here, including what happens when something in the scope turns out to be wrong.

Working on something like this?

If any of the above describes your situation, describe it to us — no specification needed, and no obligation to proceed.