Update README.md

README.md

@@ -1,3 +1,26 @@
----
-license: mit
----
+---
+license: mit
+---
+
+# Reflective Alignment Architecture (RAA)
+
+This repository contains the full **Reflective Alignment Architecture (RAA)** specification, the **Reflective Duality Layer (RDL)**, stability fields, drift diagnostics, and the complete RAA v1.1 PDF.
+
+## 📄 Download the Full Paper (PDF)
+[Reflective Alignment Architecture — Full Specification (v1.1)](./Reflective_Alignment_Architecture_RDL_v1.1.pdf)
+
+## 🖼 Diagrams Included in This Repository
+
+- ![Constructive Resonance](./Constructive%20Resonance.jpg)
+- ![Coherence Resonance](./Coherence%20Resonance.jpg)
+- ![Reflective Stability](./Reflective%20Stability.jpg)
+- ![RDL Phase Diagram](./RDL.jpg)
+- ![SR Manifold](./5R%20Manifold.jpg)
+- ![Preference Collapse](./Preference%20Collapse.jpg)
+
+## Overview
+The Reflective Alignment Architecture (RAA) is a multi-layer scientific framework for reflective stability, moral coherence, and frontier AI safety.  
+It explains how regulation, reflection, reasoning, reciprocity, and resonance interact to stabilise intelligent systems and prevent drift, brittleness, and Goodhart collapse.
+
+RDL (Reflective Duality Layer) is the mathematical stability layer that ensures two reflective perspectives (internal + external) remain in stable constructive coherence rather than oscillation or collapse.
+