Joshua McDonald·3d agoAgents Read Your Schema NowBottom line. When you publish data through an MCP server, publish three things with every field: why the number matters, how it was…A response icon1A response icon1
Joshua McDonald·Nov 8Nobody Read Past Your First ParagraphBottom line. Storytelling is a core engineering skill. A pull request description, a design doc, a postmortem and a leadership review all…
Joshua McDonald·Oct 31Deletion as a MetricBottom line. Add a line called Removed to every engineering status update and count deletions by team: net lines of code, services retired…A response icon1A response icon1
Joshua McDonald·Oct 27Anyone Can Build the Complicated VersionBottom line. Before building anything, write the problem in one sentence with no technology in it, then ask what can be removed before…A response icon2A response icon2
Joshua McDonald·Oct 6You Probably Need a Scorer, Not Another LLM CallSmall single-purpose models answer one question with one number between 0 and 1. What that number means, how to pick the cutoff, and how to…
Joshua McDonald·Sep 29In Defense of the Simple ChecklistWhen the work gets complicated enough that nobody can hold it in their head, five lines on a page will do more than another meeting.A response icon2A response icon2
Joshua McDonald·Sep 24Your AI Model Has a Retirement DateWhat survives a model change, what expires with it, and how to split your team’s effort between the model you ship and the one that…
Joshua McDonald·Sep 22Fewer Wrong Exits: The Wayfinding Method Behind DC Metro’s New SignsHow WMATA replaced fifty years of piecemeal signage with decision points, progressive disclosure, and error-targeted design, and how to run…
Joshua McDonald·Sep 16Your First Month Leading a New Team, Week by WeekRead and ask in week one, test what you heard in weeks two and three, set direction by month one. AI compresses about half the work.