shipped spoolcast dev log 5 — repo gps for ai agents

Today’s Spoolcast video is about a problem that kept showing up in production: AI agents were not just hallucinating facts. They were hallucinating workflows.

The pattern was frustrating because the agents were technically “following the rules,” but the rules had grown out of trial and error. Every time something went wrong, another rule got added. Eventually the docs became a patchwork: active workflow, old rationale, show-specific instructions, mobile-export exceptions, and historical specs all sitting near each other.

The real lesson was that more prose was not enough. The repo needed a routing step. Before an agent makes anything, it needs to know what kind of task it is doing, which workflow owns it, and what the next allowed action is.

That became the core idea of the video: my AI was not ignoring instructions. It was lost, so I gave the repo GPS.

This one also pushed Spoolcast itself forward. The video needed a clearer intro for people who are interested in AI but do not live inside codebases, better speech cadence, narration-only subtitles, a stronger thumbnail direction, and more deliberate handling of memes/reaction clips. The final result is not just a video about fixing agent behavior. It is also another proof point that Spoolcast can turn a messy real build story into a finished YouTube episode.