runbookify
← All plans
Field Service & Dispatch / Technician Routing & Mobile Checklists

Return-Visit & Parts-Needed Flagger: Never Lose a Half-Finished Job Again

When a tech can't finish a job, they flag the reason, list the parts and skills they need, and the tool drafts a follow-up work order linked to the original — then a dispatcher reviews and approves it before it ever hits the schedule.

IntermediateAn afternoonBuilds onNext.jsSupabaseResend
What you'll build

A web tool where a technician flags a job incomplete with a reason (parts, more time, second tech), lists the parts and skills required, and the tool drafts a follow-up work order linked to the original job and asset; a dispatcher reviews and approves the follow-up (and any parts order) before it enters the schedule, with a CSV export for your dispatch/ERP and parts system.

Gated download

Enter your email — the plan downloads instantly and a copy lands in your inbox.

By submitting your email you'll also receive the weekly runbookify newsletter. You can unsubscribe at any time.

Before you start

  • A Supabase account (free)
  • A Vercel account (free)
  • A Resend account (free)
  • A CSV of open work orders
  • A parts list/catalog CSV and a skills list
  • Claude Code or any AI coding agent

The problem this kills

A tech rolls up to a no-cooling call, diagnoses a failed compressor, and realizes the part isn't on the truck. They make a note — "needs compressor, will come back" — close out the day, and move on. Two weeks later the customer calls, furious: nobody ever returned. The note lived in a photo on someone's phone, or in a comment field nobody reads, or in a verbal "hey, remember that job?" that got forgotten by Friday. There's no follow-up work order, the part was never ordered, and now you're apologizing instead of billing.

Incomplete jobs are the quiet leak in field service. The work is half done, the customer is half satisfied, and the only thing standing between you and a return visit is a tech's memory and a sticky note. The fix isn't more discipline — it's a structured way to flag "I couldn't finish, here's why, here's what I need," that automatically drafts a linked follow-up work order and routes it to a dispatcher to approve. You do not need to be a developer to build that.

What you'll build

A simple internal web tool your field techs and dispatch desk share. When a tech can't complete a job, they open it on their phone, mark it incomplete, and pick the reason: parts needed, more time, or second tech / extra skill. They specify exactly what's required — the parts (from your catalog) and any special skills — and add their diagnosis notes. The tool instantly drafts a follow-up work order linked to the original job and asset, carrying over the diagnosis so nothing gets re-explained. A dispatcher reviews and approves the follow-up (and any parts order it triggers) — and only then does it enter the schedule. Everything exports as clean CSVs for your dispatch/ERP and your parts system.

What's inside the Implementation Plan

The downloadable plan is a step-by-step file you paste into an AI coding agent. It opens by interviewing you about your business — how your techs report incomplete jobs today, the systems and spreadsheets you run, the exact way your work orders, parts SKUs, and skills are named and numbered, your typical and peak volumes, and your real rules for who approves a return visit. It reads a short spec back to you for a thumbs-up, then builds the tool around your answers instead of a generic template. From there it walks the agent through the data model, importing open work orders and your parts catalog, the tech's mobile flag-incomplete form, the follow-up-WO drafting logic, the dispatcher review-and-approve gate, and the exports. Every step ends with a ready-to-copy prompt.

The governance it includes (this is the point)

This isn't a toy. The plan builds in the controls a real service operation needs: login so only your team can use it, row-level security so people only see their own organization's jobs, a complete audit trail of every flag, draft, edit, and approval (who, what, when, and why), a hard human-approval gate so no follow-up work order or parts order enters the schedule until a dispatcher approves it, and duplicate guards so one incomplete visit can only ever create one follow-up. The tech raises the flag; a dispatcher makes the call.

Who it's for

Field technicians who keep losing return visits to memory, dispatchers who own the schedule, and parts coordinators who get blindsided by last-minute part requests. If you can describe what makes a job "incomplete" and who's allowed to put a return visit on the schedule, you can build this.

You've got this — open the plan, paste the first prompt, and you'll be drafting your first tracked follow-up this afternoon.

Gated download

Enter your email — the plan downloads instantly and a copy lands in your inbox.

By submitting your email you'll also receive the weekly runbookify newsletter. You can unsubscribe at any time.