Special 25% off once-off websites — from R2,999 ↗

How to brief a developer before building custom software

SL GroupSL Group journal

“We need a system” is a starting point, not a specification. A useful brief describes how work happens today, where it breaks down and what a better version would let people do.

Choose one real workflow

Take a recent job, order or request and follow it from beginning to end. Name the person responsible at each step. List the information they receive, what they decide and what they pass on. Include the spreadsheets, emails and messages that hold the process together.

For example, a field-service workflow might begin with an enquiry, move through a quote and schedule, then end with evidence of completion and an invoice. That sequence reveals more than a shopping list of screens.

Document the exceptions

Ask the team what happens when a customer changes their mind, a payment fails, a job is postponed or a staff member is absent. Workflows usually become difficult at the exceptions. Choose the common ones for the first release and record how less common cases will be handled manually.

Decide who can do what

List roles before listing user accounts. A crew member may need to update a job but should not necessarily change prices. A manager may approve a refund while a clerk prepares it. Describe who can view, create, edit, approve and export each important record.

Also name the owner of every connected system. Access to an API or data export should be confirmed before an integration becomes a delivery promise.

Define an acceptance example

Replace “the dashboard must be easy” with an observable task. For example: “The office manager can find all unassigned visits for next week, assign a team and see the updated schedule.” Agree on a handful of these examples so design reviews and testing have a shared reference.

Choose a first release with a clear boundary

Separate essential work from improvements that can wait. A focused release should complete a useful workflow, including the necessary exception handling, rather than contain half-built versions of every feature. Identify who will test it and how the team will work during the transition.

  • What problem are we solving, and for whom?
  • Which data must move from the old process?
  • Who approves scope and changes?
  • What support is needed after handover?
  • How will we know the first release is useful?

Bring your workflow notes to an initial custom software discussion. If an existing product already fits, our software range may offer a simpler starting point.

From the journal

Keep reading.

All articles

Tell us what you’re
building next.

A website, a system, an app or more customers — bring the idea and we’ll come back with a clear, itemised quote.