SkipOps

Plain English, start here

What SkipOps does — and exactly where we are

SkipOps runs the day for a UK rubbish-clearance firm, entirely through Telegram. The boss texts jobs in plain words. The system works out the smartest route for every van. The crew get tap-by-tap job cards on their phones. The boss watches it happen live and ends up with a photo-proof record of every job. No money or pricing anywhere in version 1 — the win is told in saved fuel, time and wages.

1stage with a working screen + brain (set-up)
1stage with a working core that needs a rework (the route planner)
7stages designed and waiting to be built
built & tested part-built to build

The whole thing on one page

The loop, top to bottom

Five moving parts. Set the firm up once, then the same loop repeats every working day.

flowchart LR
  A["① Set the firm up
(once)"] --> B["② & ③ Boss texts
jobs"] B --> C["④ System plans the
smartest day"] C --> D["⑤–⑦ Crew get job cards
+ post photos"] D --> E["⑥ ⑧ ⑨ Boss watches live +
gets the record"] E -. "new job or change
→ re-plan" .-> C classDef here fill:#eef2ff,stroke:#4f46e5,stroke-width:2px,color:#3730a3; class A here;
We are here — building stage ①, the set-up.

Every stage — what it's for, and where we are

The 9 stages in detail

Each one: the plain-English objective (what we're trying to achieve), a quick picture, and an honest done / still-to-do.

Set the firm up

engine + real Haiku live on Hours · 5 sections + map to go

The objective: before SkipOps can run anyone's day, it has to learn how that firm works — the six things its features need. The boss is walked through 6 short guided sections (hours, vans, crew, sites, materials, checklist), each a real AI conversation that asks, understands his plain answer, and confirms before moving on. Cheap Haiku does the parsing; our own code decides what counts as "done" — so a box only goes green when it's genuinely captured. (Strategy approved 23 Jun — replaces the earlier single "describe your day" prompt. The whole spine is now built and proven live on the first section, Hours: a messy "7 till 5, mon–sat" → Claude clarifies am/pm → confirm → our strict check accepts it. The other five sections reuse the exact same spine.)

What we gather from the firm → what it powers: their vans & how much each holds, their crew & hours, what happens to each kind of waste, where the yard and tips are, and the standard job checklist. Every answer feeds a feature — nothing is asked "just in case".
flowchart LR
  subgraph G ["What we gather"]
    V["Vans + capacity"]
    M["Each waste type
+ where it goes"] S["Yard + tips
on a map"] C["Crew + hours"] K["Job checklist"] end subgraph P ["What it powers"] R["Smart routes +
full-van trips"] J["Crew job cards"] D["Boss live map"] Pr["Photo-proof
record"] end V --> R M --> R S --> R S --> D C --> J K --> J K --> Pr

Done

  • The data shapes + strict validation — each section's "is it complete?" check (backend, 100 tests)
  • The 6-section guided engine — walks one section at a time; a box only goes green when our code validates it, never because the AI said so
  • Real Haiku wired in (the cheap parsing AI), proven live on Hours — messy answer → understood → confirmed → accepted (~£0.0006 a run)
  • The wizard screen — "step N of 6" progress strip + focused chat (screenshot-checked on a phone-size screen)
  • The save-the-firm step + review screen + warm design system

Still to do

  • Fill the other 5 sections — Vans, Crew, Sites, Materials, Checklist — each one focused AI prompt on the same spine (one short build each)
  • The map: pin the yard + each tip — turns Sites names into exact locations (needs Google Maps, a small one-off cost)
  • Go live: deploy + point a real test firm at it (spend-gated)

Give the firm its two chats

to build

The objective: every firm gets two Telegram chats — a private one for the boss (the "Gaffer" chat) and a group for the crew (the "Dispatch" group). And a hard wall so one firm can never see another firm's jobs.

flowchart LR
  A["Firm set up"] --> B["Gaffer chat
(boss only)"] A --> C["Dispatch group
(the crew)"] B --> D["Each firm's data
walled off"] C --> D

Done

  • Nothing yet — the design is set

Still to do

  • Wire up the two bots + lock each to its firm
  • Switch on the data walls (security rules) before any real firm's data lands

Boss drops a job

to build

The objective: the boss texts a job the way he'd say it out loud — "clear a garage on Dyke Road tomorrow morning, half a load, before-and-after pics." The system turns that into a proper job (where, how big, when, what photos) and reads it back so any misread is caught on the spot.

flowchart LR
  A["Boss texts it
in plain words"] --> B["System understands:
where, size, when"] B --> C["Job created"] C --> D["Reads it back
to confirm"]

Done

  • Skeleton only

Still to do

  • The "understand the text" step, save the job, and the read-back

Plan the smartest day

core built · rework owed

The objective: given the day's jobs, work out the most efficient round for every van — fewest miles, fullest loads — including nipping back to the yard to empty when a van fills up, then carrying on. This saving (fuel, time, wages) is the whole pitch.

flowchart LR
  A["The day's jobs"] --> C["The planner"]
  B["The vans + capacity"] --> C
  C --> D["Most-efficient
route per van"] D -. "van full →" .-> E["empty at the yard,
then carry on"] E -.-> D

Done

  • The core planner works and is tested (routes, time windows, empty-and-continue)

Still to do

  • It currently plans around cost (money) — rework it to plan around distance + load (no money in v1)
  • Wire in the yard-hub + the per-waste-type consolidation trips

Tell each crew their route

to build

The objective: once the day's planned, each van gets one clear, friendly message — their stops in order, what to expect, and a tap-to-navigate link for each stop that opens their own phone's maps. Nothing new to learn.

flowchart LR
  A["The day's plan"] --> B["Friendly message
per van"] B --> C["Stops in order"] B --> D["Tap-to-navigate
per stop"]

Done

  • Skeleton only

Still to do

  • Turn the cold route into a readable message + the per-stop map links

See where the vans are

to build

The objective: each driver taps "share live location" in Telegram once at the start of the day. That's it — the system now knows where every van is, with no app and no tracking box to fit.

flowchart LR
  A["Driver taps
'share location'"] --> B["System knows
where each van is"] B --> C["Feeds the
boss's live map"]

Done

  • Nothing to build on Telegram's side — by design

Still to do

  • Store the shared location + a morning "share it again" nudge

Photo-proof every job

to build

The objective: the crew snap a before and an after photo and tick the job checklist. The system files them against the job, so there's a permanent, proof-backed record of every clearance — plus a note of exactly who was on that team that day.

flowchart LR
  A["Crew: before +
after photos"] --> C["Filed against
the job"] B["Checklist ticked"] --> C C --> D["Permanent
proof record"]

Done

  • Skeleton only

Still to do

  • Photo capture + storage, checklist tick, the crew snapshot on finish

Re-plan when things change

planner ready · trigger left

The objective: jobs change all day — a new one comes in, one's cancelled, a van finishes early. When that happens the system quietly re-plans the rest of the day and re-sends the routes, without anyone asking.

flowchart LR
  A["New / cancelled job,
or van free early"] --> B["Re-plan the
rest of the day"] B --> C["Re-send the
updated routes"]

Done

  • The planner can already re-plan on demand

Still to do

  • The automatic trigger that fires it the moment something changes

The boss's live dashboard

to build

The objective: one screen for the boss — a live map of his vans and jobs, a list he can filter, and a tap into any job to see its photos, crew, checklist and timings. His whole operation at a glance.

flowchart LR
  A["Live van pins"] --> C["Boss dashboard"]
  B["All the jobs"] --> C
  C --> D["Tap a job → photos,
crew, checklist, times"]

Done

  • Folder is a placeholder

Still to do

  • All of it — the map, the list, the job detail

Staying on track

What's next, in order

Finish the set-up stage first (it's nearly there), then build the daily loop in the order the day actually runs.

1
Finish the set-up map next
Stage ① — drop-a-pin on the yard + tips. Needs a Google Maps key (small one-off cost per firm). Then one real end-to-end test with a live firm.
2
Rework the route planner's goal
Stage ④ — switch it from "cheapest" to "fewest miles + fullest loads", and wire in the yard-hub trips. The hard maths already works.
3
Build the daily loop
Stages ②③⑤⑥⑦ — the two chats, dropping a job, sending routes, live location, and photo-proof. This is the bulk of the remaining build.
4
Auto re-plan + the boss dashboard
Stages ⑧⑨ — fire the re-plan on any change, and give the boss his live oversight screen.

Mission: 20 paying firms at £75/mo by 5 Nov 2026. Roughly the first stretch is finishing the build; the rest is selling it.