Productivity

Scout-and-Wave, Part 4: Trust Is Structural
The Scaffold Agent doesn’t add capability. It restores a review gate that was cosmetically present but structurally absent. The worktree isolation trip wire catches failures that were invisible until merge time. Neither fixes a bug in the traditional sense. Both fix trust.
Scout-and-Wave, Part 2: What Dogfooding Taught Us
Scout-and-wave v0.1.0 worked. Then we ran it on documentation agents, measured the overhead honestly, and learned that raw agent count is a bad proxy for when parallelism is worth it. This post covers the audit-fix-audit loop, the dogfooding experiment that confirmed SAW was 88% slower than sequential for that job, SAW Quick mode for small disjoint work, and the bootstrap problem for new projects.
Scout-and-Wave, Part 3: Five Failures, Five Fixes
The scout refused to write the IMPL doc. Forty-five percent of agents arrived at work already done. The skill file grew to 400 lines with no separation of concerns. Each failure drove a specific fix — and each fix is traceable to an exact incident in an exact run. This is the scout prompt’s bug tracker.
Scout-and-Wave: A Coordination Pattern for Parallel AI Agents
Naive parallel agents step on each other. The scout-and-wave pattern solves this by front-loading dependency mapping: one throwaway agent identifies seams and builds a living coordination artifact before any implementation begins. Development then proceeds in waves, each consuming and updating the artifact for the next.
Mastering ZSH: Part 4 - Completion System Demystified
Part 4: Learn how ZSH completions work under the hood. Build custom completions for your scripts, understand _arguments and completion contexts, and make tab completion actually useful.
Mastering ZSH: Part 3 - Understanding Your Prompt: How Powerlevel10k Actually Works
Everyone uses Powerlevel10k, but do you understand how that fancy prompt actually works? Learn the ZSH primitives behind instant git status, command timing, and async rendering.
Mastering ZSH: Part 1 - Hooks and Automation
Complete guide to ZSH hooks: automate prompts, time commands, activate virtualenvs on cd, and filter secrets from history–without slowing down your terminal.
Mastering ZSH: Part 2 - Line Editor and Custom Widgets
ZLE lets you create custom keybindings that manipulate your command line. Learn the fundamentals, build practical widgets (insert git branch, fuzzy file search), and understand how fzf integrates with ZSH.
Managing Multiple Claude Code Contexts Without Going Insane
I work on OSS projects, client work, and employer projects. Each needs different Claude Code configuration. Here’s how I stopped manually editing CLAUDE.md every time I switched contexts.