Skip to main content
PandaCodeGen.

Founder notes

How to Document Business Workflows Before You Automate Them

Walk through a real job with the people who do it. Capture handoffs and exceptions, then use those examples to test the new system.

By Hassan Jamal, Co-founder and Lead Engineer

Published

Start with somebody doing a real job. Ask them to walk you through a recent order, show where they got the details and explain what had to happen before they could hand it to the next person. Do this with each team that touches the order, including the person who gets the call when things go wrong.

What did we learn by sitting down with the team?

At Panda Patches, I led the engineering work on a system that replaced spreadsheet processes. I spoke with sales agents, production staff and the people who digitize artwork and create mockups. Each group knew a part of the order journey. Seeing those steps together helped us decide what information to carry through the order and when to tell the next person it was ready.

Panda Patches is owned by my PandaCodeGen co-founder, Imran Raza Ladhani. I described this part of the work in Tech Magazine when it asked how teams prevent critical knowledge gaps. See the founder-affiliated Panda Patches project.

What should go in a workflow note?

A sample workflow note for an artwork handoff
RecordExample to test
Starting eventCustomer confirms the artwork and order details.
Information neededThe approved file, order reference and any special instructions.
Owner and next stepProduction receives the job and confirms it can begin.
ExceptionIf the file is missing or a change comes in, send the job back for review with a clear owner.
Evidence it workedStaff can tell which file was approved and see the current status.

Keep the first note short enough for someone to correct on a call. Give it an owner who can update it when the real process changes. Mark which facts came from the order and which were guessed. Where two teams describe the same step differently, show them the same case and agree what should happen.

How do you check the workflow before making it live?

Pick a standard case and two exceptions, such as a file arriving late or a customer changing a confirmed order. Have the teams run each case and explain what they expected to happen next. Check who can update a status, whether a message goes to the intended person and how someone can recover a mistake. Use sample records for the walkthrough if the real ones contain private information.

At handover, ask somebody who missed the meeting to do one task using the guide. If they have to call the developer, record where they got stuck and update the guide or the screen. A short, tested handoff gives new staff a place to start.

For the question of when the current tools are worth replacing, read the rebuild decision guide.

Common questions

Who should help document a workflow?
Invite everyone who performs or receives a handoff, including the people who handle exceptions. Have them walk through a real job using information they are allowed to share.
How do you tell if a workflow is ready to automate?
Test whether staff can name the trigger, required information, owner, next action and exception path. Use a normal case and a failure case to check that the rules make sense.

PandaCodeGen offers website and application development. Recommendations here reflect our delivery approach; the proposal for your project defines its scope. How we use evidence.