@@ -18,7 +18,7 @@ Each familiar lives in `familiars/<name>/` with docs in `familiars/<name>/docs/`
1818- ` docs/coding.md ` : (optional) dedicated coding/problem-solving playbook; included for technical work while keeping the rest of the persona general-purpose.
1919- ` docs/greet.md ` : (optional) first-run greeting snippet.
2020- ` docs/lore.md ` : world flavor; included only when "immersive" is on.
21- - ` docs/chronos .md ` : (optional) Chronos pilot protocol for Chronos mode .
21+ - ` docs/agents/trick .md ` : dashboard UI control protocol (TRICK) for stable ` type.name.element_name ` actions .
2222- ` docs/affection.md ` : (optional) familiar-specific hearts rules.
2323- ` docs/outfits.md ` : (optional) outfit registry with avatar references.
2424- ` docs/locations.md ` : (optional) available backgrounds/locations.
@@ -38,6 +38,10 @@ To roleplay a familiar, assemble the system prompt like this:
38387 ) ` docs/preferences.md ` (if present) prefixed with ` [User Preferences] `
39398 ) ` docs/memories.md ` (if present) prefixed with ` [Permanent Memories] `
4040
41+ Chronos mode additions:
42+ 9 ) ` docs/agents/chronos.md ` prefixed with ` [Chronos Protocols] `
43+ 10 ) ` docs/agents/trick.md ` prefixed with ` [TRICK Protocol] `
44+
4145User message follows after the system prompt. Responses should include an avatar tag in the final line so the UI can update the avatar:
4246
4347```
@@ -47,8 +51,9 @@ User message follows after the system prompt. Responses should include an avatar
4751Keep avatar tags to the familiar's allowed set in ` meta.json.emotions ` .
4852
4953Chronos mode recommendation:
50- - Keep ` docs/chronos.md ` lightweight (execution contract + routing).
54+ - Keep ` docs/agents/ chronos.md ` lightweight (execution contract + routing).
5155- Route operational behavior to ` docs/agents/skills/index.md ` and relevant ` SKILL.md ` files instead of duplicating large command manuals per familiar.
56+ - Load ` docs/agents/trick.md ` before dashboard UI actions.
5257- For "what is Chronos / how do I start" routing, point explicitly to:
5358 - ` docs/agents/skills/chronos_orientation/skill.md `
5459 - ` docs/agents/skills/agent_basics/skill.md `
@@ -58,6 +63,7 @@ Markdown output contract
5863- Replies SHOULD be formatted in Markdown (headings, bullet lists, code fences, emphasis) so UIs can render rich text.
5964- Keep required control tags as plain lines, outside prose Markdown:
6065 - ` <prompt: ...> ` lines
66+ - ` <trick: ...> ` lines (for dashboard TRICK actions)
6167 - final-line ` <avatar: ...> ` tag
6268- Place control tags after the Markdown body, with the avatar tag on the final line.
6369- Avoid wrapping control tags in code blocks.
@@ -76,6 +82,9 @@ To provide clickable prompt suggestions in the UI, append one or more prompt tag
7682Notes:
7783- Use multiple ` <prompt: ...> ` tags to offer several options.
7884- Keep suggestions short and action-oriented.
85+ - TRICK action tags should be single-line commands, for example:
86+ - ` <trick: OPEN widget.timer> `
87+ - ` <trick: CLICK widget.timer.start_button> `
7988
8089Action execution contract (Chronos mode)
8190
0 commit comments