Writing

Engineering insights from 9+ years of building at scale.

20 articles
Cover image for Stop Feeding Your LLM Raw Command Output: How RTK Cuts Tool Tokens by 60–90%
ai-engineeringdeveloper-productivitytoolingclaude-codetoken-optimization

Stop Feeding Your LLM Raw Command Output: How RTK Cuts Tool Tokens by 60–90%

Caveman compresses what agents say. RTK compresses what they read — filtering git, tests, and ls before that noise burns your context window. Here's how I wired it into Cursor and Claude Code.

5 min read
Cover image for How I Write a Design Doc in 2 Hours (Not 2 Weeks)
engineering-practicesarchitecturedeveloper-productivitydocumentationengineering-leadership

How I Write a Design Doc in 2 Hours (Not 2 Weeks)

A practical, time-boxed framework to go from a blank page to a signed-off technical architecture in exactly 120 minutes.

5 min read
Cover image for RFCs vs ADRs: Which One Should You Actually Write?
engineering-practicesarchitecturedocumentationdecision-makingengineering-leadership

RFCs vs ADRs: Which One Should You Actually Write?

Most teams pick one and force every decision through it. After authoring 40+ engineering standards across enterprise and startup contexts, here's the framework I use to choose between RFCs and ADRs — and when to skip both.

5 min read
Cover image for AI‑Native Time Management
ai-engineeringdeveloper-productivitytime-managementci-cdengineering-leadership

AI‑Native Time Management

How modern engineering leads transition from manual coding to AI orchestration, leveraging agentic CI/CD workflows to recover six hours per week and reduce cognitive load.

5 min read
Cover image for The 3 Code Smells Even Advanced AI Misses Every Time (Why Human Staff Engineers Still Win)
ai-engineeringcode-qualitycode-reviewengineering-practicestechnical-debt

The 3 Code Smells Even Advanced AI Misses Every Time (Why Human Staff Engineers Still Win)

After integrating AI coding assistants into production workflows, I've learned they excel at syntax but fail spectacularly at context—here are the three code smells only human engineers catch.

5 min read
Cover image for What 1,900 Caveman-Mode Messages Taught Me About AI Token Compression
ai-engineeringdeveloper-productivitytoolingclaude-codeagentic-workflows

What 1,900 Caveman-Mode Messages Taught Me About AI Token Compression

I tracked every session where Caveman mode was actually active — Docker refactors, PDF fixes, PR review loops, and an always-on Electron project. Here's what ~68,000 output tokens of compressed agent replies looked like in practice.

6 min read
Cover image for From Cognitive Load to Golden Path: Architecting AI Agents into Your DevEx Platform
ai-agentsdeveloper-experienceplatform-engineeringcognitive-loadci-cdai-engineering

From Cognitive Load to Golden Path: Architecting AI Agents into Your DevEx Platform

We've all felt the drag of cognitive load in software development. As an experienced engineer, I've seen firsthand how AI agents, strategically integrated into our DevEx platforms, can transform this burden into a seamless 'golden path,' significantly boosting productivity and quality.

5 min read
Cover image for 5 Questions Before Merging Agent PRs
ai-engineeringcode-reviewagentic-workflowsengineering-practicesci-cd

5 Questions Before Merging Agent PRs

AI agents can generate PRs at superhuman speed — but merging them without scrutiny is how you ship technical debt at scale. Here are the 5 questions I ask before every agent-generated PR gets approved.

5 min read
Cover image for When I Reach for Cursor vs Claude Code: Lessons from 6 Months of Enterprise Agentic Workflows
ai-engineeringdeveloper-toolscursorclaude-codeproductivityagentic-workflows

When I Reach for Cursor vs Claude Code: Lessons from 6 Months of Enterprise Agentic Workflows

I use both Cursor and Claude Code daily across enterprise workstreams. After 6 months, I've developed a clear mental model for when each tool earns its place—and the answer isn't what most comparison posts suggest.

5 min read
Cover image for The Invisible ROI of Developer Experience: Eliminating Friction Beyond Keystrokes
developer-experienceplatform-engineeringproductivitydevops

The Invisible ROI of Developer Experience: Eliminating Friction Beyond Keystrokes

