[2026-04-27] wiki/agent-rules, wiki/asana-workflow, wiki/sync-pipeline — system knowledge base

2026-04-27 21:50:44 +06:00
parent 1c35fba9e2
commit fd21fd9ca5
3 changed files with 249 additions and 0 deletions
@@ -0,0 +1,84 @@
+---
+namespace: work
+tags: [system, agent, eagle, rules]
+last_synced: 2026-04-27
+confidence: 1.0
+---
+
+# 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
+
+1. `~/Developer/personal-os/status.md` — live Asana snapshot (updated every 30 min)
+2. `~/Developer/personal-os/briefs/daily/YYYY-MM-DD.md` — today's brief
+3. `~/Developer/personal-os/briefs/weekly/plan-MONDAY.md` — weekly plan
+4. `~/obsidian/wiki/` — knowledge base (via obsidian MCP)
+5. `~/Developer/personal-os/agent/` — playbooks and rules (via file tools)
+
+## Feedback Loop
+
+When Alex corrects something:
+1. Edit the brief directly (show diff first, confirm before writing)
+2. If systemic → edit the prompt template in `agent/prompts/`
+3. 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:
+```bash
+stat -f "%Sm" ~/Developer/personal-os/status.md
+# Should be < 40 min old on workdays
+```
+
+If sync is broken:
+```bash
+bash ~/scripts/run-pipeline.sh
+# Runs sync.js + generate-status.js + healthcheck
+```
+
+If wiki is stale:
+```bash
+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.