59 lines
2.1 KiB
Markdown
59 lines
2.1 KiB
Markdown
# Mosaic Universal Agent Standards
|
|
|
|
This file is the canonical standards contract for agent sessions on this machine.
|
|
|
|
Master/slave model:
|
|
- Master: `~/.mosaic` (this framework)
|
|
- Slave: each repo bootstrapped via `mosaic-bootstrap-repo`
|
|
|
|
## Execution Model
|
|
|
|
1. Load this file first.
|
|
2. Load project-local `AGENTS.md` next.
|
|
3. Respect repository-specific tooling and workflows.
|
|
4. Use lifecycle scripts when available (`scripts/agent/*.sh`).
|
|
5. Use shared rails/guides from `~/.mosaic` as canonical references.
|
|
|
|
## Non-Negotiables
|
|
|
|
- Data files are authoritative; generated views are derived artifacts.
|
|
- Pull before edits when collaborating in shared repos.
|
|
- Run validation checks before claiming completion.
|
|
- Apply quality rails from `~/.mosaic/rails/` when relevant (review, QA, git workflow).
|
|
- For project-level mechanical enforcement templates, use `~/.mosaic/rails/quality/` via `~/.mosaic/bin/mosaic-quality-apply`.
|
|
- For runtime-agnostic delegation/orchestration, use `~/.mosaic/rails/orchestrator-matrix/` with repo-local `.mosaic/orchestrator/` state.
|
|
- Avoid hardcoded secrets and token leakage in remotes/commits.
|
|
- Do not perform destructive git/file actions without explicit instruction.
|
|
|
|
## Session Lifecycle Contract
|
|
|
|
- Start: `scripts/agent/session-start.sh`
|
|
- Priority scan: `scripts/agent/critical.sh`
|
|
- End: `scripts/agent/session-end.sh`
|
|
- Limitation logging helper: `scripts/agent/log-limitation.sh "Title"`
|
|
|
|
If a repo does not expose these scripts, run equivalent local workflow commands and document deviations.
|
|
|
|
## Multi-Agent Safety
|
|
|
|
- Coordinate through git pull/rebase discipline.
|
|
- Do not auto-resolve data conflicts in shared state files.
|
|
- Keep commits scoped to a single logical change set.
|
|
|
|
## Prompting Contract
|
|
|
|
All runtime adapters should inject:
|
|
|
|
- `~/.mosaic/STANDARDS.md`
|
|
- project `AGENTS.md`
|
|
|
|
before task execution.
|
|
|
|
Runtime-compatible guides and rails are hosted at:
|
|
|
|
- `~/.mosaic/guides/`
|
|
- `~/.mosaic/rails/`
|
|
- `~/.mosaic/profiles/` (runtime-neutral domain/workflow/stack presets)
|
|
- `~/.mosaic/runtime/` (runtime-specific overlays)
|
|
- `~/.mosaic/skills-local/` (local private skills shared across runtimes)
|