guest@make-directory:~$ cat ./blogs/before-you-build-an-internal-tool-map-the-workflow/index.mdx

Andrew Schwartz / 2026-05-20

Before You Build an Internal Tool, Map the Workflow First

Internal tools work best when they are designed around the real workflow, not just the screens a team thinks it needs.

Internal tools usually start with a simple sentence:

"We need a dashboard."

Sometimes that is true. Other times, the dashboard is only the visible part of a bigger workflow problem. The team may need a better intake process, clearer approvals, fewer spreadsheets, cleaner data, or a way to see who owns the next step.

Before building the tool, map the work.

Follow One Real Request

Start with one normal example.

Pick a recent customer request, project, order, application, ticket, or internal task. Then trace what happened from beginning to end.

Ask:

  • Where did it enter the business?
  • Who saw it first?
  • What information was missing?
  • Where was it stored?
  • Who touched it next?
  • What tools were involved?
  • Where did someone have to copy and paste?
  • What caused delay or confusion?
  • How did everyone know it was finished?

This exercise often reveals that the tool is not just about displaying data. It is about moving work through the business with fewer dropped handoffs.

Identify the Source of Truth

Internal tools become messy when nobody knows which system is correct.

A spreadsheet may have one version of a customer record. A CRM may have another. Email may contain the latest status. A project management tool may have the tasks. A manager may keep a private tracker because the official process does not answer their questions.

Before development starts, decide where important information should live.

Not every piece of data needs to be stored in the new tool. Sometimes the right move is to connect to an existing system. Sometimes the new tool should become the source of truth for a specific workflow. The decision should be intentional.

Design Around Decisions

A useful internal tool helps people make decisions or take action.

It should make these things easier:

  • Seeing what needs attention
  • Knowing who owns the next step
  • Finding the right record
  • Updating status
  • Approving or rejecting work
  • Notifying the right person
  • Reviewing trends over time

If a screen looks impressive but does not help someone decide or act, it may not be needed.

Keep Permissions Practical

Internal does not mean everyone should see everything.

Staff, managers, finance, operations, and administrators may need different levels of access. Planning permissions early prevents uncomfortable changes later.

At a basic level, decide:

  • Who can view records?
  • Who can create records?
  • Who can edit records?
  • Who can approve changes?
  • Who can export data?
  • Who can manage users?

Permissions influence the database, interface, and testing plan. They should not be treated as a final detail.

Replace Spreadsheets Carefully

Spreadsheets are not bad. They are flexible, familiar, and fast to start.

But spreadsheets can become painful when:

  • Multiple people edit them at once
  • Important fields are inconsistent
  • Permissions are unclear
  • Reporting requires manual cleanup
  • Historical changes are hard to track
  • Data needs to trigger actions elsewhere

If the spreadsheet still works, it may only need cleanup or a better reporting layer. If the spreadsheet is carrying a business process that has outgrown it, a custom internal tool may be worth considering.

Launch With the Workflow People Actually Need

The first version of an internal tool should focus on the most repeated, valuable workflow.

It does not need every report, export, setting, and edge case on day one. It does need to make the core process easier than the current workaround.

That means the best first version may include:

  • A clean intake form
  • A list of active items
  • Status changes
  • Assigned owners
  • Basic notifications
  • Search
  • A small admin area

Once the team uses it, the next improvements become easier to prioritize.

The Tool Is Only Successful If People Use It

Internal software has a simple test: does the team choose it over the workaround?

If it is slower than the spreadsheet, people will go back to the spreadsheet. If it hides important details, people will keep side notes. If it creates more admin work than it removes, adoption will be weak.

Mapping the workflow first gives the tool a better chance to fit the way the team actually works.

If your business is considering an internal dashboard, portal, or operations tool, we can help scope the workflow before development starts.

Andrew Schwartz

Andrew is the head of operations at Make Directory Developers and possesses a profound enthusiasm for computing and technology, coupled with a strong inclination towards problem-solving.