Blog

Agentic engineering, written down

Build logs, agentic engineering decisions, agent failures, evals, and what survives real users — on Claude Code, agents, RAG, and MCP.

All articles

OpenAI Agents SDK Sandbox Agents: The Production Isolation Playbook
Agents

OpenAI Agents SDK Sandbox Agents: The Production Isolation Playbook

Use OpenAI Agents SDK Sandbox Agents safely: choose the execution boundary, protect secrets, persist state, log runs, and gate production rollout.

CVE-2026-52869: Patch the MCP Python SDK Session Boundary
MCP

CVE-2026-52869: Patch the MCP Python SDK Session Boundary

Patch CVE-2026-52869 in the MCP Python SDK, identify affected HTTP transports, bind sessions to principals, and verify the fix before rollout.

GitHub Code Quality Review: The Production Rollout Rule
Coding

GitHub Code Quality Review: The Production Rollout Rule

GitHub Code Quality costs $10 per active committer plus AI and compute. This review shows what it gates, what it misses, and how to pilot it safely.

Repo Gardener build log
Agents

Repo Gardener build log

A weekly Claude Managed Agents workflow that reproduces reported bugs, derives issue hygiene mechanically, remembers verified rulings, and never posts without maintainer approval.

Agent Evaluation Frameworks: How to Test AI Agents in Production
Evals & Observability

Agent Evaluation Frameworks: How to Test AI Agents in Production

What an agent eval actually measures, which framework fits your stack (DeepEval, LangSmith, Braintrust, Phoenix), and the decision rule.

GitHub Copilot Code Review Custom Instructions for Production
Coding

GitHub Copilot Code Review Custom Instructions for Production

Configure GitHub Copilot code review instructions for production with secure head-branch trust boundaries, evals, merge controls, and cost telemetry.

GitHub Copilot Security Review vs CodeQL: What Can Block a Merge?
Coding

GitHub Copilot Security Review vs CodeQL: What Can Block a Merge?

Use Copilot /security-review for local triage and CodeQL rulesets for merge enforcement. Compare coverage, cost, evidence, and rollout controls.

Upgrade Steward build log
Agents

Upgrade Steward build log

An eve agent that researches breaking dependency changes, proves migrations in a sandbox, and binds pull request publication to human-approved evidence.

Claude Code Agent Teams Review: When Parallel Agents Pay Off
Coding

Claude Code Agent Teams Review: When Parallel Agents Pay Off

Use Claude Code agent teams only for independent work. Set file ownership, plan review, hook gates, spend limits, and teardown before parallel runs.

Datadog MCP Server Review: Production Guardrails for Agentic Incident Triage
MCP

Datadog MCP Server Review: Production Guardrails for Agentic Incident Triage

Review Datadog MCP Server limits, pricing, permissions, toolsets, audit logs, and the guardrails required for safe production incident triage.

LLM-as-a-Judge for Production Evals: Building a Judge You Can Trust
Evals & Observability

LLM-as-a-Judge for Production Evals: Building a Judge You Can Trust

Build an LLM-as-a-judge you can trust in production: calibrate against a golden set, control the biases, and know when it should not be the gate.

GitHub Copilot Usage Metrics: What the Dashboard Proves and Misses
Coding

GitHub Copilot Usage Metrics: What the Dashboard Proves and Misses

Use GitHub's usage API and managed OpenTelemetry together to measure Copilot adoption, runtime health, review flow, and rollout risk.

GPT-5.6 Terra vs Claude Sonnet 5 for Coding Agents: The Routing Rule
Coding

GPT-5.6 Terra vs Claude Sonnet 5 for Coding Agents: The Routing Rule

Use GPT-5.6 Terra for bounded coding-agent work and Claude Sonnet 5 for long context. Apply the routing policy and repository eval gate.

Claude Sonnet 5 for Coding: What Changes in Production
Coding

Claude Sonnet 5 for Coding: What Changes in Production

Roll out Claude Sonnet 5 behind an eval gate. Its launch pricing is strong, but tokenizer and API changes can alter cost, output length, and failures.

Claude Code MCP Servers: The Production Setup Guide
MCP

Claude Code MCP Servers: The Production Setup Guide

Add HTTP and stdio MCP servers to Claude Code, pick the right scope for your team, pin OAuth scopes, and set the timeouts production needs.

MCP 2026-07-28 Migration: Ship a Dual-Era Server
MCP

