Engineering Notes

Building AI systems that actually ship

Practical writeups on architecture, UX decisions, and AI delivery workflows — for engineers, founders, and product teams.

Featured

How-toAI Engineering

How to Build an MCP Server (TypeScript, End to End)

A working Model Context Protocol server in TypeScript — project setup, tool registration with Zod, stdio transport, and wiring it into Claude Code and Cursor without breaking the JSON-RPC stream.

August 9, 2026 · 11 min read

Search articles

Sort

Latest articles

LEAP 2026: Four Days in Riyadh, and What Actually Shipped
Nearly $15 billion was announced across four days and sixteen stages. Most of it won't touch your stack. Three things will — and two have dates before this year ends.ConceptualAI EngineeringSeptember 17, 20269 min read
Next.js Site Not Indexed? What Took Mine From 21 to 54 Pages
Google had found 22 of my pages and refused to crawl them. Six Next.js mistakes caused it — including one that made every date in my sitemap a lie.TroubleshootingWeb DevelopmentSeptember 14, 202612 min read
Claude Code on Vertex AI: Why You Get 404s, Wrong Regions and an Opus-Sized Bill
Model not found on Google Cloud's Agent Platform is rarely one problem. A malformed region is silently ignored and falls back to us-east5, ANTHROPIC_VERTEX_PROJECT_ID overrides the project in your credentials, and a deployment with no pinned model is billed at the Opus rate.TroubleshootingAI EngineeringSeptember 10, 202610 min read
Claude Code Behind a Corporate Proxy: Why NODE_EXTRA_CA_CERTS Isn't the Fix
Unable to get local issuer certificate behind Zscaler or any TLS-inspecting proxy. Claude Code already trusts your OS certificate store by default — so the usual advice fixes it for some people and not others. The variable that actually decides is CLAUDE_CODE_CERT_STORE, and whether your runtime can read the OS store at all.TroubleshootingAI EngineeringSeptember 6, 202610 min read
Claude Code 529 Overloaded: What It Retries For You, and What It Won't
A 529 isn't your usage limit and doesn't touch your quota. Claude Code already retried ten times before it told you. The useful question is which failures it retries automatically, which it deliberately doesn't, and the one environment variable that stops an unattended run dying on a transient capacity blip.TroubleshootingAI EngineeringAugust 27, 20268 min read
Claude Code Won't Start on Windows? Match the Error, Not the Guide
Raw mode is not supported, 'claude' is not recognized, 32-bit Windows, Exec format error on WSL1 — five different Windows startup failures that get treated as one problem. Each has a distinct cause and a distinct fix, and four of them aren't install failures at all.TroubleshootingAI EngineeringAugust 21, 20268 min read
Claude Code Slow, Hanging, or Eating Memory? Start With the Silent Failures
High CPU, frozen commands and missing search results usually trace to a handful of specific causes — a thrashing auto-compact loop, a bundled ripgrep that won't run, or WSL quietly returning fewer matches while claude doctor reports everything as OK.TroubleshootingAI EngineeringAugust 16, 20268 min read
Why Claude Code Burns Tokens While You're Not Even Using It
Your usage climbs during a long session even when you barely type. The reasons are specific and mostly invisible: every request carries the whole conversation, your prompt cache quietly expires, and scheduled tasks, cross-session messages and idle teammates each resend your full context.TroubleshootingAI EngineeringAugust 14, 202610 min read
MCP Server Not Showing Up in Claude Code? Read the Status First
Your MCP server is configured but Claude can't see it. `claude mcp list` tells you which of five different problems you actually have — pending approval, a failed spawn, a Windows .cmd shim, zero advertised tools, or a server that was never in the list to begin with.TroubleshootingAI EngineeringAugust 11, 202611 min read

Featured

How to Build an MCP Server (TypeScript, End to End)

Latest articles

LEAP 2026: Four Days in Riyadh, and What Actually Shipped

Next.js Site Not Indexed? What Took Mine From 21 to 54 Pages

Claude Code on Vertex AI: Why You Get 404s, Wrong Regions and an Opus-Sized Bill

Claude Code Behind a Corporate Proxy: Why NODE_EXTRA_CA_CERTS Isn't the Fix

Claude Code 529 Overloaded: What It Retries For You, and What It Won't

Claude Code Won't Start on Windows? Match the Error, Not the Guide

Claude Code Slow, Hanging, or Eating Memory? Start With the Silent Failures

Why Claude Code Burns Tokens While You're Not Even Using It

MCP Server Not Showing Up in Claude Code? Read the Status First

Featured

How to Build an MCP Server (TypeScript, End to End)

Latest articles

LEAP 2026: Four Days in Riyadh, and What Actually Shipped

Next.js Site Not Indexed? What Took Mine From 21 to 54 Pages

Claude Code on Vertex AI: Why You Get 404s, Wrong Regions and an Opus-Sized Bill

Claude Code Behind a Corporate Proxy: Why NODE_EXTRA_CA_CERTS Isn't the Fix

Claude Code 529 Overloaded: What It Retries For You, and What It Won't

Claude Code Won't Start on Windows? Match the Error, Not the Guide

Claude Code Slow, Hanging, or Eating Memory? Start With the Silent Failures

Why Claude Code Burns Tokens While You're Not Even Using It

MCP Server Not Showing Up in Claude Code? Read the Status First