Technical Writing
Thoughts on software engineering, system design, and building scalable systems. Articles cover topics from data engineering and cloud architecture to leadership and team building.
2025
Dec
- The Agent Loop Is a Lie
Every tutorial teaches observe-think-act. Every production agent is messier. Here's what actually happens — and how to fix it.
- AI Engineering Fundamentals: From Tokens to Agents
A new 8-part series covering the complete AI engineering stack: tokenization, embeddings, attention, generation, retrieval, RAG, agents, and evaluation. No hand-waving, just mechanics.
- API-Driven UI Configuration: Stop Hardcoding Your Dashboard
Every dashboard has summary cards. Most teams hardcode them. Product wants to add a card? Deploy frontend. We made it API-driven.
- Configuration-Driven React Components: One Component, Many Use Cases
You build a data table for Users. Then Products. Then Orders. Copy-paste leads to drift. Too many props leads to chaos. We found the middle ground: configuration-driven components.
- 3-Tier Design Token Architecture: From Figma to Themes
Every team starts with CSS variables. Then they need themes. Then everything becomes a mess. We built a 3-tier system that scales: Options → Decisions → Themes.
- BFF Pattern with Spring Boot and Specmatic: Contract-First Backend
Your frontend team is blocked. They need APIs that don't exist yet. The BFF pattern with contract-first development solves this. Define the contract, stub it, build frontend and backend in parallel.
- Contract-First Frontend: Stop Letting Your Mocks Lie to You
Most frontend teams mock APIs incorrectly. They create fake responses that drift from reality. We solved this by making mocks contractually bound to OpenAPI specs using Specmatic.
Nov
- Monkey-Patching and Annotation-Driven AOP in Python - Learning from FastAPI, Pydantic, and Requests
Explore how FastAPI, Pydantic, and Requests use monkey-patching and annotation-driven patterns to create elegant APIs. Learn to build your own aspect-oriented programming system for cross-cutting concerns.
- Design Pattern - Cascading Credential Resolution
Learn how to implement a cascading credential resolution pattern inspired by AWS SDK - providing multiple credential sources with clear precedence for better developer experience and flexibility.
- Building AI-First Documentation Systems - A Modern Approach to Project Knowledge
How to structure project documentation for optimal AI agent navigation while maintaining human readability - reducing context load time from minutes to seconds.
- Building a Modern Stock Analysis System with Vortex, DuckDB, and Apache Arrow
Technical deep-dive on building an end-to-end financial data pipeline using Vortex columnar format, DuckDB OLAP engine, and Apache Arrow - demonstrating next-gen data stack for analytical workloads.
- Why CLIs matter in AI engineering
This is the Age of APIs, MCPs, and CLIs. Same functionality, different interfaces. Here's what I learned redesigning my CLI tool.
Sep
- Smart Migration System with Flyway Integration - Design and Implementation
An intelligent migration framework that extends Flyway’s schema versioning with automated record tracking and dependency-aware rollback for safe, repeatable data scenarios.
2024
Sep
- Implementing Scalable Search Functionality - Design & Technical Blueprint
A comprehensive technical blueprint for implementing robust, scalable search functionality with considerations for architecture, indexing, performance, and best practices
- TIL- Converting Parquet Files to Vespa Documents
TIL: Converting Parquet Files to Vespa Documents
Aug
- TIL - How to List All Users with Pagination Using Clerk in Go
TIL POST: How to List All Users with Pagination Using Clerk in Go
- TIL - Battling Database Duplicates - A Perspective on Data Integrity
TIL POST: A Perspective on Data Integrity