Building a Claude Code Agentic OS
The value of an "Agentic OS" is under the hood, not the dashboard: skills, loop engineering, and a memory/state layer. Levels 1–2 are ~90% of the payoff and work in the plain terminal — no UI required.
TLDR
- The value of an “Agentic OS” is under the hood, not the dashboard: skills, loop engineering, and a memory/state layer. Levels 1–2 are ~90% of the payoff and work in the plain terminal — no UI required.
- Level 1 = codify every repeated Claude Code task into a skill, then an automation, then a self-improving loop. Level 2 = give Claude a navigable memory vault (coherent file structure +
index.mdmaps at every level). - Levels 3–4 (visual dashboard, distribution to non-technical teammates/clients) are the cherry on top: buttons that fire headless
claude -pruns so people get Claude’s power without touching the terminal.
Caveman
Turn your repeated work into buttons Claude presses.
ELI5
Instead of asking your AI helper to do the same jobs by hand every time, you write down each job as a reusable recipe and organize your notes so the helper can find anything fast. Once that’s solid, you can wrap it in a dashboard with buttons so even people who fear the computer terminal can use it.
Trunk → Branches
Trunk: Most of an Agentic OS’s value is codifying your repeated workflows into skills and giving Claude a well-mapped memory — the visual layer is optional polish on top of that. Branches:
- Four levels, front-loaded value: (1) skills + loop engineering, (2) memory/state, (3) visual UI, (4) distribution — and levels 1–2 are where ~90% of the value lives and can run entirely in the terminal [1:47–2:48, 30:22].
- Start with a workflow audit — you can’t build skills until you know which specific outputs you produce daily/weekly; three ways to surface them: do it manually, have Claude mine your last N sessions, or have Claude interview you from a stream-of-consciousness dump [4:49–9:26].
- Codify → automate → loop: turn each audited task into a skill (via the skill-creator skill, ideally after you’ve run it manually once to validate), then convert stable skills into scheduled automations (Claw Desktop → routines), then add self-improvement loops that read past runs [6:51–12:03].
- Memory is just a coherent file structure, not necessarily Obsidian or a database: a sensible folder layout gets you ~99% there; Obsidian is only chosen because it’s free and easy [13:41–14:08].
- The Karpathy vault pattern (raw → wiki → outputs) is popular, but the real lever is an
index.mdat every level acting as a table of contents/map so Claude navigates fast and cheap; the specific folders are arbitrary [17:20–21:16]. - A vault-root
CLAUDE.mddocuments vault conventions and a navigation pattern (“when looking for X, follow this path”), making the map explicit and portable to any structure [21:34–22:05]. - Level 3–4: a web app or Obsidian plugin surfaces custom metrics and turns skills/automations into one-click buttons; clicking one calls a headless
claude -prun. Web apps distribute easily (GitHub/zip); Obsidian setups need hands-on setup per person [23:24–29:21].
Key Patterns
- Pattern: Codify-then-automate the tasks you already repeat, because the ROI comes from frequency × consistency, not novelty — transfers to any tooling (shell scripts, CI, macros): the highest-leverage automation targets are the boring things you already do by hand daily.
- Pattern: An
index.mdat every folder level is a cheap map that cuts retrieval cost, because it gives the agent a deterministic path instead of scanning a “morass” of files — transfers to any RAG/codebase-navigation problem: structure + a signpost beats a bigger pile of raw docs. - Pattern: Wrap validated back-end capability in one-click buttons to raise the floor for non-technical users, because the value was always the skill, not the interface — transfers to client deliverables: hide the terminal, expose the outcome.
Stress Test
- Hidden assumption: You have enough genuinely repeated, well-defined workflows that codifying them pays back the upfront build time — and that you’ll actually maintain the skills/vault as your work drifts.
- Best counterargument: For a solo dev, a good
CLAUDE.mdplus ad-hoc prompting may capture most of this value; the multi-level “OS” framing can become architecture-astronaut yak-shaving that produces a pretty dashboard and little shipped work. - Fails when: Your work is novel/exploratory rather than repetitive (skills go stale faster than they pay off), or building the OS becomes procrastination that displaces the actual client/product work.
- Fact vs opinion: “Levels 1–2 are 90% of the value” and the “10x” title are the author’s framing/marketing, not measured. The whole video is also self-promotion for his paid course (sponsor disclosed at 3:39 as “me”), so treat the “you’re falling behind” urgency as a sales frame.
In Practice
- Prompt Claude Code to mine your last ~10 sessions for repeated tasks and output a table of task → desired output → proposed skill ¶8:26
- Stand up the Level 1–2 backbone ¶4:26
- Run a workflow audit: pick manual, past-session mining, or interview ¶9:26
- Turn each validated repeated task into a skill via skill-creator ¶6:51
- Convert stable skills into scheduled automations (Claw Desktop → routines) ¶11:36
- Add an
index.mdat every vault level as a nav map ¶20:13 - Write a vault-root
CLAUDE.mdwith conventions + a navigation pattern ¶21:34
- Restructure your vault around
index.mdmaps (Karpathy raw→wiki→outputs only if it fits your data); measure whether Claude’s answers get faster/cheaper ¶17:20 - Prototype a dashboard whose buttons fire skills via headless
claude -p, then review whether the UI earns its build cost vs. staying in the terminal ¶26:18
Connections
- Why RAG Fails on Complex Documents — this note’s own claim that an
index.mdmap “transfers to any RAG problem” lands directly here: both say structure + signposting beats a bigger pile of raw docs (or a bigger model). - Hermes Agent Fundamentals — the same blueprint from the memory angle: layered core-files + session-search + an Obsidian vault plus “make this a skill” and cron is this OS’s skills-and-automations-over-an-indexed-vault, spelled out.