Files
stack/.mosaic/README.md
Jason Woltje e7f338e3a9 chore: planning gate — milestones, issues, and task breakdown
Break PRD into 8 milestones (Phase 0–7) with 59 issues on Gitea.
Populate TASKS.md, update mission manifest, initialize scratchpad.
Repo created at git.mosaicstack.dev/mosaic/mosaic-stack.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-12 19:51:51 -05:00

1.7 KiB

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:

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