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

2.4 KiB

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.
  3. 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.