⌂ HQ Brain Vault Scripts Content KAIRO ยท CLAUDE.md Audit
๐Ÿงญ KAIRO ยท CLAUDE.md AUDIT
โ† Hub Vault

Every brain, one map.

Full sweep of every CLAUDE.md across the empire, July 11 2026. Why the Desktop app ignored your style, where each memory lives, and what got fixed today.

46
CLAUDE.md files on the map
0
had your style rules at audit (root cause)
43
carry the style block NOW
0
folders missing a CLAUDE.md (sentinel enforced)
264
em dashes stay, your call Jul 11

๐Ÿง  The Five Brains where everything lives

1 ยท MASTER (CLI rules)
~/.claude/CLAUDE.md
Loads in every Claude Code CLI session. Majesty rule, TLDR, no-em-dash law all live here. 77 lines, clean.
2 ยท KAIRO INDEX
~/CLAUDE.md
Thin 25-line pointer. Any session under your home folder inherits it as parent context. Status lives in STATE.md, not here.
3 ยท PROJECT MEMORY
<project folder>/CLAUDE.md
Per-project truth. As of today, every one should also carry the 6-line style block so ANY app opening the folder behaves.
4 ยท DESKTOP / COWORK TREE
~/Documents/Claude/Projects/
Owned by the Desktop app. Sessions there load ONLY the folder's CLAUDE.md, not the master. That is exactly why your kairo-voice session skipped the majesty rule and TLDR.
5 ยท AUTO-MEMORY (this CLI)
~/.claude/projects/-Users-ant-mba-KAIRO/memory/
ChatGPT-style persistent memory for KAIRO CLI sessions. Your style prefs got re-locked here today.

๐Ÿ—‚ Why projects live in TWO places the Building Side Apps answer

Not drift. A locked rule from the Jul 8 harness audit. The Desktop app (Cowork) auto-creates its own project folders under ~/Documents/Claude/Projects/. Moving or symlinking them out breaks the app, so the rule is: leave them, register each one in the picker registry instead.

BUILDING SIDE APPS holds 3 shipped Mac apps born in Cowork sessions: Summon, Pulse for Claude, pipeline-dashboard. All 3 are registered in PROJ_REGISTRY, and the Jul 10 vault excavation already flagged them for adoption.

Navigation without jumping around: the proj picker in your shell, this dashboard, and the hub. Physical consolidation is NOT recommended; the app owns that tree.

๐Ÿ“ KAIRO projects ~/KAIRO/projects ยท 19 folders + _archive

kairo-voicevoice engine (speak.sh + framework)dieted 786 โ†’ 338 by Desktop sessionhands off per Anthony
task-buddyiOS ADHD nag app214Lstyle โœ“39 em dash
eai-clubEveryday AI Club course + community299Lstyle โœ“3 em dash
content-trainercontent training pipeline (Skool)231Lstyle โœ“0 em dash
ai-overlayscreen AI overlay experiments207Lstyle โœ“0 em dash
image-forgegpt-image-2 production pipeline153Lstyle โœ“13 em dash
script-forgeTHE content script doorway154Lstyle โœ“12 em dash
orion-maintenanceOrion client maintenance belt151Lstyle โœ“13 em dash
offer-laboffer creation lab152Lstyle โœ“11 em dash
orion-ai-coOrion AI Co agency HQ148Lstyle โœ“5 em dash
digital-productsdigital product lab131Lstyle โœ“5 em dash
dogs-healthThor + Bolt health tracking122Lstyle โœ“8 em dash
financial-auditpersonal finance audit89Lstyle โœ“10 em dash
kasp-macMac-control MCP + KASP safety89Lstyle โœ“0 em dash
cli-to-websiteearly CLI-to-website pipeline71Lstyle โœ“0 em dash
operation-exodusAustin move, Dec 1 hard deadline44Lstyle โœ“0 em dash
studio-lightsSiri + BLE studio lights24Lstyle โœ“0 em dash
OF-Modelpurpose unknown, fill on first sessionSCAFFOLDED TODAY โœ“ style block in
obsidian-templatesObsidian vault templatesSCAFFOLDED TODAY โœ“ style block in

๐Ÿ–ฅ Desktop / Cowork tree ~/Documents/Claude/Projects

Summonmenu-bar AI app, shipped, in picker as "summon"58Lstyle โœ“
Pulse for ClaudeClaude monitor app, shipped, in picker as "pulse"27Lstyle โœ“
pipeline-dashboardpipeline dashboard app, in pickerSCAFFOLDED TODAY โœ“
BUILDING SIDE APPScontainer for the 3 side apps aboveSCAFFOLDED TODAY โœ“
Big red folderroute 10607 spreadsheets (Allen work)SCAFFOLDED TODAY โœ“
Kairo Strategicstrategy docs + PDFs from Desktop sessionsSCAFFOLDED TODAY โœ“
The Beauty studio + Livclient concept folderSCAFFOLDED TODAY โœ“ x2
roof restoration solutionsRRS deliverables built in Desktop (client folder proper is ~/Clients)SCAFFOLDED TODAY โœ“

๐Ÿ’ผ Clients + Dev ~/Clients ยท ~/Dev

roof-restoration-solutionsclient353L69 em dash, worst offenderstyle โœ“
washworks-expressclient397L25 em dashstyle โœ“
bo-bbqclient120L14 em dashstyle โœ“
bobby-mooreclient, transport calculator201L4 em dashstyle โœ“
la-insuranceclient195L2 em dashstyle โœ“
enriched-barber-studioclient111L1 em dashstyle โœ“
tiktok_transcriberdev, media transcriber257L22 em dashstyle โœ“
kairo-hqdev, HQ dashboard repo251L0 em dashstyle โœ“
tiktok_to_shortsdev107L8 em dashstyle โœ“
remotion-videosdev, video builds83L0 em dashstyle โœ“
5 Dev reposant-leads (lead site) ยท awesome-design-md (cloned reference) ยท kairo-dashboard (old PWA, verify vs kairo-hq) ยท session-handoffs (1 file, fold into brain later) ยท tiktok-to-shorts-courseSCAFFOLDED w/ purposes โœ“

โœ… Shipped today

๐Ÿšฆ Decisions logged Jul 11 nothing pending

  1. Style block โ†’ 43 files โœ… validated against Boris Cherny's published practice first (keep it ~100 lines, add rules reactively after an observed failure, tiny high-signal additions). Every file backed up before touch.
  2. Em dashes โ†’ stay, per Anthony. The no-em-dash law applies to new text going forward.
  3. kairo-voice โ†’ hands off, per Anthony. Desktop session already dieted it 786 โ†’ 338 lines with a CHANGELOG.md split.
  4. Dev repos โ†’ scaffolded โœ… with real purpose lines. Verdict on ~/Dev itself: keep it (code repos stay out of the brain vault), fix scatter with orientation files, not relocation.