79 lines
1.7 KiB
Markdown
79 lines
1.7 KiB
Markdown
# 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
|
|
```
|