diff --git a/README.md b/README.md
index 0044bcd..51400ac 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,9 @@
# OpenCode Agent Bus
+
+
+
+
Secure, local inter-session messaging using the locked OpenCode 1.18.19 plugin API contract.
The system combines:
diff --git a/assets/README.md b/assets/README.md
new file mode 100644
index 0000000..b893e41
--- /dev/null
+++ b/assets/README.md
@@ -0,0 +1,9 @@
+# Project icon
+
+The approved icon depicts three connected AI agents in a mint-green city bus.
+
+- `icon.svg`: editable vector master, with a transparent background.
+
+The root README and knowledge-base index use the vector master. The artwork is
+original, uses no RATP name or emblem, and is covered by the repository's
+[`LICENSE`](../LICENSE).
diff --git a/assets/icon.svg b/assets/icon.svg
new file mode 100644
index 0000000..7e3476a
--- /dev/null
+++ b/assets/icon.svg
@@ -0,0 +1,49 @@
+
diff --git a/docs/README.md b/docs/README.md
index a497b7c..8a6634a 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -1,5 +1,7 @@
# Knowledge base
+
+
This directory is the project knowledge base. Keep it aligned with implemented and verified behavior.
| Document | Authority |