Docs Build
Building scenes
The way to make and change things on a screen well, and to check your work.
The tools are the same over MCP, from flisk tool, and for Flisk’s own agent. This is the loop that works.
1. Find the screen#
screens lists the person’s screens, what each is called, and whether it’s on. Name the screen in each call (by
name, part of one, or id), or leave it out when they have only one.
2. Start from a template#
templates lists the starting scenes. Show one with show_scene, or a whole scene of your own written from
reference, which says every kind and property a scene can hold and the ops that change one.
3. Build on it with ops#
Read what’s there first with get_scene (it gives you the ids), then change it with apply_ops. Show a whole new
scene only for something new.
Use prefabs and themes rather than writing forty entities, and the library (the person’s own, then the public
library) before making a model, a picture or a sound. Never invent a picture, prefab or theme name: check first.
For a screen of information, start from the dashboard template, or the built-in blocks that fit any screen’s
shape: page, header, grid, split, card, big-number, ticker and footer.
4. Check your work#
After each change, look: picture gives you an image of the screen as it is, and look describes it in words, for
an agent that can’t see. Things floating, off the edge, too dark, not what was asked: fix them and look again.
Never say how it looks without looking.
Before anything’s shown, or with no screen on, preview draws a scene at any size and moment (a phone’s 1080 × 1920,
a 4K TV, 07:55 on a rainy Monday). try_scene runs a scene’s script against sample data and a press, and keeps
nothing.
5. Keep it#
Something to keep goes on the person’s wall as a saved scene of theirs (put_scene), changed later with
change_scene or remake_scene.
Good manners#
- Anything that flashes: at most three times a second.
- Made-up contact details only from fiction’s ranges: example.com, 555-0100 to 0199, UK 07700 900000 to 900999.
- Turn a screen’s watching for people on or off only when the person asks: it’s their home’s camera.