~/blog/tag/architecture
Architecture
Thoughts on system design, API architecture and scalable solutions.
What I write about here
Most posts under this tag share a thesis. The bottleneck on AI productivity is almost never the model. It is the system the model sits inside.
A coding agent that can write a function is useful. A coding agent that can write a function and push it to production without anyone reviewing it is a security incident waiting to happen. A pipeline with no integration tests turns every AI commit into a coin flip. None of that is the model's fault, and none of it is solved by upgrading to the next one.
So the architecture work I write about is the work around the agent. How wide the blast radius is when something goes wrong, where the boundary between intent and execution sits, what you put between a model's confident output and your actual production database.
The Laravel post is one practical pattern. The Gemini integration is another. The database deletion story is what happens when those boundaries are too thin.
If you came here looking for clean diagrams of microservices, you are in the wrong place. I write about architecture as containment, mostly. What the system protects you from, and what it cannot.
The underlying story about judgement and process lives in the Software craft in the AI era guide.
best entry points
- How database indexes work: the B-tree under everything you shipped this week
System design from the bottom up. Every index rule you know by heart is one property of the shape of the tree.
- The lava layer: why AI code is slowly petrifying your codebase
What AI code does to an architecture: not one visible violation, and still a codebase that slowly hardens.
- Putting AI to work in your Laravel backend
How to actually integrate AI into a real backend without it turning into a footgun. Concrete patterns, not principles.
What a dependency graph finds that your coding agent misses
I pointed a scanner at an internal app that agents had been working in for months. It took under two seconds and produced four tickets. Not one of the defects was in a file, which is exactly why nothing reading files had found them.
read →How database indexes work: the B-tree under everything you shipped this week
A B-tree explained from the shape up, and why every index rule you memorised is that shape restated: leftmost prefix, sargable predicates, covering indexes, slow inserts.
The off-switch was never yours
Fable 5 did not crash. It was recalled. A US export directive pulled Anthropic's top model worldwide on June 12, for every customer at once, and no amount of retries or fallbacks would have saved you.
The ceiling is made of concrete
Every rate limit, signup pause, and pricing shift of the last six months has one root cause. Not greed. Not unsustainable burn rates. Physics.
Your 10x developer is gated by a 0.1x pipeline
AI made code cheap. Nobody upgraded the pipeline that turns code into shipped value. Now the bottleneck is eating your senior engineers alive.
The day Claude deleted my production database
AI coding assistants are incredibly powerful until they decide to "fix" a corruption by wiping your database. A cautionary tale about backups and why dev boxes need them too.
Putting AI to work in your Laravel backend
Laravel now has real tools for AI integration. Here's how to move beyond naive API calls and build structured, testable AI features with Prism and the official Laravel AI SDK.
The AI is not your friend: how I secured Gemini on this site
Most 'AI integrations' are just a chat box and a prayer. Here is how I built a secure, contextual, and bilingual assistant using Gemini 3.1 Flash Lite.
From blind generation to an AI team: how to take back control with agents
Stop treating AI as a single author. Give it roles, let them argue, and you'll ship better software before you've written a single line of code.
The bureaucracy of bots: why we are checking the checker
Deploying an AI to double-check the work of another AI produces better results. But we are unwittingly recreating the slow, complex corporate bureaucracy we tried to escape.