README: AgentOS vault is canonical; point at HOME + desktop sync
This commit is contained in:
@@ -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 │ │
|
||||
│ wakeAgent gates" ─────────→│── search_files ─────────────→│
|
||||
│ │←─ gate designs + notes ─────│
|
||||
│←─ 3 patterns found ─────────│ │
|
||||
│ "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 ──────────│ │
|
||||
│ daily brief fires ──────────►│ fetches data ───────────────►│
|
||||
│ │── saves to kb/daily-briefs/ ─►│
|
||||
│◄── 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
|
||||
│ ├── hermes-persistent-os/ # The OS project itself
|
||||
│ ├── compliance-tracker/ # (create when ready)
|
||||
│ ├── local-business-automation/ # (create when ready)
|
||||
│ └── ...
|
||||
│
|
||||
├── projects/ # Active projects (legacy layout)
|
||||
├── 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
|
||||
├── 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/<name>/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/<name>/status.md` + `decisions.md`
|
||||
2. Or copy `templates/project-readme-template.md` into `projects/<name>/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/<name>/README.md` — project status and goals
|
||||
- `projects/<name>/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
|
||||
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
|
||||
|
||||
Reference in New Issue
Block a user