From 92b99a099fe23526ec178b706f3ee92a6d1dfa41 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Mumuni=20=F0=9F=A6=85=20=28Syslog=20Falcon=29?=
 <bot@sysloggh.com>
Date: Mon, 11 May 2026 02:35:15 +0000
Subject: [PATCH] Initial commit: Curator Agent README

---
 README.md | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)
 create mode 100644 README.md

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)