Developer experience isn't just about faster builds and AI autocompletion. It's about treating your internal engineering workflow as a tier-one product to reduce cognitive load and eliminate paper cuts.

5 min read
Cover image for The Tech Lead's New Job: Directing AI Agents Across 3 Workstreams
engineering-leadershipai-engineeringtech-leadproductivityagentic-workflows

The Tech Lead's New Job: Directing AI Agents Across 3 Workstreams

The role of tech lead has fundamentally shifted from writing code to orchestrating AI agents. Here's my framework for managing three concurrent engineering workstreams with AI teammates that never sleep.

4 min read
Cover image for When Reliability Meets Abuse: Rate Limits and Request Signing as SRE Controls
srerate-limitingsecurityapi-designreliabilitynode-js

When Reliability Meets Abuse: Rate Limits and Request Signing as SRE Controls

How I implemented rate limiting and request signing to protect a fintech platform serving 400K+ users from abuse — while keeping the system reliable for legitimate traffic.

4 min read
Cover image for Beyond the Hype: How We Actually Cut Boilerplate by 30% with AI Coding Assistants
ai-engineeringdeveloper-productivitycode-qualityengineering-practicesclaude-code

Beyond the Hype: How We Actually Cut Boilerplate by 30% with AI Coding Assistants

AI coding assistants didn't magically write our features—but a disciplined, three-lane workflow cut boilerplate-heavy effort by 30%. Here's exactly what worked and what didn't.

4 min read
Cover image for How We Stopped Node.js Container OOM Crashes Under Heavy Load by Switching to jemalloc
nodejsperformancedockermemory-managementdevops

How We Stopped Node.js Container OOM Crashes Under Heavy Load by Switching to jemalloc

Our Node.js containers kept crashing under load despite 40% heap headroom. The culprit wasn't a memory leak — it was the allocator itself.

4 min read
Cover image for Automating Accessibility Audits in React with CI/CD
accessibilityreactci-cdgithub-actions

Automating Accessibility Audits in React with CI/CD

Discover how to integrate automated accessibility auditing tools directly into your React development workflow and CI/CD pipelines to guarantee WCAG 2.1 AA compliance before shipping code.

5 min read
Cover image for The 3-Layer Observability Stack That Cut Our MTTR by 30%
observabilityplatform-engineeringsreopentelemetrymonitoring

The 3-Layer Observability Stack That Cut Our MTTR by 30%

How we stopped relying on disjointed dashboards to debug production issues, and built a unified telemetry pipeline using SLOs, OpenTelemetry, and structured logging.

6 min read
Cover image for Building an Agentic PR Generator: A Deep Dive
ai-engineeringgithubdevopsagents

Building an Agentic PR Generator: A Deep Dive

Learn how to build a local AI agent that autonomously commits code, manages versioning, and creates Pull Requests — complete with the exact system prompt and GitHub MCP setup.

10 min read
Cover image for How I Save 6 Hours Per Engineer Weekly with Agentic CI/CD Workflows
ai-engineeringci-cdgithub-actionsclaude-code

How I Save 6 Hours Per Engineer Weekly with Agentic CI/CD Workflows

A practical look at how I integrated Claude Code and GitHub Copilot into our CI/CD pipeline to automate PR creation, targeted code reviews, and quality gates — recovering 6+ hours of manual overhead per engineer, per week.

9 min read
Cover image for Shifting Accessibility Left: How We Cut WCAG 2.1 AA Bugs by 45% Before They Hit Production
accessibilitywcagci-cdengineering

Shifting Accessibility Left: How We Cut WCAG 2.1 AA Bugs by 45% Before They Hit Production

A practical guide to embedding accessibility checks directly into your CI/CD pipeline using ESLint, AI-based PR reviews, and 40+ engineering standards — so bugs never reach your users.

10 min read
Cover image for From 400K Users to 99.9% Uptime: Lessons from Scaling a Fintech Microservices Platform
architecturemicroservicesawsfintech

From 400K Users to 99.9% Uptime: Lessons from Scaling a Fintech Microservices Platform

How we migrated ByajBook from a fragile monolith to a distributed microservices architecture on AWS ECS — cutting infra costs by 35% while keeping the lights on for 400K users.

12 min read