Personal OS — Agent Rules & Architecture

Eagle (Орёл) is the Discord-facing Hermes agent. This page documents what Eagle knows about its own environment and how to reason about it.

Data Flow

Asana API
  → sync.js (every 30 min, workdays via Hermes cron)
  → PostgreSQL (tasks, stories, task_edges, sync_state)
  → generate-status.js
  → ~/Developer/personal-os/asana_context.md  ← raw Asana data
  → ~/Developer/personal-os/status.md         ← Eagle reads THIS

Eagle only reads status.md. It never touches the DB directly or calls Asana API.

Eagle's Knowledge Sources

~/Developer/personal-os/status.md — live Asana snapshot (updated every 30 min)
~/Developer/personal-os/briefs/daily/YYYY-MM-DD.md — today's brief
~/Developer/personal-os/briefs/weekly/plan-MONDAY.md — weekly plan
~/obsidian/wiki/ — knowledge base (via obsidian MCP)
~/Developer/personal-os/agent/ — playbooks and rules (via file tools)

Feedback Loop

When Alex corrects something:

Edit the brief directly (show diff first, confirm before writing)
If systemic → edit the prompt template in agent/prompts/
Log to ~/Developer/personal-os/logs/corrections_log.md: YYYY-MM-DD HH:MM | file | what changed

Self-Diagnostics

If pipeline seems stale, Eagle can check:

stat -f "%Sm" ~/Developer/personal-os/status.md
# Should be < 40 min old on workdays

If sync is broken:

bash ~/scripts/run-pipeline.sh
# Runs sync.js + generate-status.js + healthcheck

If wiki is stale:

bash ~/scripts/run-wiki-ingest.sh
# Runs at 22:00 via launchd; call manually if needed

Cron Schedule (Hermes)

Job	Schedule	Channel
data-pipeline	*/30 7-21 workdays	silent
morning-brief	08:30 workdays	#daily-brief
eod-summary	18:00 workdays	#daily-brief
inbox-check	*/30 9-19 workdays	#inbox
weekly-plan	Mon 08:00	#daily-brief
weekly-review	Fri 17:00	#daily-brief
commit-vault	23:00 daily	silent

wiki-ingest runs at 22:00 via launchd (not Hermes) — because API-based Claude has no Mac filesystem access.

Allowed File Writes

Eagle can write to:

briefs/daily/YYYY-MM-DD.md
briefs/weekly/plan-MONDAY.md
briefs/weekly/YYYY-MM-DD.md
briefs/inbox/YYYY-MM-DD.md
agent/prompts/*.md (with confirmation)
logs/corrections_log.md

Never write to obsidian/wiki/ directly — that's wiki-ingest's job.

2.5 KiB Raw Blame History