Update README.md

Author: dreamer-coding

README.md

@@ -2,6 +2,10 @@
 
 Jellyfish is a lightweight, portable AI library written in pure C with no external dependencies, purpose-built for embedded environments and trust-critical systems. Its architecture centers around transparent AI principles, using blockchain-inspired techniques to make all learning, memory, and reasoning fully auditable. Every interaction—input, decision, or output—is recorded as a cryptographically hashed block, creating an immutable, traceable chain of logic that preserves the system’s decision lineage. This enables developers to inspect exactly how and why the system reached a conclusion, down to the model, token, and rule used. The engine supports memory-based reasoning, adaptive learning from prior inputs, and automatic pruning of obsolete or conflicting knowledge, ensuring the system evolves without accumulating contradiction or noise. These features make Jellyfish a foundation for AI systems where verifiability, traceability, and long-term ethical transparency are non-negotiable.
 
+## 🧠 `.jellyfish` File Example
+
+This file defines a **Jellyfish mindset**, mapping named personalities to model chains (`.fish` files):
+
 ```meson
 # This is the primary logic bundle for TAI personality
 
@@ -30,6 +34,42 @@ mindset('persona_trump') {
 }
 ```
 
+* `mindset(name)` declares a named personality or capability.
+* `models` list refers to one or more `.fish` model files.
+* Optional attributes like `tags`, `priority`, and `activation_condition` allow selective and conditional loading.
+
+---
+
+## 🧠 `.fish` File Example
+
+A `.fish` file stores learned associations (called *thought blocks*) in JSON format:
+
+```json
+{
+  "signature": "JFS1",
+  "blocks": [
+    {
+      "input": "fire",
+      "output": "hot",
+      "timestamp": 1620000000
+    },
+    {
+      "input": "ice",
+      "output": "cold",
+      "timestamp": 1620001000
+    },
+    {
+      "input": "wind",
+      "output": "fast",
+      "timestamp": 1620002000
+    }
+  ]
+}
+```
+
+* `signature`: Identifies the file format version (`JFS1`).
+* Each `block` represents a learned input → output association, optionally timestamped for ordering or pruning.
+
 ## Key Features
 
 - **Cross-Platform**: Runs consistently on Windows, macOS, and Linux.