# 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.
