Telling Technology · Learning in public
All episodes
EP.24 — THE DIAGNOSIS
A Claude Code workflow, on the water

I used Claude to diagnose my boat

The engine died twice at sea with no fault code. I fed the manuals to Claude Code — it built a cited knowledge base of the whole boat, ranked six suspects, and handed me a free dockside test plan before any mechanic.

A Brig RIB on open water with its Evinrude outboard raised, a translucent Claude Code terminal overlaid reading 'diagnose: engine stalls at sea, no fault code'.
⌁ diagnosed from the manuals · 0 kr · before any mechanic
It died twice at sea — and said nothing ↓
01 The problem

It died twice at sea — and said nothing

Out on the water, the engine cut out. Twice. No warning, no error on the display, and it restarted the instant I cycled the key. On a modern outboard that's eerie: the engine computer watches oil, fuel pressure, temperature and knock, and it will happily throw a fault code and a limp-home mode when one of those trips. A clean stall with zero message isn't one of those faults. The silence was the clue.

claude code — desktop
> engine died twice at sea, restarted instantly, no fault code on the display. what's going on?
That silence is diagnostic. The engine computer shows a fault + get-home mode for anything it monitors — oil, temp, knock. A clean stall with no code that restarts on a key-cycle means something briefly killed its power or its stop circuit — it wasn't running to log a fault. Let's rank the suspects.
An outboard engine ICON display, powered on but showing no fault message, with the engine stopped — the eerie 'nothing wrong' screen after a stall.
no code shown
Two clean stalls, zero fault codes — the anomaly is the data
02 The build

I gave Claude every manual — it built the boat a brain

I copied the boat's real documents — the Brig RIB owner's manual, the Evinrude E-TEC G2 operator's guide and service manual, the diagnostic-tool docs — and had Claude Code distill them into a cross-linked knowledge base: specs, service intervals, the diagnostic hardware, and a dedicated page for this exact stalling issue. Every claim cites the manual it came from. Now the boat has a searchable memory, and the diagnosis stands on sourced facts, not guesses.

claude code — desktop
> read these manuals and build a wiki for the boat + a page for the stalling issue. cite every claim.
Done. Distilled the source PDFs into linked notes — specs, maintenance, winterizing, diagnostics — plus engine-stalling-2026-07.md. Each fact points back to its manual page. The stalling page carries a ranked hypothesis list and a step-by-step pull plan.
A file tree of the boat knowledge base in an editor: boat-and-purchase.md, etec-g2-service-manual.md, evdiag6.md, engine-stalling-2026-07.md, each with cross-links.
sourced, not guessed
The manuals → one cross-linked, cited knowledge base
03 The diagnosis

Six suspects, ranked — and the silence pointed to one

With the symptom pattern and the manuals in context, Claude ranked six causes from most to least likely. Top of the list: the kill-switch lanyard or its stop circuit — the classic "dies with zero warning, restarts instantly" failure on an outboard, doubly likely in chop. Then a corroded ignition switch, a loose battery ground, water in a harness connector, fuel slosh, and — least likely — an actual monitored fault, precisely because that one should have shown a code.

claude code — desktop
> given the exact symptom, rank the causes most-to-least likely.
1) Kill-switch lanyard / stop circuit — classic no-warning stall  2) corroded ignition switch  3) loose battery ground — computer loses 12V, reboots clean  4) water in a harness connector  5) fuel slosh  6) a real monitored fault (least likely — it'd show a code). Start cheap, at the dock.
A ranked list of six causes for the silent stall, kill-switch/stop-circuit at number one down to a real monitored fault at number six, each with a one-line rationale.
kill-switch = #1
Ranked by how well each explains a silent, self-restarting stall
⚠️

A ranked plan is not a repaired boat

This is AI reasoning over manuals, not a mechanic's verdict — the top suspect is a hypothesis, not a fact, and nothing's confirmed until the dockside tests and the laptop pull actually run. What Claude changed isn't the fix; it's that I walk up to the boat with a sourced, ranked checklist instead of guessing — and I test the 0 kr suspects before paying anyone to guess at the same list.

04 The receipts

The diagnosis, on four screens

The symptom logged, the six suspects ranked, the free dockside tests to run first, and the full laptop pull for when they don't find it. Tap any image to enlarge it and read exactly what's on screen.

ZERO KRONA SPENT · BEFORE ANY MECHANIC

A dockside test plan before a single krona

The point isn't that AI fixed my boat — it hasn't been back on the water. It's that a foggy, scary "it died at sea and I don't know why" became a ranked, sourced checklist I can work through at the trailer: wiggle the kill-switch, retorque the battery ground, check the ignition plug — all free, all before a workshop bills me an hour to guess at the same list. If those miss, the same page hands me the exact laptop pull to read the engine's hidden history.

A verdict board: number-one suspect the kill-switch / stop circuit, a free dockside wiggle-test to run first, and the laptop pull held in reserve — all before any mechanic.
Brig RIB · Evinrude E-TEC G2 · diagnosed from the manuals, tested at the dock
06 Steal this

Turn your manuals into a diagnostician

The method is free: copy the real manuals into a folder, have Claude Code distill them into a cited wiki, then describe your symptom and ask for a ranked, sourced diagnosis. Works for a boat, a car, a furnace — anything with a manual and a mystery.

method manuals → cited wiki prompt symptom → ranked causes rule cite every claim free test the cheap suspects first
the whole method # Drop your manuals in a folder → "read these and build a cited wiki + a page for my symptom, ranked most-to-least likely". Method write-up publishing soon

Method write-up's being cleaned up for release. Comment DIAGNOSE on the post and the bot DMs you the exact prompts the moment it's public.

Next episode

Next: every open thread in my life, in one file — closeable from my phone

A plain markdown file that tracks every unfinished thread, and a bot that checks one off when I text close 3 from anywhere. The scrappy text file that beat the fancy dashboard.

A darkened preview of the AIOS Telegram bot, hinting at closing tasks from the phone.
drops soon · follow so you don't miss it