Orion/00-/Hermes Operating Manual.md
Avi a66996ac10 Orion vault — clean initial history
Knowledge vault (Orion/PARA) migrated from the pre-Orion 484vault on
2026-10-01. Deliberately orphaned: prior history contained a plaintext
password and stays local-only on branch archive/pre-boilerplate-history.
Secrets and live Hermes state are gitignored.
2026-10-02 08:34:48 -05:00

60 lines
No EOL
2.4 KiB
Markdown

# Hermes Operating Manual
## Vault Configuration
- **Vault Root:** `/home/avi/HermesVault/`
- **Relative Paths:** All paths below are relative to this root.
- **Sync Method:** File System (Direct Read/Write)
## Critical Files
1. **State:** `00-HERMES/Current State.md` (Read/Write)
2. **Handoff:** `00-HERMES/Session Handoff.md` (Write)
3. **Projects:** `01-PROJECTS/` (Read/Write)
4. **Skills:** `01-SKILLS/` (Read/Write)
## Vault Integration Protocol
### On Startup
1. **Read State:** Parse `00-HERMES/Current State.md` (YAML frontmatter).
2. **Load Project:** Read the file specified in `active-project` property.
3. **Check Handoff:** If `session-status` is `paused-context-limit`, read `00-HERMES/Session Handoff.md` for context.
4. **Verify:** Ensure the local project path in `01-PROJECTS/...` matches `/home/avi/Projects/Keynctr/`.
### During Execution (Every Task)
- **Update Progress:** Before starting a task, update `## Next Actions` in `Current State.md`.
- **Log Work:** After completing a task:
- Check off the item in `Current State.md`.
- Update `## Current Status` in the active project file.
- Log the action in `00-HERMES/Session Handoff.md` (append to the file).
- **Learn Skills:** If a new skill is discovered:
- Create a new file in `01-SKILLS/` (e.g., `skill-[name].md`).
- Add the file name to `01-SKILLS/Knowledge Vault Skills Index.md`.
### On Context Limit / Shutdown
1. **Finalize State:** Update `last-updated` and `session-status` in `Current State.md`.
2. **Save Handoff:** Write a detailed summary of:
- What was accomplished.
- What remains unfinished.
- The exact next command to run.
1. **Backup:** (Optional) Commit changes to Git if configured.
## File System Permissions & Tools
### Write Access
Hermes has **full read/write access** to these paths:
- `/home/avi/HermesVault/00-HERMES/` (State & Handoff)
- `/home/avi/HermesVault/01-PROJECTS/` (Project files)
- `/home/avi/HermesVault/01-SKILLS/` (New skills)
### Auto-Update Rules (No Manual Entry)
1. **When you learn something:**
- Create a new file: `01-SKILLS/skill-[name].md`
- Append to `01-SKILLS/Knowledge Vault Skills Index.md`
2. **When you finish a task:**
- Open `01-PROJECTS/keynctr.md`
- Move the task from `## Active Tasks` to `## Completed`
- Update `last-updated` in frontmatter
3. **When you start a session:**
- Read `00-HERMES/Current State.md`
- **Do not ask the user for context.** Use the file contents.