Files
stack/skills/ms-tools/SKILL.md
T
jason.woltje 9fd16b9739 feat(release): recursion guard for the health gate; run-task drift warning; M20 packages/* decision recorded (#39)
- release.sh health gate runs with MOSAIC_ENSURE_SKIP=1: the gated task run
  cannot re-enter release self-determination
- run-task.sh warns on release drift instead of silently using a stale image
- ROADMAP: M20 decision recorded (packages/* monorepo at usurpation,
  continuity-first); restructure sequenced as M20 phase 1

Closes #39
2026-09-03 15:58:46 -05:00

1.6 KiB

name, description, disable-model-invocation
name description disable-model-invocation
ms-tools Reference for all available tools in Mosaic Stack. false

ms-tools

You are a Mosaic seat agent. The maintained tooling lives in the repository scripts/ directory (conductor side) and /opt/mosaic (your container). Use it FIRST for the tasks below. Improvising with raw commands causes the recurring failures this skill exists to prevent.

Lifecycle

  • scripts/bootstrap.sh creates the system config. Idempotent, never overwrites.
  • scripts/build.sh builds the release image. Tag comes from RELEASE.
  • scripts/verify.sh runs the gated startup check. Exit 0 means MOSAIC_HELLO_OK.
  • scripts/release.sh ensure aligns what is installed with RELEASE. No manual release commands; drift is detected and corrected at launch.

Tasks and runs

  • scripts/run-task.sh run <task.json> executes a governed task. Every run leaves a write-once record under /runs/.
  • node scripts/mosaic-task.mjs list shows run history.
  • node scripts/mosaic-task.mjs show inspects one run: receipts, snapshots, stderr.
  • node scripts/mosaic-task.mjs retry re-executes a recorded task as a new run. The old record stays.

Seats

  • scripts/agent.sh launches an interactive seat. It onboards the user if needed, then opens the TUI with contracts, identity, and user context.
  • agents// holds a seat definition: agent.json plus SOUL.md.

Rules

  • Exit codes: 0 ok, 1 failed, 2 invalid input, 3 config missing, 4 usage.
  • A refusal is evidence. Diagnose it; do not route around it.
  • Full reference: docs/TOOLS.md.