Internal tools
Give one difficult decision a better working view.
Sometimes the evidence is spread across tools and the person responsible cannot make a confident decision. A small custom view can bring the relevant records, sources and permitted actions together. First check what the existing tools can do, then define the missing capability and how the team will use it.
In this guide
Name the decision that is difficult today
An account coordinator handles requests that cannot confidently be matched to a customer. Each review means opening the CRM, an order export and the source email, then finding who can confirm the branch. A useful first improvement gives the coordinator the evidence needed to resolve that exception.
Write the decision in the user’s words: “I need to see the candidate accounts, the original request and the reason for the conflict, then confirm the right record or leave it unresolved.” Add how often the situation occurs and what delay or mistake the current process creates.
Separate this working view from the overall commercial workflow specification. That specification describes the handover across people and tools. This brief describes what one user must be able to see and do at a specific point within it.
Test the current feature before specifying a new screen
Try completing the decision in the current CRM view, saved report or approved shared sheet. Record the actual gap: source references cannot be shown together, edits cannot be restricted to the required field, or the user cannot distinguish an unresolved match from a confirmed account.
A preference for a different layout alone may not justify another application to maintain. If an existing view can expose the evidence, hold the exception and record the approved change, include that option in the brief. The tools and agents guide compares an existing feature, integration, custom tool and agent against the job.
Keep the unresolved limitation specific. “The coordinator cannot see which source proposed this owner” is a testable problem. “We need a single source of truth dashboard” leaves the source, authority and next action undefined.
Specify the records behind every visible field
Give the screen an exception ID and retain stable references to the request and candidate accounts. Show the relevant buying unit, current owner, proposed change, source location and time of the last check. A readable company name helps the user; it should not be the only identifier used to update the record.
Define what makes two records the same account and what remains separate. HubSpot’s data-sync matching guidance distinguishes record matching from the fields mapped between systems. Your screen needs the corresponding distinction: which record is this, and which value may change?
The shared customer data guide provides the identity and source rules. Keep those rules outside a display-only convention. A green badge cannot settle an unresolved match, and copying a source value into a form does not make it approved.
Account exception-review screen
A request names West Office, while the CRM suggests the group’s East account. The review view needs to show that conflict, the source and the permitted next decision. This brief specifies the evidence to attach before the coordinator can confirm a match.
Request and reviewer
Shows the exception ID, request ID, arrival time and reviewer (the account coordinator). The authorised source reference and last-check time are attached before review.
Source request
The request names “West Office”. Check the readable source excerpt and contact context through the authorised reference.
Candidate accounts
West: named in the request; the matching CRM record is not established. East: the group account suggested by the CRM; the match is unconfirmed. Stable record IDs, buying units, current owners and supporting references must be attached before a decision. A shared domain does not establish one account.
Proposed change
Field: the request’s account link, with its current saved value. Suggested value: the East account, based on the CRM suggestion. Hold reason: the source says West; the account identity is unresolved.
Permitted next decision
The account coordinator checks the authorised evidence and agreed identity rules. Confirm a match only when established and within the coordinator’s permission; otherwise request clarification or leave it held with a named next owner. Changing the commercial owner is a separate permission. No quote, email send or wider account merge is included.
Update record after a permitted decision
Record the accepted change, approver and time, then confirm the destination result. If the source or current owner changed, review the fresh state before approval. If the write result is uncertain, show “Checking” and reconcile the destination before retrying.
If another user changes the owner after this screen opens, the coordinator should see that newer state before approving an overwrite. The tool should ask for a renewed decision when the relevant evidence changes, rather than quietly applying the stale proposal.
If the write response is lost, keep the exception in an explicit checking state. The operator must be able to reconcile the destination record before retrying. A cheerful completion message cannot substitute for confirmation that the intended record changed.
Make each control correspond to an authorised change
List the fields the user may edit and the conditions for each change. Selecting the confirmed West account may be within the coordinator’s role; changing the commercial owner may require a manager’s approval. Show those as separate decisions instead of granting broad record access to make the screen convenient.
Describe the unchanged case as well. A reviewer should be able to leave an exception held, explain why and name the next responsible person. Do not force a choice between a guessed match and abandoning the work without a record.
Where the action supports an account plan or pipeline review, link to the accepted account or deal record after resolution. Keep ownership of those commercial decisions in the relevant process; the exception screen does not create a new qualification or forecasting rule.
Design for the actual user and working conditions
Define which users may see each exception and source. The server and connected system must enforce that access, including direct links to a result. Hiding a button or relying on the user to choose the correct account is insufficient protection for a record-changing tool.
Show clear feedback for loading, saving, held, failed and confirmed states. Preserve a permitted draft where useful, explain a rejected edit and make the next action available. The user should not need to inspect logs to know whether to continue, retry or contact the operator.
Include keyboard use, readable source references, long names, narrow screens and unavailable connections in the brief. A working view often contains dense evidence, so decide which details stay visible for the decision and which can open on demand without losing the current context.
Test the decision, not just the screen’s appearance
Give the future user a correct match, two plausible accounts, a missing source, a changed owner and a failed save. Ask them to complete each task without narration. They should be able to explain why the record is held or changed and find the evidence supporting that state.
Include repeated clicks, another user’s record, revoked access and a stale proposed value. Record the expected destination state and the observed result. The workflow testing checklist supplies the failure and recovery cases that also apply to a small internal tool.
Before accepting the build, ask the user to recover one held item and the operator to explain a write whose result is uncertain. Clear presentation is only part of the job: the people using the tool must also be able to resolve its exceptions.
Keep the tool small enough to own
Document where the code and configuration live, the hosting or licence arrangements, who controls credentials and which sources the tool depends on. Name the maintainer and explain how to request a change or continue working when the screen is unavailable. Specify which records and decisions the business must be able to export or retain.
Agree one working view and its role in the handover. A tool included in a Build campaign is named in that campaign’s scope; a standalone custom tool has its own quote. AI Workflows applies when the task needs AI-assisted preparation. The quoted scope includes the relevant connections, checks and ownership arrangements. Taking over an inherited setup begins with a separately scoped paid Plan assessment before an implementation commitment.
Which decision is awkward to finish in your current tools?
We can examine the task, the evidence it needs and the limitations of the current view. Agree a useful improvement through existing features, a connection or a small custom tool with a clear owner and handover.
Discuss your working toolsA Fit Call is a free 30-minute video conversation. No preparation needed.