Repo Mosaic Linkage

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

Load Order for Agents

~/.config/mosaic/STANDARDS.md
AGENTS.md (this repository)
.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:

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

Verify enforcement:

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

Optional Matrix Orchestrator Rail

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

Run one cycle:

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

Run continuously:

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

Bridge events to Matrix:

~/.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):

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

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

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

Use repo helper (foreground or detached):

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