README: AgentOS vault is canonical; point at HOME + desktop sync

README.md

@@ -2,6 +2,21 @@
 
 A git-backed external brain for Hermes — projects, knowledge, automation patterns, and agent config, all in one compounding repository.
 
+## AgentOS vault (canonical)
+
+**Live VPS path:** `/home/vpsadmin/AgentOS`  
+**Mirror in this repo:** `memory-systems/agent-os/`  
+
+Start with:
+
+- `memory-systems/agent-os/HOME.md` — constitution  
+- `memory-systems/agent-os/DESKTOP_SYNC.md` — laptop Obsidian  
+- `memory-systems/agent-os/STATUS.md` — snapshot  
+- `memory-systems/agent-os/04_Daily/` — consolidations  
+- `memory-systems/agent-os/04_projects/` — athena, ai-talk-show, phoenix, …
+
+Open the live AgentOS tree (or a sync of `memory-systems/agent-os`) in desktop Obsidian. Hermes `OBSIDIAN_VAULT_PATH` points at the VPS live path.
+
 ## Why This Exists
 
 Scattered notes don't compound. This repo is:
@@ -15,14 +30,14 @@ Scattered notes don't compound. This repo is:
 ```
 You / Telegram                      Hermes                          Gitea
      │                                │                               │
-       │─  "Find me everything on     │                              │
+     │   "Find me everything on       │                               │
-       │   wakeAgent gates" ─────────→│── search_files ─────────────→│
+     │    wakeAgent gates" ──────────►│  search_files ───────────────►│
-       │                              │←─ gate designs + notes ─────│
+     │                                │◄── gate designs + notes ──────│
-       │←─ 3 patterns found ─────────│                              │
+     │◄── 3 patterns found ───────────│                               │
      │                                │                               │
-       │─ daily brief fires ─────────→│── fetches data ─────────────→│
+     │   daily brief fires ──────────►│  fetches data ───────────────►│
-       │                              │── saves to kb/daily-briefs/ ─→│
+     │                                │── saves to kb/daily-briefs/ ─►│
-       │←─ formatted brief ──────────│                              │
+     │◄── formatted brief ────────────│                               │
 ```
 
 ## Directory Layout
@@ -31,44 +46,25 @@ You / Telegram                      Hermes                        Gitea
 personal-agent-os/
 ├── _meta/                          # Root-level meta
 │   └── decision-log.md             # Key decisions, rationale, dates
-│
+├── projects/                       # Active projects (legacy layout)
-├── projects/                     # Active projects
-│   ├── hermes-persistent-os/     # The OS project itself
-│   ├── compliance-tracker/       # (create when ready)
-│   ├── local-business-automation/ # (create when ready)
-│   └── ...
-│
 ├── knowledge-base/                 # Cross-cutting knowledge
-│   ├── automation-blueprints/    # Reusable pattern docs
+├── memory-systems/agent-os/        # **Canonical AgentOS vault mirror**
-│   │   └── hermes/               # Hermes-specific patterns (migrated from hermes-automation/)
+├── archive/
-│   ├── ai-agent-patterns/        # General agent design patterns
+├── templates/
-│   ├── hermes-integrations/      # Platform-specific setup notes
+└── agent-config/
-│   ├── x-threads/                # Curated X threads and discussions
-│   ├── tool-evaluations/         # 6-part evaluations of tools
-│   ├── local-entrepreneurship/   # Local business patterns (Phoenix, etc.)
-│   └── daily-briefs/             # (auto-populated by cron)
-│
-├── archive/                      # Completed/closed projects
-│
-├── templates/                    # Consistent formats
-│   ├── project-readme-template.md
-│   ├── kb-entry-template.md
-│   └── experiment-log-template.md
-│
-└── agent-config/                 # Hermes runtime reference material
-    └── .gitkeep
 ```
 
+See `memory-systems/agent-os/HOME.md` for the operating loop. Older sections below may lag the vault — prefer AgentOS paths for new work.
+
 ## Conventions
 
 ### Creating a New Project
-1. Copy `templates/project-readme-template.md` into `projects/<name>/README.md`
+1. Prefer `memory-systems/agent-os/04_projects/<name>/status.md` + `decisions.md`
-2. Fill in Overview, Status, Goals, Architecture
+2. Or copy `templates/project-readme-template.md` into `projects/<name>/README.md` for legacy layout
-3. Create `tasks.md` with Now / Next / Backlog sections
 
 ### Adding a Knowledge Entry
 1. Copy `templates/kb-entry-template.md` into the relevant `knowledge-base/` subfolder
-2. Fill the YAML frontmatter (title, date, source, tags, related_projects, status)
+2. Fill YAML frontmatter (title, date, source, tags, related_projects, status)
 3. Write Summary, Key Insights, Mechanics, Actionable Ideas, Open Questions
 
 ### Naming
@@ -76,36 +72,19 @@ personal-agent-os/
 - Dates in `YYYY-MM-DD` format
 - Tags as comma-separated, lowercase
 
-## How This Stays Alive (Living/Cron Workflows)
-
-This repo is designed to be written to by Hermes cron jobs.
-
-| Cron Job | What It Writes | Frequency | Status |
-|----------|---------------|-----------|--------|
-| daily-brief | Delivers to Telegram. Will also save to `knowledge-base/daily-briefs/` | Daily at 15:00 UTC | ✅ Live |
-| weekly tag index | Scans all KB entries, rebuilds `_meta/tag-index.md` | Weekly (Sun) | 🔲 Planned |
-| opportunity scan | Saves entries to `knowledge-base/x-threads/` | Daily | ⏸️ Paused |
-| email triage | Summary to Telegram + entry to `knowledge-base/hermes-integrations/` | Every 15m | 🔲 Planned |
-
-### Writing Rules for Cron Jobs
-- Always use the `kb-entry-template.md` format when saving to `knowledge-base/`
-- Tag entries with the originating cron job name + relevant project
-- Use `write_file` to append or create; never overwrite another entry
-- Silent delivery on no-change ticks (masterclass pattern)
-
 ## Agent Hooks
 
-Hermes reads from this repo for context:
+Hermes reads for context:
 
-- `projects/<name>/README.md` — project status and goals
+- `memory-systems/agent-os/HOME.md` + project `status.md`
-- `projects/<name>/tasks.md` — next actions
+- `memory-systems/agent-os/04_Daily/`
-- `knowledge-base/**/*.md` — structured knowledge retrieval via search_files
+- `knowledge-base/**/*.md` via search_files
-- `_meta/decision-log.md` — why things were done a certain way
+- `_meta/decision-log.md`
-- `agent-config/` — reference configs and setup snippets
+- `agent-config/`
 
 ## Getting Started
 
-1. Browse `projects/hermes-persistent-os/` for the current automation roadmap
+1. Read `memory-systems/agent-os/HOME.md`
-2. Read `knowledge-base/automation-blueprints/hermes/` for running patterns
+2. Read `memory-systems/agent-os/DESKTOP_SYNC.md` for laptop Obsidian
-3. Use `templates/` when adding new content
+3. Browse `memory-systems/agent-os/04_projects/` for live project status
-4. Check `_meta/decision-log.md` for architectural reasoning
+4. Use `templates/` when adding new KB content outside AgentOS