Back to Portfolio

Product Engineering · Customer Onboarding Workflow

Handoff
From Scattered Information to a Reviewed Handoff

I am building a small workspace that helps an implementation coordinator reconcile customer information, resolve missing or conflicting details, and deliver an approved handoff to a project system.

REACTTYPESCRIPTREVIEW WORKFLOWAI SUGGESTIONSEVALUATION
Handoff: AI-assisted onboarding

Status: Discovery In Progress

This is an independent portfolio project for a simulated implementation consultancy, using synthetic records and role-played stakeholder requirements. Discovery is underway and the build has not started. The first version is timeboxed to roughly 45 to 60 project hours across about three weeks. No application results, customer research findings, adoption, or business savings are claimed.

The Problem

The simulated client is a B2B implementation consultancy. Its request is simple to state: "Sales hands us a kickoff form, email excerpts, and account notes. They don't always agree. We need to see what's missing, decide whether we can schedule kickoff, and create a handoff without retyping everything. We also need to know why a request was marked ready."

The hard part is not extraction. It is deciding what counts as confirmed when sources disagree, and keeping that uncertainty visible until a person resolves it.

One Complete Workflow

These are starting hypotheses to test in discovery, not a completed specification:

01Collect: import one synthetic packet made of a kickoff form, email excerpts, and sales notes
02Review: inspect proposed fields next to their source passages, with gaps and conflicting statements surfaced
03Resolve: the reviewer corrects fields, records open questions, and decides whether a handoff is appropriate
04Approve: approve the specific version being handed off, with a traceable record of the decision
05Deliver: send the approved version through a working HTTP integration to a simulated project system, and show success or a recoverable failure

The first experience stays small: a queue, a review workspace, and handoff history, with keyboard support and clear loading, empty, validation, and failure states.

A Packet Worth Investigating

FORM-01 · Kickoff form

Example Customer A requests November 9, 2026. Scope: CRM migration. Technical contact: not provided.

SALES-01 · Account note

CRM migration and reporting were discussed. Reporting may be a later phase; confirm the initial scope before scheduling.

EMAIL-01 · Customer excerpt

"Can we start on November 12 instead? Jordan can coordinate scheduling, but our technical owner has not been assigned."

The review challenge: which date is confirmed? What is the agreed initial scope? Is Jordan a scheduling contact or a technical owner? The workspace has to preserve that uncertainty until it is resolved.

Decisions I Own

The learning goal is to own a feature from an unclear request through verified delivery. AI may generate substantial implementation code. I own the decisions, the review, the debugging, and the evidence.

  • •Define "ready," the person who decides, and the questions that block handoff
  • •Choose how conflicting sources are handled and when a reviewer must intervene
  • •Decide where state, validation, authorization, and persistence belong
  • •Explain how source changes affect suggestions and existing approvals
  • •Define proof of delivery and retry behavior that avoids duplicate projects
  • •Choose the smallest useful release and justify AI against a manual baseline

Technical Direction Is Still Open

Interface

React and TypeScript are proposed, designed around reviewer decisions and evidence.

API and storage

One backend and one database, chosen after discovery and kept proportionate to the workflow.

Model

Chosen after baseline testing. It suggests fields and conflicts with supporting passages, and unsupported information stays unknown.

Integration

One simulated downstream HTTP API that receives real requests and can intentionally fail.

AI shows up twice. During development, I delegate bounded changes with observable acceptance criteria, inspect the relevant changes, and investigate unexpected behavior. Inside the product, model suggestions stay separate from confirmed values, and a reviewer decides readiness and approves delivery.

How I Will Evaluate It

Acceptance thresholds are chosen before measuring. The plan starts with about 30 synthetic cases: 20 for development and 10 held out for an evaluation checkpoint, including complete packets, missing fields, conflicting sources, later edits, and irrelevant instructions embedded in source text. Expected answers stay out of model inputs.

  • •Extraction and grounding: compare fields with explicit expectations, count unsupported claims, and verify that cited passages support the suggestions
  • •Uncertainty: detect missing information and conflicts without treating guesses or customer requests as confirmed facts
  • •Workflow correctness: edits persist, approval covers the reviewed version, relevant later edits require renewed approval, and unapproved handoffs are not sent
  • •Integration reliability: failures are visible and understandable, and a repeated delivery or retry does not create a duplicate downstream project
  • •Reviewer effort: compare time and corrections needed for a correct decision in manual and assisted practice sessions
  • •Operation: record observed latency and estimated model cost for the tested cases, with the model and configuration used

A defensible release decision means showing the complete path from source packet to reviewed, approved, delivered handoff, demonstrating one delivery failure and a successful recovery without duplication, and explaining a model failure, its consequences, and the chosen correction or limitation. Narrowing or removing an unhelpful AI feature is a valid outcome.

Scope

The first version covers one workflow, one reviewer persona, text and JSON inputs, and one integration. It defers OCR, inbox sync, CRM sync, billing, multi-organization administration, real signatures, and autonomous approval, and adds an agent framework only if a demonstrated need warrants it.

Claims stay proportional to the evidence. Results will be reported with their denominators and limitations. A small synthetic set does not establish production accuracy or customer savings, and solo timings are practice results.

Proposed Tech Stack

ReactTypeScriptHTTP APIAI suggestions