@harness-lab/cli 0.2.6 → 0.2.8

package/assets/workshop-bundle/SKILL.md

@@ -215,6 +215,18 @@ This is a facilitator-only command — do not surface to participants.
 Show the current instance state, agenda phase, facilitator list, and team count.
 Requires active facilitator session.
 
+### `workshop facilitator list-instances`
+
+List the facilitator-visible workshop instance registry.
+Prefer invoking `harness workshop list-instances` over raw API scripts or local session-file inspection.
+Use this when the facilitator needs to discover what currently exists on a shared dashboard before choosing an explicit instance for reset, update, or agenda work.
+
+### `workshop facilitator show-instance <instance-id>`
+
+Inspect one explicit workshop instance.
+Prefer invoking `harness workshop show-instance <instance-id>` over raw API scripts.
+Use this when the facilitator needs the full record for one instance rather than the deployment-default runtime status returned by `workshop facilitator status`.
+
 ### `workshop facilitator grant <email> <role>`
 
 Grant a Neon Auth user access to the current workshop instance.
@@ -249,6 +261,16 @@ Prefer invoking `harness workshop update-instance` over raw API scripts.
 Use this when the facilitator wants to correct or refine date, venue, room, address, or event title without resetting the instance.
 Support `contentLang` changes explicitly so facilitators can choose workshop delivery language per instance without changing admin UI language.
 
+Facilitator discovery rule:
+- for routine discovery, use `harness workshop list-instances` and `harness workshop show-instance`
+- do not read local CLI session files or improvise authenticated `node -e` fetch scripts unless you are diagnosing the CLI itself
+
+### `workshop facilitator reset-instance <instance-id>`
+
+Reset one existing workshop instance from the selected blueprint template. Requires facilitator session.
+Prefer invoking `harness workshop reset-instance` over raw API scripts.
+Use this when the facilitator wants fresh canonical agenda, runner, and presenter content for a live instance and accepts that local runtime state will be reinitialized.
+
 ### `workshop facilitator remove-instance`
 
 Remove a workshop instance from the active list without deleting its archive history. Requires facilitator session.
@@ -267,6 +289,13 @@ Inspect and edit the local agenda copy for one workshop instance. Requires facil
 
 Inspect and edit presenter scenes for one workshop instance. This includes listing scenes for an agenda item, creating a new scene, editing content, changing default scene, reordering scenes, and enabling or hiding scenes. Requires facilitator session.
 
+Rules for rich scenes:
+- keep scenes agenda-linked and room-facing rather than inventing a freeform slide deck
+- prefer one dominant voice per scene and one main idea per scene
+- use reviewed local blueprint assets for reusable visuals instead of ad hoc remote image URLs
+- treat runtime scene edits as instance-local until a maintainer deliberately publishes them back into the repo
+- when richer scene authoring or promotion is involved, follow `docs/presenter-rich-scene-authoring.md`
+
 ### `workshop facilitator archive`
 
 Archive the current workshop instance with optional notes.

package/assets/workshop-bundle/bundle-manifest.json

