Files
stack/.mosaic
fred 80b8f11046
ci/woodpecker/pr/ci Pipeline was successful
docs(l0): declaration grammar moves to .mosaic/repo.json (#1216)
Amendment per operator GO (ms-grill-me design round, 2026-08-20):

- Declaration is .mosaic/repo.json under integration_trunk, not a
  byte-exact AGENTS.md line. Unknown/misspelled keys and unparsable
  files are a structural hard stop; no prose grammar to near-miss
  (Q15 answer, plan D3/D9).
- Changing an existing declaration is operator-owned, above ordinary
  PR review (SF2, plan D10).
- Seeds this repo's declaration: integration_trunk next,
  release_branch main — prevents the absent-declaration default from
  rebinding the stack to main at land time.
- Gloss references in BOOTSTRAP/CODE-REVIEW/CI-CD-PIPELINES point at
  repo.json; merge of origin/next restores pinned-image CI coverage
  for this pre-pin branch (D27 caveat).
2026-08-20 12:52:49 -05:00
..

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