supraj.dev
Home/Articles

The engineering notebook

Articles

Practical articles on AI, cloud and DevOps. Choose a story and get into the engineering.

Articles
29
Series
6
Topics
8

29 articles

What Is Google AX? How It Works with Agent Substrate

Understand Google AX through a shared office: tasks, workspaces, runners, and how Agent Substrate provides the sandbox. Follow one simple README check.

Agent Runtimes · Part 3

Kubernetes Agent Sandbox, Explained Like a Hotel

What a sandbox is, why AI agents need one, why a normal container is not enough, and how kubernetes-sigs/agent-sandbox gives every agent its own locked room. Verified against the official v1beta1 API.

Agent Runtimes · Part 1

GPU Architecture, Layer by Layer

A plain-language deep dive into a modern GPU, using the NVIDIA H100: GPCs, TPCs and SMs, every unit inside an SM, the memory system, occupancy, Hopper's clusters and TMA, copy engines, NVLink and NVSwitch, MIG, the graphics units, and where TFLOPS numbers come from.

Masterclass · Part 3

How a GPU Works, and Why AI Can't Live Without It

A plain-language masterclass on GPUs. What a CPU is brilliant at and where it struggles, latency vs throughput, Streaming Multiprocessors, warps and divergence, latency hiding, memory bandwidth and the roofline, Tensor Cores and low precision. No hardware background needed.

Masterclass · Part 2

Inference Engineering Masterclass: How AI Actually Answers You (with vLLM)

A plain-language masterclass on inference engineering. Prefill and decode, the KV cache, batching, latency vs throughput, and how vLLM's PagedAttention, continuous batching, prefix caching and speculative decoding make AI fast and cheap. No AI background needed.

Masterclass · Part 1

What Is an Agent Harness? The Part of an AI Agent That Isn't the Model

Part 1 of Agent Harness Engineering. Why the same model can be a chatbot or a reliable coding agent, the seven parts every harness has, one bug fix traced through all of them, and the lessons Anthropic and OpenAI published about building harnesses.

Agent Harness Engineering · Part 1

Build an Agent Harness: A Working Blueprint in Python

Part 2 of Agent Harness Engineering. Build a real coding-agent harness in about 120 lines of Python, with a workspace jail, a policy that protects the tests, a done gate that runs the tests itself, checkpoints and traces. Then break it on purpose, and see how each piece grows up for production.

Agent Harness Engineering · Part 2

What Is an AI Agent? Explained From Zero, Step by Step

Part 1 of AI Agents from Zero. A spoon-fed explanation of what an AI agent really is, how it differs from a chatbot and a workflow, the five parts every agent has, and the think-act-observe loop, walked through one real example.

AI Agents from Zero · Part 1

How AI Agents Actually Work: Tool Calling, Memory and the Loop in Code

Part 2 of AI Agents from Zero. Open the hood: the exact messages an agent sends, how tool calling really works, three kinds of memory, how agents plan, and a complete working agent in about 80 lines of Python with no framework.

AI Agents from Zero · Part 2

AI Agent Design Patterns and Safety: Build Agents You Can Trust

Part 3 of AI Agents from Zero. The five building blocks behind most real agent systems with runnable code, when several agents beat one, a refund agent designed step by step, and how agents get attacked (prompt injection, the lethal trifecta) and defended.

AI Agents from Zero · Part 3

AI Agents in Production: The Complete Playbook

Part 4 of AI Agents from Zero. Everything between a working agent and one you can trust with real users: a simple reference architecture, reliability, identity and secrets, approvals, versioning, evals and red-teaming, safe rollouts, monitoring, cost, privacy, MCP security, an incident runbook, a launch plan and the checklist.

AI Agents from Zero · Part 4

AI Guardrails: The Model Is Not the Safety Layer

Guardrails are the runtime control plane around an LLM — what they are, why every production AI app needs them, and how to implement them with Bedrock Guardrails, NeMo Guardrails, and Llama Guard, with real configs.

The AWS MCP Server Is Now Generally Available

AWS announced the GA of their managed MCP Server, giving AI agents secure, authenticated access to 15,000+ AWS APIs, live documentation, and sandboxed script execution.

Building AI Agents with Google ADK: The Complete Production Guide

A deep, hands-on guide to Google's Agent Development Kit (ADK 2.0). Real Python code for tools, sequential/parallel/loop pipelines, sub-agent delegation, callbacks, evaluation, and Cloud Run deployment — plus an honest comparison with LangGraph, CrewAI, and AutoGen.

What is Vectorless RAG? (Explained Simply)

AI is getting smarter, but it doesn't always need complex vector databases. Here is a simple explanation of Vectorless RAG and why it's becoming popular.

Least-Privilege AWS IAM with an AI Agent

How iam-zero uses live CloudTrail logs and Anthropic Claude to audit over-permissive active policies, automatically opening secure pull requests.

Agentic Cloud Security · Part 1