MCP 2026-07-28 Migration: Ship a Dual-Era Server

Migrate an MCP server to 2026-07-28 without breaking legacy clients. Use dual-era routing, state handles, conformance tests, and rollout gates.

Shotmap Agent build log
Agents

Shotmap Agent build log

A BYOK pre-production agent that turns rough video briefs into timed shot maps, continuity ledgers, and generator-ready prompt packets.

Supabase Vector Database for Production RAG
Stack

Supabase Vector Database for Production RAG

Use Supabase as the vector store when RAG still belongs in Postgres. Add RLS, HNSW, hybrid search, citations, and exit rules before launch.

Codex vs Claude Code Pricing and Usage Limits for Teams
Coding

Codex vs Claude Code Pricing and Usage Limits for Teams

Compare Codex and Claude Code pricing, usage windows, credits, API fallback, and rollout budget rules for production engineering teams.

LangChain Context Engineering for Production Agents
Agents

LangChain Context Engineering for Production Agents

Use LangChain context engineering to control state, tools, memory, compression, and evals before a production agent hits traffic.

Human Approval Gates for AI Agents
Agents

Human Approval Gates for AI Agents

Build HITL approval gates for AI agents: where to pause, what to log, how to resume, and how to prevent reviewer rubber-stamping.

AI Gateway for Production: Do You Need One, and Which to Use
Stack

AI Gateway for Production: Do You Need One, and Which to Use

What an AI gateway does, when you actually need one, and Vercel vs Portkey vs Cloudflare vs LiteLLM compared on real pricing and control.

Grok API Build Guide: xAI for Production Agents
Agents

Grok API Build Guide: xAI for Production Agents

Use the Grok API when live web/X search and tool-heavy agents matter. Here is the production checklist, pricing, limits, and controls to verify.

What Is an MCP Server? The Production Boundary for AI Tools
MCP

What Is an MCP Server? The Production Boundary for AI Tools

An MCP server is the production boundary for tools, resources, and prompts. Learn how MCP works, what to log, and where approvals belong.

OpenAI Prompt Caching for Production AI Apps
Stack

OpenAI Prompt Caching for Production AI Apps

Design OpenAI prompt caching around stable prefixes, cached_tokens telemetry, prompt_cache_key routing, and cost math before production traffic.

Agents

Repro Card Agent build log

A BYOK agent app for turning noisy bug evidence into coding-agent-ready repro cards.

How to Build an MCP Server for Production Internal APIs
MCP

How to Build an MCP Server for Production Internal APIs

Build an MCP server with typed tools, HTTP transport, OAuth, approval gates, logs, and a release checklist for internal APIs.

AGENTS.md vs CLAUDE.md for Production Coding Teams
Coding

AGENTS.md vs CLAUDE.md for Production Coding Teams

Use AGENTS.md as the shared repo contract and CLAUDE.md as the Claude adapter so Codex and Claude Code do not drift apart.

Claude Code Subagents for Production Teams
Coding

Claude Code Subagents for Production Teams

Use Claude Code subagents for bounded repo work: isolated context, scoped tools, approvals, hooks, memory, and worktree rules for production teams.

Agents

First Frame Agent build log

A BYOK agent app for turning rough product notes into image-to-video first-frame slates.

Agents

Agent Input Firewall build log

A Codex and Claude Code skill for quarantining untrusted external text before coding agents act.

Agents

type-led-launch-design build log

A DESIGN.md skill and static landing-page example for type-led technical product launches.

Agents

Shoot Card Agent build log

A BYOK visual director for turning rough product notes into shoot-ready image prompt cards.

Agents

Agent Config Audit Build Log

A build log for agent-config-audit, a Claude Code and Codex skill that reviews agent setup files before installation or execution.

Gemini CLI Plan Mode for Production Repos
Coding

Gemini CLI Plan Mode for Production Repos

Use Gemini CLI Plan Mode as a read-only design gate after the Antigravity cutover, with approval, sandbox, quota, and CI rules.

Agents

agent-ready-ui Build Log

A build log for agent-ready-ui, a skill that makes web UI flows reliable for browser and GUI agents without brittle selectors.

AI Agent Observability: What to Log Before Production
Evals & Observability

AI Agent Observability: What to Log Before Production

A production logging contract for AI agents: trace IDs, tool calls, retrieval, cost, eval scores, approvals, and alerts before launch.

Coding

design-md-drift-check Build Log

