![\"CHORUS\"](\"https://raw.githubusercontent.com/iamoberlin/chorus/main/logo.png\"){kind=logo}
\n\n \n
CHORUS: Hierarchy Of Recursive Unified Self-improvement
\n\nCHORUS implements the Nine Choirs architecture — hierarchical cognition modeled on Pseudo-Dionysius's *Celestial Hierarchy*. Illumination descends through the choirs; understanding ascends. The agent is sanctified through structure.\n\n## What's New in v2.3\n\n- **Unified delivery path.** Scheduler and manual commands now share one channel-aware delivery adapter for consistent formatting and routing.\n- **Channel-agnostic output.** Choir output adapts to the destination automatically (plain text for iMessage, markdown for webchat, etc.).\n- **Context passing fixed.** Illumination flow works correctly across all entry points — `run`, `vision`, and scheduled execution.\n\n## The Core Idea\n\nMost AI agents are frozen. Same prompts, same limitations, no growth. CHORUS changes that through **architecture**:\n\n- **Nine specialized choirs** handling distinct cognitive functions\n- **Frequency hierarchy** — contemplation runs rarely, action runs continuously \n- **Bidirectional flow** — illumination down, insight up\n- **Self-modification** — the Virtues choir improves the system 6×/day\n\n## Install\n\n```bash\nopenclaw plugin add chorus\n```\n\n## Configuration\n\nStandard OpenClaw plugin config via `openclaw.yaml`:\n\n```yaml\nplugins:\n entries:\n chorus:\n enabled: true\n config:\n enabled: true # Enable Nine Choirs scheduler\n timezone: America/New_York\n memoryConsolidation: true # Cherubim consolidates to MEMORY.md\n episodicRetentionDays: 90\n choirs: # Optional: disable specific choirs\n angels: false\n```\n\n## The Nine Choirs\n\nFrequency increases as you descend. Higher choirs set context; lower choirs execute.\n\n### First Triad — Contemplation\n\n| Choir | Freq | Function |\n|-------|------|----------|\n| **Seraphim** | 1×/day | Mission clarity, strategic direction |\n| **Cherubim** | 2×/day | Knowledge consolidation, memory |\n| **Thrones** | 3×/day | Judgment, prioritization |\n\n### Second Triad — Governance\n\n| Choir | Freq | Function |\n|-------|------|----------|\n| **Dominions** | 4×/day | Project coordination |\n| **Virtues** | 6×/day | **RSI — recursive self-improvement** |\n| **Powers** | 8×/day | Red-team, security review |\n\n### Third Triad — Action\n\n| Choir | Freq | Function |\n|-------|------|----------|\n| **Principalities** | 12×/day | Domain research, environmental scan |\n| **Archangels** | 18×/day | Briefings, alerts, communication |\n| **Angels** | 48×/day | Heartbeat, continuous presence |\n\n## Recursive Self-Improvement\n\nThe **Virtues** choir is the RSI engine. Six times per day:\n\n1. Reviews recent performance — what worked, what failed, why\n2. Identifies improvement opportunities\n3. Generates modifications (config, prompts, automations)\n4. Risk assessment — low-risk auto-applies; high-risk flags for review\n5. Logs to `CHANGELOG.md`\n\n**Powers** validates adversarially. Together they create a tight feedback loop.\n\nDay 1, baseline. Day 30, unrecognizable.\n\n## Calibration\n\nIntelligence requires feedback. CHORUS builds calibration into the choir flow using natural language:\n\n**Principalities** states beliefs when researching:\n> \"I believe X will happen by [timeframe] because...\"\n\n**Powers** challenges those beliefs:\n> \"What would make this wrong? What are we missing?\"\n\n**Virtues** reviews resolved beliefs:\n> \"We believed X. It turned out Y. Lesson: Z\"\n\n**Cherubim** preserves calibration lessons in long-term memory.\n\nNo rigid schemas — just beliefs flowing through the hierarchy, tested by time, distilled into wisdom.\n\n## Information Flow\n\n**Illumination (↓):** Seraphim sets mission → cascades through increasingly frequent layers → Angels execute moment-to-moment\n\n**Insight (↑):** Angels observe → Principalities synthesize → Virtues improve → Cherubim consolidate to long-term memory\n\n## File Outputs\n\n```\nopenclaw.yaml # Config (plugins.entries.chorus)\nCHANGELOG.md # RSI modifications log\nMISSION.md # Seraphim output\nMEMORY.md # Cherubim consolidation\nPLAN.md # Thrones priorities\nPROJECTS.md # Dominions status\nmemory/*.md # Daily episodic memory\nresearch/*.md # Principalities findings\nproposals/*.md # High-risk changes for review\n```\n\n## Purpose-Derived Research (v1.1.0+)\n\nResearch is driven by **purposes**, not fixed cron jobs. Define purposes with criteria, and CHORUS automatically runs adaptive-frequency research.\n\n### How It Works\n\n1. Purposes with `criteria` or `domains` spawn research agents\n2. Frequency adapts to deadline proximity:\n - Overdue → max frequency\n - ≤7 days → 3× base\n - ≤30 days → 1.5× base\n3. Daily cap (default 50) prevents runaway costs\n4. Metrics tracked under `purpose: