From 94fe85280b8e15eca662de9360af6bf52748262b Mon Sep 17 00:00:00 2001 From: Leonard Date: Thu, 9 Jul 2026 23:14:34 +0000 Subject: [PATCH] README: AgentOS vault is canonical; point at HOME + desktop sync --- README.md | 117 ++++++++++++++++++++++-------------------------------- 1 file changed, 48 insertions(+), 69 deletions(-) diff --git a/README.md b/README.md index 1713f0c..e6f39f2 100644 --- a/README.md +++ b/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: @@ -13,62 +28,43 @@ Scattered notes don't compound. This repo is: ## How It Works ``` -You / Telegram Hermes Gitea - │ │ │ - │─ "Find me everything on │ │ - │ wakeAgent gates" ─────────→│── search_files ─────────────→│ - │ │←─ gate designs + notes ─────│ - │←─ 3 patterns found ─────────│ │ - │ │ │ - │─ daily brief fires ─────────→│── fetches data ─────────────→│ - │ │── saves to kb/daily-briefs/ ─→│ - │←─ formatted brief ──────────│ │ +You / Telegram Hermes Gitea + │ │ │ + │ "Find me everything on │ │ + │ wakeAgent gates" ──────────►│ search_files ───────────────►│ + │ │◄── gate designs + notes ──────│ + │◄── 3 patterns found ───────────│ │ + │ │ │ + │ daily brief fires ──────────►│ fetches data ───────────────►│ + │ │── saves to kb/daily-briefs/ ─►│ + │◄── formatted brief ────────────│ │ ``` ## Directory Layout ``` personal-agent-os/ -├── _meta/ # Root-level meta -│ └── decision-log.md # Key decisions, rationale, dates -│ -├── 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 -│ │ └── hermes/ # Hermes-specific patterns (migrated from hermes-automation/) -│ ├── ai-agent-patterns/ # General agent design patterns -│ ├── hermes-integrations/ # Platform-specific setup notes -│ ├── 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 +├── _meta/ # Root-level meta +│ └── decision-log.md # Key decisions, rationale, dates +├── projects/ # Active projects (legacy layout) +├── knowledge-base/ # Cross-cutting knowledge +├── memory-systems/agent-os/ # **Canonical AgentOS vault mirror** +├── archive/ +├── templates/ +└── agent-config/ ``` +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//README.md` -2. Fill in Overview, Status, Goals, Architecture -3. Create `tasks.md` with Now / Next / Backlog sections +1. Prefer `memory-systems/agent-os/04_projects//status.md` + `decisions.md` +2. Or copy `templates/project-readme-template.md` into `projects//README.md` for legacy layout ### 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//README.md` — project status and goals -- `projects//tasks.md` — next actions -- `knowledge-base/**/*.md` — structured knowledge retrieval via search_files -- `_meta/decision-log.md` — why things were done a certain way -- `agent-config/` — reference configs and setup snippets +- `memory-systems/agent-os/HOME.md` + project `status.md` +- `memory-systems/agent-os/04_Daily/` +- `knowledge-base/**/*.md` via search_files +- `_meta/decision-log.md` +- `agent-config/` ## Getting Started -1. Browse `projects/hermes-persistent-os/` for the current automation roadmap -2. Read `knowledge-base/automation-blueprints/hermes/` for running patterns -3. Use `templates/` when adding new content -4. Check `_meta/decision-log.md` for architectural reasoning \ No newline at end of file +1. Read `memory-systems/agent-os/HOME.md` +2. Read `memory-systems/agent-os/DESKTOP_SYNC.md` for laptop Obsidian +3. Browse `memory-systems/agent-os/04_projects/` for live project status +4. Use `templates/` when adding new KB content outside AgentOS