From 3d7dff345343cbcb9e8462264a60c7576c8e6787 Mon Sep 17 00:00:00 2001 From: Jason Woltje Date: Thu, 22 Oct 2026 13:46:38 -0500 Subject: [PATCH] docs: clarify setup sheet notices and agent identity --- docs/case2/SETUP-SHEET.md | 33 +++++++++++++++++---------------- 1 file changed, 17 insertions(+), 16 deletions(-) diff --git a/docs/case2/SETUP-SHEET.md b/docs/case2/SETUP-SHEET.md index faebb67c0..37b451c6e 100644 --- a/docs/case2/SETUP-SHEET.md +++ b/docs/case2/SETUP-SHEET.md @@ -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:"//"`. +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:"//"`. -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.