Writing

Notes on backend engineering, distributed systems, databases and AI.

17
Oct
gray safety harness on focus photo

The Harness Is the New Model: Why AI Agents Live or Die by Their Scaffolding

What an AI harness is, why it suddenly matters more than which model you pick, and seven habits for getting real work out of one.
9 min read
17
Oct
cable network

The Three Gaps in a Self-Hosted Deploy

The container is green, but the deploy isn't done: the network you silently lost, the setup page anyone can claim, and the second domain that needs a redirect.
4 min read
20
Feb
Street photograph by Stalin Pereira

The README That Gets Read: Documentation Templates Every Project Needs

Providing a framework for READMEs that actually help new developers onboard quickly
2 min read
15
Feb
Street photograph by Stalin Pereira

Time Zones Will Break Your Code: A Developer's Guide to Handling Dates Correctly

Explaining UTC storage timezone conversion and the bugs that plague datetime handling
2 min read
15
Feb
Street photograph by Stalin Pereira

Logs Are Not Debugging: Structured Logging Patterns That Actually Help

Teaching log levels structured formats and context that make logs searchable and useful
2 min read
14
Feb
Street photograph by Stalin Pereira

The Anatomy of a URL: What Every Part Means and Why It Matters

Breaking down protocol host port path query and fragment with security and routing implications
2 min read
12
Feb
Street photograph by Stalin Pereira

Error Handling Is Not Optional: Patterns That Prevent Silent Failures

Teaching try-catch patterns error propagation and why swallowing exceptions destroys debuggability
2 min read
06
Feb
Street photograph by Stalin Pereira

You Need to Understand Encoding: UTF-8 Unicode and Why Your Text Breaks

Explaining character encoding issues that cause bugs across languages databases and APIs
2 min read
04
Feb
Street photograph by Stalin Pereira

The Beginner's Guide to API Design: REST Principles Most Developers Get Wrong

Covering resource naming HTTP verbs status codes and hypermedia that make APIs intuitive
2 min read
03
Feb
Street photograph by Stalin Pereira

JSON Is Not Just a Data Format: Schema Validation and the Bugs You're Missing

Teaching JSON Schema validation and why accepting unvalidated JSON is a security and reliability risk
2 min read