mosaicstack/stack
25
0 Fork 1
Code Issues 404 Pull Requests 13 Packages Projects Releases 15 Wiki Activity

docs: clarify setup sheet notices and agent identity

Browse Source
This commit is contained in:
jason.woltje committed 2026-10-24 09:54:29 -05:00
1 parent f8461e9ab5
commit 3d7dff3453
1 file changed
+17 -16
Download Patch File Download Diff File Expand all files Collapse all files
docs/case2/SETUP-SHEET.md
+17 -16
View File
@@ -42,6 +42,18 @@ What the playground means for the agents:
- Only the folder decides. A tag or a property can't make a note playground or canon. A playground
folder is writable only when it is also marked `supporting`.
### Colour the playground in your graph
This is a setting of your own vault. It changes nothing for the agents.
1. Open the graph view and open its settings panel.
2. Under Groups, choose New group.
3. In the query box, type the playground's path with `path:`. Your vault is `~/src`, so the path
starts with your books repo folder: `path:"<books repo folder>/<book>/<playground folder>"`.
4. Pick a colour.
Add one group per playground folder.
## Supporting folders
A folder you mark as `supporting` is where agents may write `.md` notes. They cannot write anywhere
@@ -59,21 +71,10 @@ When you save a file in the Console, Mosaic makes a commit under the name and em
`editor` in your `projects` entry. If that file moved after you opened it, Mosaic refuses the save and
keeps your text so you can copy it or try again.
Each time an agent creates, edits or deletes a supporting note, Mosaic makes a commit and shows you a
notice in the Console with a Revert button. Obsidian sees the change on its next pull. Supporting notes
may contain any text. You can read and revert every one.
### Colour the playground in your graph
This is a setting of your own vault. It changes nothing for the agents.
1. Open the graph view and open its settings panel.
2. Under Groups, choose New group.
3. In the query box, type the playground's path with `path:`. Your vault is `~/src`, so the path
starts with your books repo folder: `path:"<books repo folder>/<book>/<playground folder>"`.
4. Pick a colour.
Add one group per playground folder.
Each time an agent creates, edits or deletes a supporting note, Mosaic makes a commit under that
agent's own name and shows you a notice in the Console with a Revert button. Mosaic's own notices do
not need a citation. Obsidian sees the change on its next pull. Supporting notes may contain any text.
You can read and revert every one.
## Two things you might not expect
@@ -137,7 +138,7 @@ optional by default. You or Jason can change these settings:
| Setting | Default | What it does |
|---|---:|---|
| `requireCitation` | `false` | When true, each answer needs a citation. |
| `requireCitation` | `false` | When true, each answer needs a citation. Mosaic's own notices do not. |
| `citationsPerReply` | `20` | Maximum citations in one answer. |
File citations in one answer must stay within one universe.