feat: initial mosaic bootstrap framework

README.md

@@ -0,0 +1,49 @@
+# Mosaic Agent Framework
+
+`~/.mosaic` is the universal userspace standards layer (master) for all agent runtimes.
+
+## Install Master Layer
+
+From `jarvis-brain` repo root:
+
+```bash
+bash scripts/agent/bootstrap-mosaic.sh
+```
+
+Or directly from this package source:
+
+```bash
+bash userspace/mosaic/install.sh
+```
+
+## What It Provides
+
+- Shared standards document: `~/.mosaic/STANDARDS.md`
+- Runtime adapter docs: `~/.mosaic/adapters/`
+- Shared wrapper commands: `~/.mosaic/bin/`
+
+## Usage
+
+Inside any compatible repository:
+
+```bash
+~/.mosaic/bin/mosaic-session-start
+~/.mosaic/bin/mosaic-critical
+~/.mosaic/bin/mosaic-session-end
+```
+
+Wrapper commands call local repo scripts under `scripts/agent/`.
+
+## Bootstrap Any Repo (Slave Linkage)
+
+Attach any repository/workspace to the master layer:
+
+```bash
+~/.mosaic/bin/mosaic-bootstrap-repo /path/to/repo
+```
+
+This creates/updates:
+
+- `.mosaic/` (repo-specific hook/config surface)
+- `scripts/agent/` (portable lifecycle scripts)
+- `AGENTS.md` (if missing)