Category
AI
- ·3 min read
Tracking Tokens-Per-Session: The Number Claude Code Hides
Tokens-per-session is the single most useful signal for agentic coding sessions — and Claude Code doesn't show it. /usage gives you cost. /context gives you window percent. Neither sums to the number you actually want. Here's what to track, why, and how to put it on your statusline.
- ·3 min read
Your Statusline is the Cheapest Feedback Loop in Agentic Coding
Most teams using Claude Code, Cursor, or Aider leave the statusline at default. It's a one-line strip of pixels that costs you nothing, sees zero tokens, and can change every decision you make during a session.
- ·3 min read
design.md, DESIGN.md, and Google Stitch: One File, Narrower Views
There's a popular framing that AGENTS.md is for coding agents and DESIGN.md is for design agents. That framing is a category error. Write one file; serve both.
- ·3 min read
How I Actually Wrote This Site's design.md
Parts 4–9 were the templates. This is the living artifact — a section-by-section tour of the design.md that powers this site, the calls I made, the rules that stuck, and the lines I would write differently if I started over.
- ·3 min read
The Agent-Ready Audit: A Runnable Checklist for Any React Codebase
One bash script, six numbers, an opinion about each. Run it on Monday morning and you have a prioritised list of what to fix before agents can help.
- ·3 min read
MIGRATIONS.md Recipes: Six Concrete Stack-Pair Migrations
Part 2 said write a MIGRATIONS.md. This post is six concrete recipes — one per common stack pair — that any agent can execute end-to-end.
- ·3 min read
design.md for a Tailwind + shadcn/ui Codebase
Utility-first codebases need a design.md more, not less. Without one, agents reach for every utility class in the bundle. Here is the full file.
- ·3 min read
design.md for a Chakra UI v3 Codebase: Recipes, Tokens, Rules
Chakra v3 changed the game with recipes and semantic tokens. Here is the complete design.md that takes advantage of both — copy, swap your brand, ship.
- ·3 min read
The Quiet Platform Shift: Why Orchestration Layers Like Multica and Paperclip Matter More Than the Next Model
Every conversation about AI in software has quietly moved one altitude up. The interesting question is no longer which model — it's what runs above them. A survey of agent orchestration platforms, from Multica and Paperclip to CrewAI, LangGraph, MetaGPT and ChatDev, and a light forecast of where this is heading.
- ·3 min read
My AI Toolkit, Four Weeks In: Models, Harnesses, and Everything Else I Actually Reached For
A no-marketing inventory of the models, agent harnesses, and supporting tools I used day-to-day over the last four weeks — what each is good at, what it isn't, and what I'd reach for first next time.
