T1 tutorial: Actions events, the Guide autoload, chapter 1 with Old Tam the hermit, guide panel and marker, saved progress; roadmap: auto-update plan

docs/TUTORIAL_DESIGN.md

@@ -1,6 +1,28 @@
 # Tutorial world design
 
-Status: **proposal**. Nothing here is built yet.
+Status: **T1 built** (the Guide, Actions' events, chapter 1 in
+data/tutorial.json, the guide panel and marker); T2-T4 are proposals.
+
+*As built in T1:*
+- Actions has signals for what players do: `crafted`, `harvested` (with
+  whether it fell), `placed`, `ate`, `killed`, `butchered`, `caught`,
+  `slept` (plus the old `item_gained`).
+- The `Guide` autoload (scripts/core/guide.gd) runs data/tutorial.json:
+  goals `walk`, `gained`, `crafted`, `felled`, `placed`, `ate`, `killed`,
+  `butchered`, `caught`, `slept`, `continue`, and `all` of several. It
+  counts from the tutorial's start, so a step done early ticks the moment
+  it comes up. Markers: the nearest pickup of a kind, tree or boulder,
+  hidden once you have what it's for (`unless_have`).
+- The guide panel (scripts/ui/guide.gd) under the clock: chapter, step n of
+  m, title, how, and a count ("Sticks 2/3 · Stone 0/3"); a tick when a
+  step's done; H hides it. The marker is a pale glowing post and ring, with
+  an arrow and distance at the screen edge when it's off-screen.
+- A world with `"tutorial": true` in its meta.json runs it (the title
+  screen entry comes in T2); `-- --tutorial` runs it on any world for now.
+  Progress is saved with the world.
+- Chapter 1 (First tools) is in the data; chapters 2-5 come with T2. The
+  guide is **Old Tam**, the island's hermit (decided): the steps are in his
+  voice, with his name on the panel.
 
 A short, guided first world that teaches the survival loop by having you
 do it: gather, craft, chop, eat, hunt, cook, fish, keep a mixed diet,