A build log for design-md-drift-check, a skill that checks DESIGN.md drift against real frontend tokens, components, and UI patterns.

Context Engineering vs Prompt Engineering for Production Agents
Agents

Context Engineering vs Prompt Engineering for Production Agents

Context engineering is the production control plane for agents. Learn when prompts matter, what context layers to ship, and what to log before traffic.

Agent Memory for Production AI Systems
Agents

Agent Memory for Production AI Systems

Design agent memory as governed state: what to store, what to forget, how to retrieve it, and which evals catch stale or unsafe recall.

MCP

Video Probe MCP Build Log

A build log for video-probe-mcp, a narrow MCP server that lets agents inspect local video and audio files with ffprobe.

Evals & Observability

Trace-to-Eval Builder Build Log

A build log for Trace-to-Eval Builder, a BYOK app that turns agent traces into replayable eval packs.

Evals & Observability

Agent Runbook Auditor: A BYOK Launch Review Tool for Agent Workflows

A build log for Agent Runbook Auditor, a BYOK OpenAI demo that reviews agent runbooks for launch risk, trace design, eval cases, guardrails, and rollout readiness.

AWS MCP Server for Production Agents: The Build-or-Boundary Rule
MCP

AWS MCP Server for Production Agents: The Build-or-Boundary Rule

Use AWS MCP Server for AWS-native agent access, then add custom approval, tenant policy, evals, and run logs where production risk starts.

Coding

CLAUDE.md File Best Practices for Production Teams

Write a CLAUDE.md that keeps Claude Code useful in production: scope memory, keep rules concise, move enforcement to hooks, and review drift.

OpenAI Agents SDK vs Pydantic AI for Production Agents
Agents

OpenAI Agents SDK vs Pydantic AI for Production Agents

Choose OpenAI Agents SDK for OpenAI-native runs. Choose Pydantic AI when typed Python, provider flexibility, and durable approvals matter.

Codex vs Claude Code vs Gemini CLI for Production Teams
Coding

Codex vs Claude Code vs Gemini CLI for Production Teams

A production rollout comparison of Codex CLI, Claude Code, and Gemini CLI after Google's Antigravity transition, with security and telemetry rules.

Vercel AI Gateway vs OpenRouter for Production Model Routing
model-stack

Vercel AI Gateway vs OpenRouter for Production Model Routing

Choose Vercel AI Gateway for Vercel-native routing and OpenRouter for broad provider reach. Compare pricing, failover, BYOK, and observability.

MCP Sampling vs Elicitation for Production Servers
MCP

MCP Sampling vs Elicitation for Production Servers

Use MCP sampling for client-owned model calls and elicitation for user input. Set the production boundary, approval flow, and logging rules.

Hybrid Search for Production RAG: The BM25, Vector, and Rerank Rule
RAG

Hybrid Search for Production RAG: The BM25, Vector, and Rerank Rule

Use hybrid search when vector-only misses exact terms. Compare BM25, vectors, fusion, reranking, evals, and the production logging gate.

Claude Code Planning Mode for Production Teams
Coding

Claude Code Planning Mode for Production Teams

Use Claude Code planning mode as a production review gate: when to plan first, how to approve safely, and what teams should log before rollout.

Google ADK vs LangGraph for Production Agents
Agents

Google ADK vs LangGraph for Production Agents

Compare Google ADK and LangGraph for production agents: state, human approval, deployment, observability, pricing, and the decision rule.

MCP Resources vs Tools: The Production Server Rule
MCP

MCP Resources vs Tools: The Production Server Rule

Use resources for client-controlled context, tools for model-invoked actions, and prompts for reusable user-selected workflows.

MCP Authorization for Production Servers
MCP

MCP Authorization for Production Servers

Build MCP authorization with OAuth, Protected Resource Metadata, token audience checks, consent, approvals, logs, and production release gates.

OpenAI Agents SDK TypeScript vs Python for Production Agents
Agents

OpenAI Agents SDK TypeScript vs Python for Production Agents

Choose TypeScript or Python for OpenAI Agents SDK by production ownership: product runtime, worker path, tracing, guardrails, handoffs, MCP, and evals.

Claude Code Security Review for Production Teams
Coding

Claude Code Security Review for Production Teams

Use Claude Code security review as early signal, not an approval gate. Here is the rollout pattern, CI split, permissions, hooks, and logs.

