Skip to main content

5 posts tagged with "engineering"

View All Tags

The endless thread is a smell

· 3 min read

A lot of new AI coding tools seem to be built around the same idea: start a thread, keep feeding it work, and let it run forever. I don't understand the appeal.

You can see the assumption hardening into product features. Claude Code lets you name sessions, find and resume them by name, branch them, and export their transcripts. Why would a coding conversation need a name? Cursor has editable chat titles, stored history, Markdown exports, and a way to pull old chats into the current one. They sound intuitive features to add at first, but they're based on the premise that a conversation is a durable unit of work rather than a temporary interface for completing a specific task.

Adding a links field to API responses

· 2 min read

We added a links field to our APIAPI A set of rules and protocols that allows different software applications to communicate with each other. APIs define the methods and data formats that applications can use to request and exchange information. response objects this week. Small change, and I'd put it off for a while because it felt like ceremony. It isn't.

Communicating state and events in API design

· 18 min read

A status field is a contract. It is also the place where most APIsAPI A set of rules and protocols that allows different software applications to communicate with each other. APIs define the methods and data formats that applications can use to request and exchange information. quietly leak ambiguity, a single word doing the work of three, consumed by people who weren't in the room when you named it. Get it right and an integrator can build correct handling from the payload alone. Get it wrong and they reverse-engineer your intentions from support tickets.

Stop abbreviating in your APIs

· One min read

A small plea: stop abbreviating field and method names in your APIsAPI A set of rules and protocols that allows different software applications to communicate with each other. APIs define the methods and data formats that applications can use to request and exchange information., SDKsSDK A collection of software development tools, libraries, documentation, code samples, and guides that help developers create applications for a specific platform or framework., and config.

Maybe I'll send an email once in a while

Monthly digest. No spam.