Blog
What I wish someone had told me earlier.
About me
I'm Fran. Fifteen years building software and running businesses, now with AI at every stage. These articles are the engineering lessons I pick up along the way.
How I turned each rule of a code scope into a test that an AI evaluator runs against every file, on every commit, push and CI run, in under 500 ms. The pattern, how it works, and what it saves in time, tokens and review rounds.
read
A brand rule says the owner's face never appears in public. So the brand needed another face. Ninety-two images, seven rounds, the first three thrown out whole — and the process left uncleaned.
read
I downloaded a SaaS provider's documentation, fed it to parallel AI agents, and had a working backend in hours. Your code is not your moat anymore.
read
I built a Claude Code expert agent trained on a 20k-star community repo instead of official documentation. It found 25 issues in my production setup, including exposed secrets.
read
You're working on a large codebase and Claude Code keeps missing context. How placing documentation at each directory level gives the agent exactly what it needs — nothing more.
read
Practical patterns for AI-augmented development: how I structure agent workflows to deliver production code, not just prototypes.
read
Every public function has JSDoc. Every decision has a rationale. Real examples from a production SaaS on how self-documented code eliminates tribal knowledge.
read
Code grouped by the problem it solves, not by its technical role. A practical look at feature-based architecture with real production examples.
read
Reusing code sounds efficient, but it creates hidden connections. Here is why I prefer independent modules that can evolve separately -- with real examples from a production SaaS.
read
How organizing code around business domains -- not technical layers -- lets each area evolve independently, reducing risk and speeding up delivery.
read
If a solution is hard to explain, it's probably wrong. Concrete examples of choosing simplicity over cleverness in a real Node.js and Next.js codebase.
read
How enforcing single responsibility across middleware, controllers, and domain logic makes a SaaS codebase faster to debug, safer to change, and easier to onboard into.
read