The letter

One letter a week, starting soon.

The week's signal, what shipped, what is worth running tonight, and the editor's note. No tracking, no ads, nothing else.

We keep your address, your language and the date you joined, nothing else. Every letter has a one-click unsubscribe link that deletes the record.

← Accept All   Editor’s notes
Editor’s note

Every Codebase Needs a Drawer It Isn't Ashamed Of

2026.11.15Yuki Halvorsen

The folder on my laptop is called misc, has been for about a year, and I open it with something close to shame. Inside: a retry wrapper I wrote at two in the morning, three versions of the same prompt template with no note on which one I actually trust, an eval script I started and abandoned, and a file literally named old_but_works.py that I touch twice a month and have never once renamed.

A note Google's developer team published this week walks through how they sorted their own agent-building repository instead of letting it become a misc folder with better marketing. Three layers: core, the pieces they will stand behind and support like a product; plugins, official extensions you can add or remove without touching the center; contrib, everything the wider community sends in, useful and welcome, but not yet carrying the same promise.

The trick isn't the three names. It's that a file's address now tells you its trust level before you've read a single line of it. Something breaks in core, that's on the maintainers, full stop. Something breaks in contrib, you already knew the risk the moment you imported from that folder, because the folder told you. No comment block required, no tribal knowledge passed down in a Slack thread nobody can find again. The structure is the documentation.

I did the embarrassing version of this tonight, on misc, not a 200,000-line monorepo, just mine. Three new folders, and the sorting was less about tidiness than confession. The retry wrapper, which every one of my agents calls dozens of times a day, obviously belonged in core — I'd just never given it a real address, so I kept treating it as temporary, a year in. The eval script went to contrib, honestly labeled for the first time: good enough to keep, not good enough to trust blind.

The laptop is still open. misc is empty now, an actual empty folder with nothing left inside it to be ashamed of, which is a strange, small kind of relief to feel at one in the morning over three new directories and nothing else.

On the wire this week

  1. Three layers, one repo: a tour of google/adk-recipes Google Developers Blog

Yuki Halvorsen was born in Sapporo to a Norwegian father and a Japanese mother, wrote her first program on a school computer that took ten seconds to draw a circle, and spent eight years as an engineer in Stockholm before Tokyo pulled her back. She still ships something small every night, believes the only honest review of a model is the thing you built with it, and writes Accept All from a desk in Nakameguro where the terminal is always open.