refactor of repo

MM/README.md

@@ -1,23 +0,0 @@
-# CognitiveOS Architecture Bundle (Add-ons v2)
-
-Generated: 2026-02-17
-
-Includes RFCs 0007--0012 and a runnable Go supervisor stub
-demonstrating: - Deterministic routing - Append-only, hash-chained event
-ledger - Guarded emit enforcement (must-delegate invariant)
-
-## Layout
-
--   docs/
-    -   RFC-INDEX.md
-    -   KERNEL-ROADMAP.md
-    -   rfcs/
-        -   RFC-0007-Delegating-Router.md
-        -   RFC-0008-Capability-Guard-Framework.md
-        -   RFC-0009-Event-Ledger-Primitive.md
-        -   RFC-0010-Guarded-Emit-Syscall.md
-        -   RFC-0011-Session-Spawn-Primitive.md
-        -   RFC-0012-Deterministic-Retry-Controller.md
--   kernel/
-    -   proto/
-    -   supervisor-go/

README.md

@@ -46,3 +46,17 @@ This repository is **pre-implementation**. The initial goal is to stabilize a mi
 - provenance event model
 - OS mapping notes (FreeBSD first, Linux mapping in parallel)
 
+## CognitiveOS RFCs (Control-Plane / Kernel Primitives)
+
+This repo includes a growing set of RFCs capturing the CognitiveOS design direction:
+- RFC Index: `docs/RFC-INDEX.md`
+- Kernel Roadmap: `docs/KERNEL-ROADMAP.md`
+- RFC documents: `docs/rfcs/`
+
+Key primitives covered so far:
+- RFC-0007 Delegating Router (must-delegate invariant)
+- RFC-0008 Capability & Guard framework
+- RFC-0009 Event Ledger (append-only, hash-chained)
+- RFC-0010 Guarded Emit syscall
+- RFC-0011 Session Spawn primitive
+- RFC-0012 Deterministic Retry controller

docs/README.md

@@ -0,0 +1,14 @@
+# Documentation
+
+Core docs live here.
+
+- Getting started / intro: `000-introduction.md`
+- Design goals: `010-design-goals.md`
+- Threat model: `020-threat-model.md`
+- Architecture overview: `030-architecture-overview.md`
+- Roadmap: `090-roadmap.md`
+
+CognitiveOS control-plane RFCs:
+- RFC index: `RFC-INDEX.md`
+- Kernel roadmap: `KERNEL-ROADMAP.md`
+- RFCs: `rfcs/`