Usipoziba Ufa, Utajenga Ukuta — On Technical Debt and the Discipline to Fix It

There's a Swahili proverb that lives in my head rent-free as a developer: Usipoziba ufa, utajenga ukuta. If you don't seal the crack, you'll rebuild the wall. I was recently doing a technical review of a school management system — a real, live, production codebase built by a team moving fast and shipping features. The kind of project where prototyping decisions become permanent ones, and technical debt quietly accumulates in the walls. I could have done the minimum. Fixed what was on the ticket, shipped, moved on. Instead I did what I always do — I kept pulling the thread. Here's what I found, and the first principles behind every fix. Context (Because You Deserve It) This was a PHP/Laravel backend — a language I was relatively new to at the time. Laravel is a popular PHP web framework, and Tinker is its interactive console, like a REPL you can use to query and manipulate the database directly without building a UI. Think of it as a surgical tool for backend diagnosis. The system manag