Notes

Lab notebook from building my agent operating system. Tutorials I've watched, patterns worth naming, recipes that work, decisions and why I made them. Polish optional, half-thoughts welcome.

Source: github.com/Atemndobs/agent-os-notes · auto-syncs hourly

DecisionApr 26, 20262 min read

Why I split my agent OS into 5 layers

A mental model for organising vendor stuff, personal extensions, knowledge, business code, and presentation into clean layers — and why a monorepo is the wrong answer.

architecturelayeringseparation-of-concerns

PatternApr 26, 20262 min read

Hermes plugin architecture — manifest, API, frontend, slot

The four-file shape every Hermes dashboard plugin follows, the SDK surface available to the frontend, and how plugins compose into pages, slots, or both.

hermespluginsarchitecturereact

RecipeApr 26, 20261 min read

Zero-conflict upstream pulls — keep your fork pristine

How to follow upstream Hermes (or any vendor repo) without ever fighting merge conflicts. The trick is to never modify upstream files in the first place.

githermesworkflow