Writing archive

Essays and working notes on software architecture, infrastructure, AI tooling, APIs, and the tradeoffs behind production systems.

All notes

Status Is a Distributed System

Why deployment status is not a UI label, but a consistency problem across databases, queues, workers, locks, reconcilers, Kubernetes, and user trust.

A PaaS Is a Reconciliation Loop With a Bill Attached

Why a PaaS control plane is really a reconciliation loop: desired state, observed state, transactional outbox events, and billing that cannot afford to lie.

Durable Execution: You're Already Building It, Badly

Every retry loop, job queue, state column, and idempotency key is a piece of a durable execution engine. What Temporal, Restate, and Inngest actually solve, what they cost, and when a plain queue is still right.

Harness Engineering: AI Agents Are Easy, Production Is Not

Why the hard part of AI agents is not the model or the prompt but the harness: context management, tool design, sandboxing, evals, and the engineering discipline forming around agents in production.

Backups Are Not Snapshots

A technical note on why platform backups need to be designed as user-facing recovery artifacts, not confused with storage-layer snapshots.

Building Guara Cloud Like a Product, Not a Kubernetes Dashboard

Why I am building Guara Cloud as a product around developer outcomes, Brazilian billing, service operations, and reliability instead of exposing Kubernetes as another complicated control panel.

Debugging Kubernetes Storage Incidents Without Lying to Yourself

A deep engineering note on incident analysis, evidence gathering, and avoiding premature certainty during Kubernetes and Longhorn storage failures.

A farewell to Deel

A happy and warm goodbye to my time working as a Software Engineer at Deel

Why I Decided to Go Baremetal

Building my own Kubernetes cluster on bare metal. Not because I reject the cloud, but because I want to prove I don't need it.

I built my own SQL IDE

How a weekend experiment turned into SQLTemple, an AI powered SQL IDE built with Electron, React, and TypeScript to make working with databases actually pleasant.

What I run on my homelab 2

A tour of my current homelab: pfSense, Proxmox cluster, HA stacks, media services, observability, AI experiments, and how this all fits into my house network.

Quintile: A Framework for Structured Collaborative AI Agents

Quintile, a framework for structuring autonomous AI agents into phased, cooperative teams like assembly line for collective intelligence.

The Hidden Cost of Abstractions: Why Clean Code Isn’t Always Good Code

Clean code feels good, but every layer of abstraction hides a tiny tax on performance and clarity. Here's why it matters.

The Novelization Dilemma: The Gap Between Codebase Abstractions and Domain Knowledge on the AI era

If the code is the novelization of the business, much can be lost in translation.

Quickly Start Your New SaaS With This Template

Discover how a custom-built SaaS starter template can accelerate your development process, helping you go from idea to MVP faster.

How to Properly Set Up Your SaaS in the Age of Vibe Coding

An in-depth guide on securing your SaaS applications using vibe coding and AI-powered tools, ensuring rapid development without compromising security.

TypeScript Goes Go

TypeScript’s new Go-based compiler is here, promising fastest performance and a smoother experience. Let’s unpack what’s new and why it matters!

Understanding Software Scalability: Key Factors and Strategies

An approachable overview of software scalability, detailing key factors that affect it and strategies to effectively scale applications.

Blockchain Fundamentals and Integrated Node Service

An in-depth exploration of blockchain fundamentals, architecture, and a practical implementation using TypeScript/Node.js with code oriented content.

The Art of Writing Clean Code: Practical Tips for Everyday Developers

Explore friendly and practical tips for writing clean, maintainable code that every developer can relate to.

How I Built Threadrize

The journey of building Threadrize, an AI-powered platform for X (Twitter) users that helps create, plan, analyze, and grow their X social media presence.

Understanding Concurrency and Multithreading in Modern Software

A technical yet accessible guide to the concepts of concurrency and multithreading, exploring how they enhance performance in today's software applications.

AI in Software Development: Enhancing Productivity and Innovation

Learn how artificial intelligence is transforming software development by automating tasks, improving code quality, and supporting innovative solutions.

The Future of AI in Software Development: Trends and Predictions

Explore how artificial intelligence is shaping the future of software development with emerging trends and expert predictions.

Over-Engineering: The enemy of good software

How adding unnecessary complexity can destroy your software projects in the long run, and why simplicity often wins the race.

What I run on my homelab

What I run on my personal homelab. My own server running at home.

Microservices in a nutshell: Good, Bad, and Ugly parts

Understand microservices beyond the buzzwords, exploring real pros, cons, and pitfalls.

What I Wish I Knew About APIs When I Started Coding

Reflecting on the journey of learning APIs, this article shares practical lessons on error handling, scalability, and choosing between REST and GraphQL, aimed at helping new developers navigate the API landscape.

Avoiding Common Mistakes in API Rate Limiting

Learn about common pitfalls in API rate limiting and practical tips to avoid them.

7 Node.js Optimization Tips to Instantly Improve Performance

Boost your Node.js backend performance with these seven quick and effective optimization tips.

Understanding the Node.js V8 Engine: A Beginner's Guide

An introduction to the V8 JavaScript engine used by Node.js, detailing how it compiles and optimizes code, and the key features that make it fast and efficient.

The DRY Principle: Writing Maintainable Code by Avoiding Repetition

Explore the DRY (Don't Repeat Yourself) principle in software engineering, its benefits, and actionable tips to write maintainable and scalable code by avoiding repetition.

A Warm Welcome to My Tech Corner!

An introduction to my blog where I share insights about software engineering, architecture, cloud technologies and technology in general.

Create a Simple Search Engine with Python and Math

Implement a simple Vector Space powered Search Engine using Python and mathematical concepts.