commit 92b99a099fe23526ec178b706f3ee92a6d1dfa41
Author: Mumuni 🦅 (Syslog Falcon) <bot@sysloggh.com>
Date:   Mon May 11 02:35:15 2026 +0000

    Initial commit: Curator Agent README

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..aa2eee5
--- /dev/null
+++ b/README.md
@@ -0,0 +1,20 @@
+# RA-H OS Knowledge Curator Agent — Reports
+
+This repository receives daily automated scan reports from the Mumuni 🦅 Curator Agent.
+
+## How It Works
+
+The agent runs a **read-only daily cron scan** of the RA-H OS knowledge graph and pushes JSON patch reports here for human review. No auto-fixes — everything requires human approval.
+
+## Report Format
+
+Each daily report is saved as:
+```
+reports/YYYY-MM-DD/curator-report.json
+```
+
+The JSON contains:
+- `stale_nodes`: Nodes with metadata older than threshold
+- `orphan_edges`: Edges pointing to non-existent nodes
+- `contradictions`: Conflicting metadata on same node
+- `patches`: Proposed metadata corrections (require human approval)