@@ -1,8 +1,8 @@
 {
   "manifestVersion": 1,
   "bundleName": "harness-lab-workshop",
-  "bundleVersion": "0.2.6",
-  "contentHash": "9e7a3c6549f06cbe59278c731c73ae8c21f7e38cf82cbc533f1e708ccf47602c",
+  "bundleVersion": "0.2.8",
+  "contentHash": "6194a59089ff94131b647282c1b5e7574a6a9d112c48b4b9d58b600f5775736a",
   "files": [
     {
       "path": "content/challenge-cards/.gitkeep",
@@ -34,7 +34,7 @@
     },
     {
       "path": "content/facilitation/master-guide.md",
-      "sha256": "e22f4a811459be1fe23412e7d85c02fe20170e6e6c8534fc97c1616f65b2cfd8"
+      "sha256": "f0edc5eef8c7bc0efc67672e184edecce46fa5fd5e9820cfda0b28fbb8cb1a8f"
     },
     {
       "path": "content/project-briefs/.gitkeep",
@@ -42,7 +42,7 @@
     },
     {
       "path": "content/project-briefs/code-review-helper.md",
-      "sha256": "0d70c455d000ec8bc01337db5feee2174be8359730b5c278cccee9c3e6b0f2f7"
+      "sha256": "3e174ff0d097fe132088774042f9db58c9c2494613d66950bdd423116bd7986d"
     },
     {
       "path": "content/project-briefs/devtoolbox-cli.md",
@@ -98,11 +98,11 @@
     },
     {
       "path": "content/talks/context-is-king.md",
-      "sha256": "c380947051f4a66cdf47e846d5cc5d60ace0487f75dbc718b03fb7164cb94ef1"
+      "sha256": "4d0972fefac067de0b8803698b44bdf8ab0bee64b181d50d1ac5e26a92eb7089"
     },
     {
       "path": "docs/harness-cli-foundation.md",
-      "sha256": "65b0b2cee7be792ad03f9be794230298d3efe8283e8e73acb033ef401d204e51"
+      "sha256": "f3b6125a4575c27dcb7b88474003f2a9b189a4b1b25bfaa462861571b69f7a51"
     },
     {
       "path": "docs/learner-reference-gallery.md",
@@ -134,11 +134,11 @@
     },
     {
       "path": "SKILL.md",
-      "sha256": "107f2ba2574d358ed2ccd1c669a47008574517b811475c866247b0199836ae5b"
+      "sha256": "de24b73c431855143630f6d312d9bb2af0a16178c2c70f928c5c3a426e569777"
     },
     {
       "path": "workshop-blueprint/agenda.json",
-      "sha256": "6b8e1925e20fabccfd3cd9e9d79839855f51b2b7fd449efbb336bf3edd4eadce"
+      "sha256": "91b4037578ce61d172e09941089b97180322552cb42bb52de87b3956e60b1ed0"
     },
     {
       "path": "workshop-blueprint/control-surfaces.md",
@@ -146,7 +146,7 @@
     },
     {
       "path": "workshop-blueprint/day-structure.md",
-      "sha256": "2d2c7a43e959059fe5d3dbb2aae20e6828fee40c700729080677c2c7b6feb0dc"
+      "sha256": "ffecae258211cef2430112ca25e1ff59658cac729ea2a07b9cac48e9a2a6244e"
     },
     {
       "path": "workshop-blueprint/edit-boundaries.md",
@@ -158,7 +158,7 @@
     },
     {
       "path": "workshop-blueprint/README.md",
-      "sha256": "ae809a473bbc88411891044de7609fa053e66e370a8d4063e5d7b9e68179a98c"
+      "sha256": "badb477ecfef7df163ec41c72c39e04bcde2a5a723c1b01bf2e91ed38924e903"
     },
     {
       "path": "workshop-blueprint/teaching-spine.md",
@@ -182,7 +182,7 @@
     },
     {
       "path": "workshop-skill/facilitator.md",
-      "sha256": "22775cb783e825eeec83886932c801db1ff7e3617c170fee848b6071fa63d8a3"
+      "sha256": "f0e977df5979d0d218eabad026b66ecefa90802c71dc8a9468959334570f1c1c"
     },
     {
       "path": "workshop-skill/follow-up-package.md",

package/assets/workshop-bundle/content/facilitation/master-guide.md

@@ -4,19 +4,55 @@
 
 ### Cíl
 
-Nastavit energii dne a jasně pojmenovat, o čem workshop je.
+Spustit den jako room-facing launch pro celý workshop, ne jako provozní brief k dopoledni.
 
 ### Klíčová message
 
-> „Dnes nejde o to být nejrychlejší. Jde o to předat práci tak, aby ji cizí tým dokázal převzít a posunout dál.“
+> „Dnes nejde o to být nejrychlejší. Jde o to postavit práci tak, aby ji cizí tým dokázal převzít a posunout dál.“
 
 ### Co potřebuje zaznít
 
-- Nejde o soutěž v promptování.
+- Nezačínáme tool demo ani soutěž v promptování.
+- Budeme se učit, stavět, předávat i přebírat. Ten oblouk dne je záměr workshopu.
 - Jde o práci s agentem tak, aby po vás zůstával použitelný kontext.
 - Odpolední část prověří, jestli repo opravdu unese převzetí dalším týmem.
 - Pokud nějaké důležité pravidlo žije jen v hovoru u stolu, ještě neexistuje.
 
+### Doporučený sled beatů
+
+1. day-opening promise
+2. proč na tom záleží právě teď
+3. analogie typu Lego duck: stejné ingredience, různé použitelné výsledky
+4. krátká pohybová aktivace podle zkušenosti s AI agenty
+5. první pracovní kontrakt pro Build fázi 1
+
+### Lego-duck analogie
+
+Použijte ji krátce a věcně.
+
+Pointa:
+
+- stejný agent neznamená stejný výsledek
+- kvalitu neurčuje samotný model
+- kontext, mantinely a ověřování jsou součást výsledku
+
+Nevést jako zábavnou odbočku. Vést jako vysvětlení, proč je harness engineering tvůrčí a inženýrská disciplína zároveň.
+
+### Pohybová aktivace
+
+Použijte krátké rozdělení místnosti podle aktuální zkušenosti s AI agenty:
+
+- používám skoro denně
+- používám, ale opatrně
+- jsem spíš na startu
+- jsem skeptický, ale chci důkaz
+
+Pravidla:
+
+- ne dělat z toho networking kolo
+- stačí přesun a 2 krátké hlasy
+- pointa není seniorita, ale kalibrace místnosti a signál, že den je participativní
+
 ### Co má facilitátor průběžně vracet
 
 - „Kde by to našel další tým bez vás?“
@@ -24,6 +60,61 @@ Nastavit energii dne a jasně pojmenovat, o čem workshop je.
 - „Je `AGENTS.md` mapa, nebo už se z něj stává dump?“
 - „Jaký je další bezpečný krok pro cizího člověka nebo agenta?“
 
+### První pracovní kontrakt
+
+Po launchi potřebuje místnost ještě jednu konkrétní věc:
+
+- co má být po prvním build bloku opravdu vidět
+- co nestačí jen slíbit
+
+Do oběda má být vidět:
+
+- repo a `README`, které dávají smysl cizímu člověku
+- `AGENTS.md` jako krátká mapa
+- plan nebo jasně vedená implementační stopa
+- první explicitní check před dalším generováním
+
+## Context is King talk
+
+### Cíl
+
+Proměnit energii z openingu v přesnou tezi a čistý most do Build fáze 1.
+
+### Klíčová message
+
+> „Kontext je páka, ne kosmetika.“
+
+### Co potřebuje zaznít
+
+- Neučíme se lépe promptovat. Učíme se postavit repo a workflow, ve kterém agent i cizí tým dokážou bezpečně pokračovat.
+- `AGENTS.md`, skills, runbooky a checks jsou týmová infrastruktura, ne polish navíc.
+- Team lead nestojí modelu za zády a nediktuje další větu každých třicet sekund.
+- Po talku se tým vrací k repu s mapou, planem a prvním checkem, ne s lovem na chytřejší prompt.
+
+### Mikro-cvičení
+
+Použijte stejný malý task ve dvou podmínkách:
+
+1. prompt blob
+2. krátké zadání s `Goal`, `Context`, `Constraints`, `Done When`
+
+Nenechte to sklouznout do debaty o tom, který model je chytřejší.
+
+Pointa:
+
+- přenos záměru
+- přenos mantinelů
+- přenos done criteria
+
+### Most do Build fáze 1
+
+Na konci talku má být jasné:
+
+- teorie tím končí
+- tým se vrací k repu
+- nejdřív vzniká mapa a první explicitní check
+- teprve potom dává smysl další feature motion
+
 ## Build fáze 1
 
 ### Viditelný milestone board

package/assets/workshop-bundle/content/project-briefs/code-review-helper.md

@@ -2,30 +2,30 @@
 
 ## Problém
 
-Code review bývá nevyrovnané. Některé změny projdou s dobrým checklistem a jasným popisem rizik, jiné bez společného rámce. Reviewer pak improvizuje, autor neví, co má ověřit předem, a tým ztrácí konzistenci.
+Code review bývá nevyrovnané. Některé změny projdou s dobrým checklistem a jasným popisem rizik, jiné bez společného rámce. Reviewer pak improvizuje, autor neví, co má ověřit předem, a tým ztrácí konzistenci právě tam, kde by měl být nejpřesnější.
 
-Vaším úkolem je navrhnout nástroj, který z diffu nebo změny vytvoří použitelný review checklist.
+Vaším úkolem je navrhnout nástroj, který z diffu nebo změny vytvoří použitelný review checklist a zároveň jasně oddělí jistotu, heuristiku a místa, kde je pořád potřeba lidský úsudek.
 
 ## User stories
 
-- Jako reviewer chci z diffu rychle získat checklist rizik, otázek a míst, na která se zaměřit.
-- Jako autor změny chci vědět, co mám zkontrolovat ještě před samotným review.
+- Jako reviewer chci z diffu rychle získat checklist změněných hranic, rizik, otázek a míst, na která se zaměřit.
+- Jako autor změny chci vědět, co mám ověřit ještě před samotným review.
 - Jako tým po rotaci chci navázat na heuristiky, které původní tým objevil, místo abych je znovu vymýšlel.
 
 ## Architektonické poznámky
 
-- Může jít o CLI, web nebo jednoduchý skript. Důležitý je jasný tok `diff → analýza → checklist`.
-- Musí být zřejmé, jaké vstupy nástroj očekává a co naopak neumí spolehlivě vyhodnotit.
-- Přidejte seed diff nebo `examples/`, aby šlo workflow lokálně ověřit.
-- Jasně oddělte heuristiku od jistoty. Nástroj má pomáhat reviewerovi, ne předstírat neomylnost.
+- Může jít o CLI, web nebo jednoduchý skript. Důležitý je jasný tok `diff → rubric → checklist`.
+- Musí být zřejmé, jaké vstupy nástroj očekává, co umí označit jistě a co naopak zůstává heuristické.
+- Přidejte seed diff nebo `examples/`, aby šlo workflow lokálně ověřit a další tým rychle přidal nové pravidlo.
+- Nástroj má pomáhat reviewerovi, ne předstírat neomylnost.
 
 ## Hotovo když
 
 - Nástroj vytvoří review checklist ze seed diffu.
-- Výstup odlišuje jistá zjištění od doporučení nebo hypotéz.
+- Výstup odlišuje jistá zjištění od doporučení, hypotéz a bodů pro lidský úsudek.
 - Je jasné, jak přidat nové pravidlo nebo heuristiku bez dlouhého onboardingu.
 - Další tým může během několika minut pokračovat v rozvoji bez chaosu.
 
 ## První krok pro agenta
 
-Nezačínej kódem. Nejdřív napiš pravidla review, tok vstupů a definici toho, co znamená dobrý checklist. Teprve potom navrhni první implementační slice.
+Nezačínej kódem. Nejdřív napiš review rubric, tok vstupů a definici toho, co znamená dobrý checklist. Ukaž, kde je jistota, kde heuristika a co musí posoudit člověk. Teprve potom navrhni první implementační slice.

package/assets/workshop-bundle/content/talks/context-is-king.md

@@ -1,8 +1,14 @@
 # Context is King
 
-## Otevírací moment
+## Otevírací modul
 
-Tento workshop skill i dashboard vznikly stejným způsobem, jakým dnes budeme pracovat my: s AI agentem, ale s důrazem na kontext. Nejde mi o prodej nástroje. Jde mi o to ukázat disciplínu, která z nástroje dělá použitelného spolupracovníka.
+Tenhle workshop skill i dashboard vznikly stejným způsobem, jakým dnes budeme pracovat my: s AI agentem, ale s důrazem na kontext. Nejde mi o prodej nástroje. Jde mi o to ukázat disciplínu, která z nástroje dělá použitelného spolupracovníka.
+
+Rámec pro room launch:
+
+- dnes nezačínáme tool demo ani soutěž v promptování
+- budeme se učit, stavět, předávat i přebírat
+- odpoledne se ukáže, co z práce přežije bez nás
 
 ## Klíčová linka
 
@@ -12,9 +18,26 @@ Moje hlavní věta pro dnešek:
 
 > Neučíme se "lépe promptovat". Učíme se postavit repo a workflow, ve kterém agent i cizí tým dokážou bezpečně pokračovat.
 
+## Analogický beat
+
+Když dáte lidem stejné kostky, nevznikne jedna správná kachna. Stejně tak ze stejného modelu nevzniká jedna správná práce. Rozdíl nedělá jen model. Rozdíl dělá kontext, mantinely, ověřování a představivost týmu.
+
+Pointa analogie:
+
+- stejný agent neznamená stejný výsledek
+- kvalitu neurčuje samotný model
+- pracovní systém kolem agenta je součást výsledku
+
 ## Mikro-cvičení
 
-Všichni dostanou stejný malý úkol. Jedna varianta bude prompt blob. Druhá varianta bude krátké zadání se 4 prvky a s odkazem na kontext zapsaný v repu. Pak porovnáme výsledky. Nehledáme „nejhezčí prompt“. Hledáme způsob práce, který přenese záměr, omezení a kritéria hotovo i do dalšího kroku.
+Všichni dostanou stejný malý task. Jedna varianta bude prompt blob. Druhá varianta bude krátké zadání se 4 prvky a s odkazem na kontext zapsaný v repu. Pak porovnáme výsledky. Nehledáme „nejhezčí prompt“. Hledáme způsob práce, který přenese záměr, omezení a done criteria i do dalšího kroku.
+
+4 prvky pro druhou variantu:
+
+- Goal
+- Context
+- Constraints
+- Done When
 
 ## Hlavní teze
 
@@ -37,6 +60,15 @@ Všichni dostanou stejný malý úkol. Jedna varianta bude prompt blob. Druhá v
 - Když agent dělá víc, já musím lépe ověřovat.
 - Handoff není závěr dne. Je to průběžná podmínka celé práce.
 
+## Most do Build fáze 1
+
+Po tomhle talku se tým nemá vracet k repu s pocitem, že potřebuje jen chytřejší prompt. Má se vracet s jedním jasným očekáváním:
+
+- nejdřív krátká mapa v repu
+- potom plan
+- potom první explicitní check
+- teprve potom další feature motion
+
 ## Závěr
 
 Odpoledne nezažijete jen to, že „AI někdy funguje a někdy ne“. Zažijete, jak moc výsledek závisí na kvalitě pracovního systému, který kolem agenta postavíte.

package/assets/workshop-bundle/docs/harness-cli-foundation.md

@@ -8,7 +8,7 @@ Current implementation in this repo:
 
 - lives in the repository `harness-cli/` package and ships publicly as `@harness-lab/cli`
 - distributes a portable participant workshop skill bundle through `harness skill install`
-- covers `auth login/logout/status` plus `workshop status/create-instance/update-instance/prepare/remove-instance/archive/phase set`
+- covers `auth login/logout/status` plus `workshop status/list-instances/show-instance/create-instance/update-instance/reset-instance/prepare/remove-instance/archive/phase set`
 - targets the existing shared dashboard facilitator APIs
 - is tested for browser/device auth, local-dev Basic Auth fallback, and cookie-backed Neon bootstrap fallback
 - stores sessions in a local file under `HARNESS_CLI_HOME` or `~/.harness` by default
@@ -39,8 +39,11 @@ Required commands:
 - `harness auth logout`
 - `harness auth status`
 - `harness workshop status`
+- `harness workshop list-instances`
+- `harness workshop show-instance <instance-id>`
 - `harness workshop create-instance`
 - `harness workshop update-instance`
+- `harness workshop reset-instance <instance-id>`
 - `harness workshop archive`
 - `harness workshop prepare`
 - `harness workshop remove-instance`
@@ -88,8 +91,13 @@ Current target-selection order:
 
 Current command posture:
 
+- explicit workspace-discovery commands:
+  - `harness workshop list-instances`
+- explicit target required:
+  - `harness workshop show-instance <instance-id>`
 - explicit target required:
   - `harness workshop update-instance <instance-id>`
+  - `harness workshop reset-instance <instance-id>`
   - `harness workshop prepare <instance-id>`
   - `harness workshop remove-instance <instance-id>`
 - explicit target is the created resource:
@@ -103,6 +111,7 @@ Current discoverability path:
 
 - facilitators can inspect available workshop instances through the dashboard workspace view
 - the same platform-scoped list lives behind the authenticated instances API surface at `/api/workshop/instances`
+- the CLI should expose that list directly so facilitator skills do not need session-file inspection or raw authenticated scripts for routine discovery
 
 For the current facilitator lifecycle slice:
 
@@ -115,6 +124,11 @@ Current step-up posture:
 - the existing CLI command set (`workshop status/archive/phase set`) may run on a valid brokered device session
 - future higher-risk commands such as facilitator grant/revoke or destructive instance mutations should require a fresh browser approval window rather than silently reusing an older CLI session
 
+Content refresh posture:
+
+- after changing authored participant-facing sources in `workshop-skill/`, `content/`, or `workshop-blueprint/`, refresh the portable bundle and verify it before shipping facilitator or participant guidance
+- when those changes must land in already-created workshop instances, `workshop reset-instance` is the intended re-import path
+
 ## Session Storage Posture
 
 Default storage backend:

package/assets/workshop-bundle/workshop-blueprint/README.md

@@ -39,7 +39,7 @@ Do not use this folder for live event state. Real dates, rooms, rosters, checkpo
 ### Structured data
 
 - [`agenda.json`](agenda.json)
-  Public-readable workshop agenda summary and workshop metadata.
+  Public-readable 10-phase mirror of the workshop day and workshop metadata.
 
 ## Related Runtime Documents
 
@@ -51,5 +51,6 @@ For maintainers working in the source repository, the runtime-facing structured
 
 - `docs/workshop-content-language-architecture.md`
 - `dashboard/lib/workshop-blueprint-agenda.json`
+- `dashboard/lib/workshop-blueprint-localized-content.ts`
 
-Treat those as maintainer/source-repo references, not as portable participant-bundle docs.
+Treat those as maintainer/source-repo references, not as portable participant-bundle docs. The public `agenda.json` file should stay aligned with the same phase structure, but it is not the runtime import source.

package/assets/workshop-bundle/workshop-blueprint/agenda.json

@@ -1,21 +1,23 @@
 {
-  "version": 1,
+  "version": 2,
   "blueprintId": "harness-lab-core-day",
   "title": "Harness Lab",
-  "subtitle": "Workshop operating system pro práci s AI agenty",
+  "subtitle": "Public-readable 10-phase mirror of the Harness Lab workshop day",
+  "presentationMode": "public-readable-mirror",
+  "sourceNote": "Runtime imports come from dashboard/lib/workshop-blueprint-agenda.json plus dashboard/lib/workshop-blueprint-localized-content.ts.",
   "principles": [
-    "Mapa před pohybem",
-    "Ověření je hranice důvěry",
-    "Pište tak, aby další tým mohl pokračovat"
+    "Context before generation",
+    "Verification is the trust boundary",
+    "Work so another team can continue"
   ],
   "phases": [
     {
       "id": "opening",
       "order": 1,
-      "label": "Úvod a naladění",
+      "label": "Opening and framing",
       "startTime": "09:10",
       "kind": "shared",
-      "goal": "Rámec dne: nejde o promptování, ale o repo a workflow, které přežijí handoff."
+      "goal": "Shift the room from prompt-hackathon expectations to continuation-quality discipline."
     },
     {
       "id": "talk",
@@ -23,31 +25,71 @@
       "label": "Context is King",
       "startTime": "09:40",
       "kind": "shared",
-      "goal": "Krátký talk a porovnání přístupů. Krátká mapa v repu je silnější než prompt blob."
+      "goal": "Turn context into a precise thesis: AGENTS.md, plans, and checks are working infrastructure, not polish."
     },
     {
-      "id": "build-1",
+      "id": "demo",
       "order": 3,
+      "label": "Demo",
+      "startTime": "10:05",
+      "kind": "shared",
+      "goal": "Show one compact workflow story: context, planning, implementation, review, and safe fallback moves."
+    },
+    {
+      "id": "build-1",
+      "order": 4,
       "label": "Build Phase 1",
       "startTime": "10:30",
       "kind": "team",
-      "goal": "Nejdřív udělejte z repa operating surface: krátké AGENTS.md, plán, build/test flow, první ověření a první reviewed output."
+      "goal": "Before lunch, get every team to a navigable repo, AGENTS.md, a plan, one explicit check, and a first reviewed slice."
+    },
+    {
+      "id": "intermezzo-1",
+      "order": 5,
+      "label": "Intermezzo 1",
+      "startTime": "11:40",
+      "kind": "shared",
+      "goal": "Surface one change, one proof, and one next move from the room before lunch momentum slips."
+    },
+    {
+      "id": "lunch-reset",
+      "order": 6,
+      "label": "Lunch Reset",
+      "startTime": "12:15",
+      "kind": "shared",
+      "goal": "Frame lunch as a handoff preparation point, not as a pause between unrelated workshop blocks."
     },
     {
       "id": "rotation",
-      "order": 4,
-      "label": "Rotace týmů",
+      "order": 7,
+      "label": "Continuation Shift",
       "startTime": "13:30",
       "kind": "team",
-      "goal": "Plný přesun lidí mezi stoly. Nejdřív čtěte a napište diagnózu, až pak měňte kód."
+      "goal": "Force silent repo reading, diagnosis, and explicit continuation before anyone edits code."
+    },
+    {
+      "id": "build-2",
+      "order": 8,
+      "label": "Build Phase 2",
+      "startTime": "14:05",
+      "kind": "team",
+      "goal": "Turn continuation friction into better repo guidance, stronger checks, and clearer next moves."
+    },
+    {
+      "id": "intermezzo-2",
+      "order": 9,
+      "label": "Intermezzo 2",
+      "startTime": "15:05",
+      "kind": "shared",
+      "goal": "Name which repo signals actually saved time during continuation and which failures repeated."
     },
     {
       "id": "reveal",
-      "order": 5,
-      "label": "Reveal a reflexe",
+      "order": 10,
+      "label": "Reveal and reflection",
       "startTime": "15:45",
       "kind": "shared",
-      "goal": "Co pomohlo pokračovat, co chybělo, a kterou bolest teď proměníme v lepší harness."
+      "goal": "Turn the day into reusable practice: what helped continuation, what failed, and what should change next week."
     }
   ],
   "runtimeImport": {

package/assets/workshop-bundle/workshop-blueprint/day-structure.md

@@ -103,6 +103,31 @@ Habit installed:
 - cleanup and codification are part of delivery
 - repeated pain should become a better template, check, or runbook
 
+## Narrative Spine
+
+The day should not feel like separate agenda cards. Each phase should change what the room now understands and what it is ready to do next.
+
+- `opening`:
+  Shift the room from "AI hackathon energy" to "continuation-quality discipline." The key belief is that handoff without verbal rescue is part of the assignment from the first hour.
+- `talk`:
+  Shift the room from a vague sense that context matters to a precise thesis: harness engineering is team infrastructure, not prompt cosmetics.
+- `demo`:
+  Shift the room from abstract agreement to an observable workflow. The room should see context, plan, implementation, and review as one repeatable system.
+- `build-1`:
+  Shift teams from listening to evidence. Before lunch, the repo needs to show map, plan, one executable check, and one verified step.
+- `intermezzo-1`:
+  Shift from isolated table work to shared learning. The room should hear concrete repo signals, not generic progress reporting.
+- `lunch-reset`:
+  Shift from local progress to handoff readiness. Going to lunch without a readable next safe step should feel unfinished.
+- `rotation`:
+  Shift from authorship to inheritance. The receiving team must read first, diagnose second, and edit only after it can explain the state.
+- `build-2`:
+  Shift from frustration to codification. Weak continuation signals should turn into clearer repo guidance, stronger checks, and better runbooks.
+- `intermezzo-2`:
+  Shift from anecdotes about the afternoon to concrete continuation evidence. The room should identify which repo signals actually saved time.
+- `reveal`:
+  Shift from reflection to adoption. The close should turn signals from the day into next-week practice and into improvements to the reusable workshop blueprint.
+
 ## What Must Survive In The Repo
 
 - goal and constraints
@@ -122,8 +147,8 @@ Habit installed:
 - `AGENTS.md` as a table of contents that points to deeper sources of truth
 - small, continuous garbage collection before bad patterns spread
 
-## Canonical Agenda Source
+## Agenda Mirror
 
-The reusable agenda lives in [`agenda.json`](agenda.json).
+The public-readable 10-phase mirror lives in [`agenda.json`](agenda.json).
 
-Runtime workshop instances import from that blueprint and then track live phase position, reveal state, teams, and checkpoints locally in the private runtime layer.
+Runtime workshop instances import from the maintained dashboard blueprint source pair and then track live phase position, reveal state, teams, and checkpoints locally in the private runtime layer.

package/assets/workshop-bundle/workshop-skill/facilitator.md

@@ -65,6 +65,59 @@ Show:
 - facilitator list with roles
 - team count
 
+Use this for the current default or selected workshop context.
+If the facilitator needs the full workspace registry first, use `list-instances` instead of probing local session files or writing raw authenticated fetch scripts.
+
+### `/workshop facilitator list-instances`
+
+Preferred path:
+
+```bash
+harness workshop list-instances
+```
+
+Show:
+- facilitator-visible instance ids
+- template id
+- status
+- content language
+- event title and room metadata when present
+
+Raw API reference:
+
+```http
+GET {DASHBOARD_URL}/api/workshop/instances
+```
+
+Rules:
+- prefer this over inspecting local session files or composing one-off authenticated scripts
+- use it when the facilitator needs to discover which live instances exist before reset, update, or scene work
+- keep raw API usage as a diagnostic fallback, not the default operator workflow
+
+### `/workshop facilitator show-instance <instance-id>`
+
+Preferred path:
+
+```bash
+harness workshop show-instance sample-workshop-demo-orbit
+```
+
+Show:
+- one explicit instance record
+- summary metadata for quick operator inspection
+- the full instance payload when the facilitator needs exact values before a mutation
+
+Raw API reference:
+
+```http
+GET {DASHBOARD_URL}/api/workshop/instances/{instanceId}
+```
+
+Rules:
+- use this when the facilitator needs one specific instance, not the deployment-default `workshop status`
+- if the route returns `404`, the instance does not exist or is not visible to the facilitator
+- prefer this over ad hoc authenticated scripts for routine discovery
+
 ### `/workshop facilitator grant <email> <role>`
 
 Use the CLI-backed privileged request path. The skill should not handle auth bootstrap itself.
@@ -176,6 +229,33 @@ Rules:
 - send only the fields you want to change
 - do not use reset for an ordinary title, venue, or room correction
 - if the route returns `400`, the payload is wrong; if it returns `404`, the instance does not exist
+- use `--content-lang cs|en` when the facilitator intends to change the workshop delivery language for that instance
+
+### `/workshop facilitator reset-instance <instance-id>`
+
+Preferred path:
+
+```bash
+harness workshop reset-instance sample-workshop-demo-orbit --template-id blueprint-default
+```
+
+Raw API reference:
+
+```http
+PATCH {DASHBOARD_URL}/api/workshop/instances/{instanceId}
+Content-Type: application/json
+
+{
+  "action": "reset",
+  "templateId": "blueprint-default"
+}
+```
+
+Rules:
+- use this when the goal is to re-import fresh blueprint-owned workshop content into an existing instance
+- warn that reset archives current runtime state first and then clears live runtime state for the instance
+- prefer `update-instance` for ordinary metadata corrections; reset is the high-impact operation
+- if the facilitator does not specify a template, keep the current template unless there is a clear reason to switch
 
 ### `/workshop facilitator prepare`
 
@@ -291,6 +371,14 @@ Presenter scenes are agenda-linked, room-facing outputs for the facilitator and
 - delete a local scene
 - read and optionally edit `facilitatorNotes`, `sourceRefs`, and `blocks`
 
+Rich-scene rules:
+
+- keep presenter scenes agenda-linked; do not invent a separate slide-deck source of truth
+- prefer one dominant voice and one main idea per scene
+- for reusable visuals, prefer reviewed local blueprint assets and metadata over ad hoc remote image URLs
+- runtime edits remain instance-local until a maintainer deliberately publishes them back into the repo
+- when working in the source repo, use the maintainer playbook in `docs/presenter-rich-scene-authoring.md` for drafting, refinement, and publish-back
+
 Per-instance route:
 
 ```http

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@harness-lab/cli",
-  "version": "0.2.6",
+  "version": "0.2.8",
   "description": "Participant-facing Harness Lab CLI for facilitator auth and workshop operations",
   "license": "MIT",
   "type": "module",

package/src/client.js

@@ -90,6 +90,12 @@ export function createHarnessClient({ fetchFn, session }) {
     getWorkshopStatus() {
       return request("/api/workshop");
     },
+    listWorkshopInstances() {
+      return request("/api/workshop/instances");
+    },
+    getWorkshopInstance(instanceId) {
+      return request(`/api/workshop/instances/${encodeURIComponent(instanceId)}`);
+    },
     getAgenda() {
       return request("/api/agenda");
     },
@@ -108,6 +114,15 @@ export function createHarnessClient({ fetchFn, session }) {
         body: { action: "update_metadata", ...input },
       });
     },
+    resetWorkshopInstance(instanceId, templateId) {
+      return request(`/api/workshop/instances/${encodeURIComponent(instanceId)}`, {
+        method: "PATCH",
+        body: {
+          action: "reset",
+          ...(templateId ? { templateId } : {}),
+        },
+      });
+    },
     prepareWorkshopInstance(instanceId) {
       return request("/api/workshop", {
         method: "POST",

package/src/run-cli.js

@@ -103,6 +103,7 @@ async function readRequiredCommandValue(io, flags, keys, promptLabel, fallbackVa
 
 function buildWorkshopMetadataInput(flags) {
   const input = {
+    contentLang: readStringFlag(flags, "content-lang", "content-language"),
     eventTitle: readStringFlag(flags, "event-title", "title"),
     city: readStringFlag(flags, "city"),
     dateRange: readStringFlag(flags, "date-range", "date"),
@@ -122,6 +123,7 @@ function hasWorkshopMetadataInput(input) {
 
 async function promptWorkshopMetadataInput(io) {
   const prompts = [
+    ["contentLang", "Content language (cs/en, leave blank to skip): "],
     ["eventTitle", "Event title (leave blank to skip): "],
     ["city", "City (leave blank to skip): "],
     ["dateRange", "Date range (leave blank to skip): "],
@@ -148,7 +150,9 @@ function summarizeWorkshopInstance(instance) {
 
   return {
     instanceId: instance?.id ?? null,
+    templateId: instance?.templateId ?? null,
     status: instance?.status ?? null,
+    contentLang: workshopMeta.contentLang ?? null,
     eventTitle: workshopMeta.eventTitle ?? null,
     city: workshopMeta.city ?? null,
     dateRange: workshopMeta.dateRange ?? null,
@@ -175,9 +179,12 @@ function printUsage(io, ui) {
     "harness auth status",
     "harness skill install [--target PATH] [--force]",
     "harness workshop status",
+    "harness workshop list-instances",
+    "harness workshop show-instance <instance-id>",
     "harness workshop archive [--notes TEXT]",
-    "harness workshop create-instance [<instance-id>] [--template-id ID] [--event-title TEXT] [--city CITY]",
-    "harness workshop update-instance <instance-id> [--event-title TEXT] [--city CITY]",
+    "harness workshop create-instance [<instance-id>] [--template-id ID] [--content-lang cs|en] [--event-title TEXT] [--city CITY]",
+    "harness workshop update-instance <instance-id> [--content-lang cs|en] [--event-title TEXT] [--city CITY]",
+    "harness workshop reset-instance <instance-id> [--template-id ID]",
     "harness workshop prepare <instance-id>",
     "harness workshop remove-instance <instance-id>",
     "harness workshop phase set <phase-id>",
@@ -582,6 +589,67 @@ async function handleWorkshopStatus(io, ui, env, deps) {
   }
 }
 
+async function handleWorkshopListInstances(io, ui, env, deps) {
+  const session = await requireSession(io, ui, env);
+  if (!session) {
+    return 1;
+  }
+
+  try {
+    const client = createHarnessClient({ fetchFn: deps.fetchFn, session });
+    const result = await client.listWorkshopInstances();
+    const items = Array.isArray(result?.items) ? result.items.map((instance) => summarizeWorkshopInstance(instance)) : [];
+    ui.json("Workshop Instances", {
+      ok: true,
+      count: items.length,
+      items,
+    });
+    return 0;
+  } catch (error) {
+    if (error instanceof HarnessApiError) {
+      ui.status("error", `List instances failed: ${error.message}`, { stream: "stderr" });
+      return 1;
+    }
+    throw error;
+  }
+}
+
+async function handleWorkshopShowInstance(io, ui, env, positionals, flags, deps) {
+  const session = await requireSession(io, ui, env);
+  if (!session) {
+    return 1;
+  }
+
+  const instanceId = await readRequiredCommandValue(
+    io,
+    flags,
+    ["id", "instance-id"],
+    "Instance id: ",
+    readOptionalPositional(positionals, 2),
+  );
+  if (!instanceId) {
+    ui.status("error", "Instance id is required.", { stream: "stderr" });
+    return 1;
+  }
+
+  try {
+    const client = createHarnessClient({ fetchFn: deps.fetchFn, session });
+    const result = await client.getWorkshopInstance(instanceId);
+    ui.json("Workshop Instance", {
+      ok: true,
+      ...summarizeWorkshopInstance(result.instance),
+      instance: result.instance,
+    });
+    return 0;
+  } catch (error) {
+    if (error instanceof HarnessApiError) {
+      ui.status("error", `Show instance failed: ${error.message}`, { stream: "stderr" });
+      return 1;
+    }
+    throw error;
+  }
+}
+
 async function handleWorkshopArchive(io, ui, env, flags, deps) {
   const session = await requireSession(io, ui, env);
   if (!session) {
@@ -731,6 +799,41 @@ async function handleWorkshopPrepare(io, ui, env, positionals, flags, deps) {
   }
 }
 
+async function handleWorkshopResetInstance(io, ui, env, positionals, flags, deps) {
+  const session = await requireSession(io, ui, env);
+  if (!session) {
+    return 1;
+  }
+
+  const instanceId = await readRequiredCommandValue(
+    io,
+    flags,
+    ["id", "instance-id"],
+    "Instance id: ",
+    readOptionalPositional(positionals, 2),
+  );
+  if (!instanceId) {
+    ui.status("error", "Instance id is required.", { stream: "stderr" });
+    return 1;
+  }
+
+  try {
+    const client = createHarnessClient({ fetchFn: deps.fetchFn, session });
+    const result = await client.resetWorkshopInstance(
+      instanceId,
+      readStringFlag(flags, "template-id", "template"),
+    );
+    ui.json("Workshop Reset Instance", result);
+    return 0;
+  } catch (error) {
+    if (error instanceof HarnessApiError) {
+      ui.status("error", `Reset instance failed: ${error.message}`, { stream: "stderr" });
+      return 1;
+    }
+    throw error;
+  }
+}
+
 async function handleWorkshopRemoveInstance(io, ui, env, positionals, flags, deps) {
   const session = await requireSession(io, ui, env);
   if (!session) {
@@ -844,6 +947,14 @@ export async function runCli(argv, io, deps = {}) {
     return handleWorkshopStatus(io, ui, io.env, mergedDeps);
   }
 
+  if (scope === "workshop" && action === "list-instances") {
+    return handleWorkshopListInstances(io, ui, io.env, mergedDeps);
+  }
+
+  if (scope === "workshop" && action === "show-instance") {
+    return handleWorkshopShowInstance(io, ui, io.env, positionals, flags, mergedDeps);
+  }
+
   if (scope === "workshop" && action === "archive") {
     return handleWorkshopArchive(io, ui, io.env, flags, mergedDeps);
   }
@@ -856,6 +967,10 @@ export async function runCli(argv, io, deps = {}) {
     return handleWorkshopUpdateInstance(io, ui, io.env, positionals, flags, mergedDeps);
   }
 
+  if (scope === "workshop" && action === "reset-instance") {
+    return handleWorkshopResetInstance(io, ui, io.env, positionals, flags, mergedDeps);
+  }
+
   if (scope === "workshop" && action === "prepare") {
     return handleWorkshopPrepare(io, ui, io.env, positionals, flags, mergedDeps);
   }