Back to Home
Writing

How things
actually work.

Practical guides for solution architects covering distributed systems, AI, and cloud delivery. Explore the trade-offs, follow a workflow through an interactive diagram, and see how the pieces fit together.

13 articles8 topics~98 min total
Solution Architect7 min read

Designing Reliable Event-Driven Integrations

Follow an accepted order through the outbox, broker, and partner API. Make duplicate delivery, tenant boundaries, and uncertain outcomes explicit.

Event-Driven SystemsOutboxIdempotency
Read the walkthrough
Solution Architect6 min read

Building Observable, Resilient AWS Systems

Connect metrics, logs, health checks, deployment controls, and recovery drills to the user operations your cloud application must complete.

AWSCloudWatchObservability
Read the walkthrough
AI / LLM7 min read

How MCP Tool Calling Works

From discovering a tool to checking its result — follow an assistant through the protocol, the permission boundary, and the parts your application still owns.

MCPTool CallingAgents
Read the walkthrough
Automation7 min read

Building AI Automation That Survives Retries

A useful model response is only one step. Durable state, validation, idempotency, and explicit recovery turn a fragile demo into a dependable workflow.

AI WorkflowsBullMQIdempotency
Read the walkthrough
Machine Learning8 min read

Evaluating a Phishing Detector Beyond Accuracy

Why a promising score can hide a weak detector — work through precision, recall, campaign leakage, time-based splits, and a threshold you can actually defend.

Phishing DetectionEvaluationPrecision / Recall
Read the walkthrough
Backend8 min read

Serving Python ML Models Behind a NestJS API

Keep product logic in TypeScript and inference in Python. Trace a prediction through a versioned contract, a warm model, bounded HTTP calls, and honest failure handling.

NestJSPythonFastAPI
Read the walkthrough
Backend9 min read

How to Use Redis in a Node.js API

The cache-aside pattern actually wired into an Express route — connection, helper, invalidation, and the failure handling most tutorials skip.

RedisNode.jsExpress
Read the walkthrough
Performance8 min read

How Redis Caching Works

Why the second request is always faster than the first — traced through an actual cache miss and an actual cache hit.

RedisCachingTTL
Read the walkthrough
AI / LLM8 min read

How RAG Actually Works

Why LLMs make things up, and how handing them the right paragraphs first fixes it — indexing and querying, animated step by step.

RAGVector DBEmbeddings
Read the walkthrough
AI / LLM10 min read

How Claude Skills and Agent Harnesses Work

From discovering SKILL.md to checking a real tool result — see how reusable instructions connect to context, permissions, and the agent execution loop.

Claude SkillsSKILL.mdAgent Harnesses
Read the walkthrough
Auth7 min read

How Sessions Work

The cookie is just a pointer — the real record lives on the server. Why that trade-off buys instant logout.

SessionsCookiesRedis
Read the walkthrough
DevOps7 min read

How CI/CD Works

From a git push to code running in production — every automated gate in between, and why teams trust it enough to ship daily.

CI/CDGitHub ActionsAutomation
Read the walkthrough