30 lines
1.3 KiB
Markdown
30 lines
1.3 KiB
Markdown
# Mosaic Runtime Adapter — OpenCode
|
|
|
|
Load and apply in this order:
|
|
1. `~/.config/mosaic/STANDARDS.md`
|
|
2. repo-local `AGENTS.md` (and `SOUL.md` when present)
|
|
|
|
This file is an OpenCode adapter layer. It does not replace project guidance.
|
|
|
|
## Orchestrator Capability Contract
|
|
|
|
- OpenCode sessions may not expose a native subagent/background task primitive in all deployments.
|
|
- When native subagent delegation is unavailable, use Mosaic's deterministic orchestrator rail:
|
|
- `~/.config/mosaic/bin/mosaic-orchestrator-matrix-cycle`
|
|
- Keep repo task tracking in `docs/tasks.md` as the canonical human-readable state.
|
|
- Keep machine transport/controller state in `.mosaic/orchestrator/`.
|
|
|
|
## Fallback Delegation Mode (No Native Subagents)
|
|
|
|
1. Bootstrap repo if needed:
|
|
- `~/.config/mosaic/bin/mosaic-bootstrap-repo /path/to/repo`
|
|
2. Configure `.mosaic/orchestrator/config.json`:
|
|
- set `"enabled": true`
|
|
- set `"worker.command_template"` to your OpenCode worker command
|
|
3. Queue work items in `.mosaic/orchestrator/tasks.json` (or via Matrix command ingestion).
|
|
4. Run deterministic ticks:
|
|
- `~/.config/mosaic/bin/mosaic-orchestrator-matrix-cycle`
|
|
- or drain to completion: `~/.config/mosaic/bin/mosaic-orchestrator-drain`
|
|
|
|
This preserves rails enforcement (`quality_gates`) even without runtime-native subagent features.
|