The search looks broken. That is the first read from the outside.
The app turns long videos into short summaries and clips. Search is how you jump to the moment you actually want. I type a phrase I know is in the video. It comes back with nothing useful. Wrong clips. Half sentences. Noise.
So I set the agents on the search. Then I stop them. Before anyone touches it, I want to see what the search is reading underneath.
The answer is ugly.
The first version pulled the captions straight off the source video and indexed those. The captions overlap. They repeat. They double back on themselves. Half a million chunks of indexed text, and when I actually measured how many were duplicated junk, it came back at roughly ninety-three percent. The search is not broken. It is doing its honest best with garbage.
This is the moment it is tempting to make the search smarter. Add filters. Rank harder. Teach it to step around the noise. Every one of those decorates the problem and leaves the rot in place.
I tell the agents to go to the root instead. Pull clean transcripts properly, not the tangled captions. Clean them in passes. Then rebuild the search on top of good material.
It is the slower path. It means throwing out the first version of how the app reads a video and building that part again. The agents trace the cause, pull the clean source, run the cleanup pass by pass. I hold the line on what “fixed” means here: the search works when the words beneath it are real. Not a minute before.
Learnings
Garbage in, garbage out is not a tired saying. It is a diagnosis. When the output looks broken, the loud, visible thing is rarely the culprit. The search felt like the failure. The search was fine.
What I caught was the pull to fix the thing I could see. The agents could have made the search cleverer all week and it would never have worked, because the material it stood on was junk. The cheaper-looking repair would have been the expensive one.
So now my first question when something reads as broken is not “how do I fix this surface.” It is “what is feeding it, and is that any good.” Fix the source, and the symptom you were chasing often just disappears.