# 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)