Repair
Something that broke.
It is live, and it is failing, drifting, overspending, or frozen because nobody dares touch it. I find the fault, fix it, and leave it in a state where the next person can work.
Faults this covers
It errors, times out, or falls over under load
The visible kind. Usually the fastest to reproduce and the easiest to be honest about.
It runs, and the output has quietly stopped being right
Model changes, prompt rot, stale context, silent retries. Nothing alarms because nothing crashed.
Spend climbed and nobody can point at the cause
Retries, oversized context, an agent loop with no ceiling, or a cache that never actually caches.
It works, and nobody on the team will change it
No tests, no notes, one person who left. The system is fine until the day it is not.
How it runs, in order.
Reproduce the fault
Nothing gets proposed until the failure happens in front of me. If it cannot be reproduced, that is the first finding and you get told.
A written diagnosis
What is broken, why, what it takes to fix, and what I would deliberately leave alone.
Fix it and show the evidence
The change ships with the before and after that proves it worked, rather than an assurance that it should.
Leave it changeable
Notes on what is still fragile and what to do next, so the next incident does not have to come back to me.
Where this thinking came from.
Three of the projects in the field exist because a system was wrong in a way nobody caught.
Describe the symptom.
Fill this in and it composes the email. Nothing is submitted from this page and nothing is stored here. Your mail client sends it to joe@joepro.ai.
This is the only part that has to be filled in.
What gets sent
- To
- joe@joepro.ai
- Subject
- Repair request
Door: Repair Starting point: Live and failing outright Timing: This month What is happening, and what should be happening instead? (not filled in yet) Sent from joepro.ai
- Nothing is stored
- This page has no form queue behind it. The message is composed in your browser.
- You send it
- Your own mail client opens with the message already written, and you can edit all of it.
- If the button does nothing
- Some browsers block mail links. Use Copy the message, or write straight to joe@joepro.ai.