# Repo Mosaic Linkage

This repository is attached to the machine-wide Mosaic framework.

## Load Order for Agents

1. `~/.config/mosaic/STANDARDS.md`
2. `AGENTS.md` (this repository)
3. `.mosaic/repo-hooks.sh` (repo-specific automation hooks)

## Purpose

- Keep universal standards in `~/.config/mosaic`
- Keep repo-specific behavior in this repo
- Avoid copying large runtime configs into each project

## Optional Quality Rails

Use `.mosaic/quality-rails.yml` to track whether quality rails are enabled for this repo.

Apply a template:

```bash
~/.config/mosaic/bin/mosaic-quality-apply --template <template> --target .
```

Verify enforcement:

```bash
~/.config/mosaic/bin/mosaic-quality-verify --target .
```

## Optional Matrix Orchestrator Rail

Repo-local orchestrator state lives in `.mosaic/orchestrator/`.

Run one cycle:

```bash
~/.config/mosaic/bin/mosaic-orchestrator-matrix-cycle
~/.config/mosaic/bin/mosaic-orchestrator-run --once
```

Run continuously:

```bash
~/.config/mosaic/bin/mosaic-orchestrator-run --poll-sec 10
```

Bridge events to Matrix:

```bash
~/.config/mosaic/bin/mosaic-orchestrator-matrix-publish
~/.config/mosaic/bin/mosaic-orchestrator-matrix-consume
```

Run until queue is drained (syncs from `docs/tasks.md` first):

```bash
~/.config/mosaic/bin/mosaic-orchestrator-drain
```

Set worker command if auto-detect does not match your CLI:

```bash
export MOSAIC_WORKER_EXEC="codex -p"
# or
export MOSAIC_WORKER_EXEC="opencode -p"
```

Use repo helper (foreground or detached):

```bash
bash scripts/agent/orchestrator-daemon.sh drain
bash scripts/agent/orchestrator-daemon.sh start
bash scripts/agent/orchestrator-daemon.sh status
bash scripts/agent/orchestrator-daemon.sh stop
```
