# Lattakker Sheet: documents for AI helpers

A spreadsheet of small TypeScript programs (cells) that also holds a board game, for children learning to program. These files are made from the real sources, so they match the code the children play with. Read them like a human coder reads a project: rules, then the API, then examples.

| File | What it is |
| --- | --- |
| [rules.md](https://springyworks.github.io/lattakker/ai/rules.md) | How to behave with children, how to work like a coder, the rules of cell code. |
| [cell-api.d.ts](https://springyworks.github.io/lattakker/ai/cell-api.d.ts) | TypeScript declarations of print, plot, grid, at, on, every, game, input, mcp ... everything a cell can use. |
| [examples.md](https://springyworks.github.io/lattakker/ai/examples.md) | 65 cells of TypeScript with comments: the starting point of the children. |
| [lab-demos.md](https://springyworks.github.io/lattakker/ai/lab-demos.md) | 48 live demos: plots, animation, animated SVG, grids, inputs, MCP, weather, a local model, system graphs. |
| [README.md](https://springyworks.github.io/lattakker/ai/README.md) | The whole documentation of the project (same as the one on GitHub). |
| [everything.md](https://springyworks.github.io/lattakker/ai/everything.md) | All of the above in one file. |
| [manifest.json](https://springyworks.github.io/lattakker/ai/manifest.json) | The same list for programs. |

## The same things on GitHub (the source files)

- The README: https://github.com/springyworks/lattakker/blob/main/README.md (raw: https://raw.githubusercontent.com/springyworks/lattakker/main/README.md)
- The API typings (source of cell-api.d.ts): https://github.com/springyworks/lattakker/blob/main/src/sheet/apiTypes.ts (raw: https://raw.githubusercontent.com/springyworks/lattakker/main/src/sheet/apiTypes.ts)
- The example cells (source of examples.md): https://github.com/springyworks/lattakker/blob/main/src/examples.ts (raw: https://raw.githubusercontent.com/springyworks/lattakker/main/src/examples.ts)
- The Lab demo cells (source of lab-demos.md): https://github.com/springyworks/lattakker/blob/main/src/labDemos.ts (raw: https://raw.githubusercontent.com/springyworks/lattakker/main/src/labDemos.ts)
- The Monitor demo cells (also in lab-demos.md): https://github.com/springyworks/lattakker/blob/main/src/monitorDemos.ts (raw: https://raw.githubusercontent.com/springyworks/lattakker/main/src/monitorDemos.ts)
- How the API is implemented: https://github.com/springyworks/lattakker/blob/main/src/sheet/api.ts (raw: https://raw.githubusercontent.com/springyworks/lattakker/main/src/sheet/api.ts)
- The short guide for AI assistants: https://github.com/springyworks/lattakker/blob/main/public/llms.txt (raw: https://raw.githubusercontent.com/springyworks/lattakker/main/public/llms.txt)

## How to use them

1. Read rules.md first.
2. Look up exact names and signatures in cell-api.d.ts.
3. Find a similar example in examples.md or lab-demos.md and follow its style; the headings are cell paths you can open (/lab/A16).
4. Write, run, read the error, fix that error.