OpenAI Agents SDK Tracing: What It Shows in Production
Evals & Observability

OpenAI Agents SDK Tracing: What It Shows in Production

Use OpenAI Agents SDK tracing as run inspection, not full observability. Configure sensitive data, flushing, trace exports, evals, and approvals.

Gemini CLI vs Antigravity CLI: The Production Migration Rule
Coding

Gemini CLI vs Antigravity CLI: The Production Migration Rule

Google is moving Gemini CLI users to Antigravity CLI. Compare migration work, access risk, controls, and when to choose Claude Code or Codex.

Model Routing for Production AI Apps
model-stack

Model Routing for Production AI Apps

A production workflow for model routing across managed routers, provider marketplaces, and app-owned policy layers.

AI Agent Observability Tools for Production Teams
ai-ops

AI Agent Observability Tools for Production Teams

Compare LangSmith, Langfuse, Phoenix, and Helicone for production AI agent traces, evals, cost telemetry, and approval control.

Prompt Versioning for Production AI Systems
ai-ops

Prompt Versioning for Production AI Systems

Version prompts with code, evals, promotion labels, rollback, and run telemetry after OpenAI deprecated reusable prompt objects.

RAG Evaluation Metrics Before Launch
RAG

RAG Evaluation Metrics Before Launch

Use a production RAG eval gate for retrieval quality, groundedness, answer correctness, answer relevance, and regression risk.

Human-in-the-Loop AI Agents: Approval Gates for Production
ai-ops

Human-in-the-Loop AI Agents: Approval Gates for Production

Where to put human approval gates, how to preserve agent state, what reviewers need, and when to move from human-in-the-loop to monitored automation.

Agents

LangChain vs LangGraph for Production Agents

Use LangChain for simple agent harnesses. Use LangGraph when production agents need durable state, retries, interrupts, approvals, and deployment.

AI Agent Monitoring: What to Track Before Production Traffic
ai-ops

AI Agent Monitoring: What to Track Before Production Traffic

Trace runs, score outcomes, attribute cost, and route risky actions before production AI agents receive more traffic.

MCP Security Best Practices for Production Servers
MCP

MCP Security Best Practices for Production Servers

Ship MCP servers with per-client consent, audience-bound tokens, strict schemas, approval gates, isolation, and logs that catch tool abuse.

Codex vs Claude Code for Production Teams
Coding

Codex vs Claude Code for Production Teams

Claude Code is the better first rollout for terminal-first teams. Codex wins for delegated cloud tasks, PR review, and compliance-visible agent work.

Claude Code Pricing for Teams: The Production Rollout Cost
Coding

Claude Code Pricing for Teams: The Production Rollout Cost

Claude Code pricing starts at $20, but teams need a seat mix, usage credits, API fallback controls, analytics, and rollout policy.

Pgvector vs Pinecone for Production RAG
RAG

Pgvector vs Pinecone for Production RAG

Choose pgvector when retrieval belongs in Postgres. Choose Pinecone when scale, namespaces, or managed ops justify a separate vector system.

Claude Code Hooks for Production Teams
Coding

Claude Code Hooks for Production Teams

Use Claude Code hooks as deterministic team guardrails for tests, protected files, command logging, permissions, and safe rollout.

OpenAI Agents SDK vs LangGraph for Production Agents
Agents

OpenAI Agents SDK vs LangGraph for Production Agents

Choose OpenAI Agents SDK for OpenAI-native loops. Choose LangGraph when durable graph state, provider freedom, and custom control matter.

MCP vs Function Calling: The Production Decision Rule
MCP

MCP vs Function Calling: The Production Decision Rule

Use function calling for app-local tools. Build MCP when a capability must be shared, discovered, approved, logged, and reused across agents.

Claude Code vs Cursor for Production Teams
Coding

Claude Code vs Cursor for Production Teams

Use Cursor for daily IDE work and Claude Code for governed terminal delegation. Compare costs, controls, security, and rollout rules.

Langfuse vs LangSmith for Production Observability
Evals & Observability

Langfuse vs LangSmith for Production Observability

Choose Langfuse for self-hosted, framework-neutral traces. Choose LangSmith for managed LangChain evals, review, alerting, and deployment.

Newsletter

One letter, every week. Working systems — not hot takes.

Build logs, agentic engineering decisions, agent failures, evals, and what survives real users. Sent weekly, never more.

Weekly. No spam. Unsubscribe anytime.