@harness-lab/cli 0.2.8 → 0.3.0

package/assets/workshop-bundle/docs/learner-resource-kit.md

@@ -1,27 +1,27 @@
 # Learner Resource Kit
 
-Tato stránka definuje účastnický kit zdrojů pro Harness Lab.
+This page defines the participant learner kit for Harness Lab.
 
-Je to malá, kopírovatelná část repa, kterou si mají účastníci odnést, projít a znovu použít ve vlastních projektech.
+It is the small, portable subset of the repo that participants should take away, review, and reuse in their own projects.
 
-## Základní pravidlo
+## Ground Rule
 
-Learner kit není celý backstage workshopu.
+The learner kit is not the full workshop backstage.
 
-Má odpovídat na otázky:
-- co si mám z workshopu zkopírovat do vlastního repa?
-- co má agent udělat jako první?
-- jak zařídit, aby práce přežila handoff?
-- co musím ověřit, než výsledku uvěřím?
+It should answer:
+- what should I copy into a real repo?
+- what should the agent or team do first?
+- how do I make the work survive handoff?
+- what do I need to verify before I trust the result?
 
-Výchozí pracovní rytmus, který má learner kit posilovat, je:
+Default participant rhythm the learner kit should reinforce:
 - `workshop` pro orientaci
 - `brainstorm` nebo `plan` před větším řezem
 - `work` proti jednomu ověřitelnému cíli
 - `review` před důvěrou
 - `compound` a průběžný úklid pro věci, které mají přežít session
 
-## Jádro learner kitu
+## Learner Kit Core
 
 ### 1. Workshop skill
 
@@ -31,34 +31,34 @@ Hlavní rozhraní pro účastníky:
 - [`workshop-skill/reference.md`](../workshop-skill/reference.md)
 - [`workshop-skill/recap.md`](../workshop-skill/recap.md)
 
-Proč sem patří:
-- ukazuje, jak může skill pro účastníky vést setup, workflow i ověřování v češtině
-- je to reálné rozhraní opřené o repo, ne workshopový slide artefakt
+Why it belongs here:
+- it shows how a participant skill can guide setup, workflow, and verification
+- it is a real repo-backed interface, not only a workshop slide artifact
 
-### 2. `AGENTS.md` příklad
+### 2. `AGENTS.md` example
 
 Výchozí starter:
 - [`workshop-skill/template-agents.md`](../workshop-skill/template-agents.md)
 
-Proč sem patří:
-- je to nejmenší znovupoužitelný příklad trvalého kontextu v repu
-- účastníci ho mohou upravit přímo pro vlastní projekt
+Why it belongs here:
+- it is the smallest reusable example of durable repo context
+- participants can adapt it directly for a real project
 
-### 3. Příklad pro ověření a review
+### 3. Verification and review example
 
 Výchozí checklist:
 - [`workshop-skill/analyze-checklist.md`](../workshop-skill/analyze-checklist.md)
 
-Proč sem patří:
-- dává konkrétní standard pro otázku „dokáže odtud pokračovat další tým?“
-- převádí kvalitu repa do checklistu, který jde opravdu projít
+Why it belongs here:
+- it gives a concrete standard for “can another team continue from here?”
+- it turns repo quality into a checklist people can actually run
 
 ### 4. Challenge cards
 
 Doporučený subset:
 - [`content/challenge-cards/deck.md`](../content/challenge-cards/deck.md)
 
-Použití:
+Use:
 - malé zásahy během workshopu
 - nápověda, co zlepšit později v reálném repu
 
@@ -68,31 +68,31 @@ Posílení po workshopu:
 - [`workshop-skill/follow-up-package.md`](../workshop-skill/follow-up-package.md)
 - [`materials/participant-resource-kit.md`](../materials/participant-resource-kit.md)
 
-Proč sem patří:
-- proměňuje workshop z jednodenní akce na opakovatelný impuls ke změně chování
-- dává doslovný handout, který lze poslat nebo vytisknout bez dalšího vysvětlování
+Why it belongs here:
+- it turns the workshop from a one-day event into a repeatable behaviour change
+- it gives a literal handout that can be sent or printed without extra explanation
 
-## Kdy který artefakt použít
+## When To Use Which Artifact
 
-### Během setupu
+### During setup
 
 Použijte:
 - [`workshop-skill/setup.md`](../workshop-skill/setup.md)
 - [`workshop-skill/reference.md`](../workshop-skill/reference.md)
 
-### Během build fáze 1
+### During Build Phase 1
 
 Použijte:
 - [`workshop-skill/template-agents.md`](../workshop-skill/template-agents.md)
-- karty `Context Engineering` v [`content/challenge-cards/deck.md`](../content/challenge-cards/deck.md)
+- karty `Před obědem: postavte pracovní systém` v [`content/challenge-cards/deck.md`](../content/challenge-cards/deck.md)
 
-### Během odpoledního převzetí
+### During the afternoon takeover
 
 Použijte:
 - [`workshop-skill/analyze-checklist.md`](../workshop-skill/analyze-checklist.md)
-- karty `Workflow` v [`content/challenge-cards/deck.md`](../content/challenge-cards/deck.md)
+- karty `Po rotaci: opravte signál, ne jen feature` v [`content/challenge-cards/deck.md`](../content/challenge-cards/deck.md)
 
-### Po workshopu
+### After the workshop
 
 Použijte:
 - [`workshop-skill/recap.md`](../workshop-skill/recap.md)
@@ -100,9 +100,9 @@ Použijte:
 - [`materials/participant-resource-kit.md`](../materials/participant-resource-kit.md)
 - [`learner-reference-gallery.md`](learner-reference-gallery.md)
 
-## Co si odnést do reálného projektu
+## What To Carry Into A Real Project
 
-Účastníci by měli odejít s těmito konkrétními kroky:
+Participants should leave with these concrete moves:
 
 1. Přidejte `AGENTS.md` s částmi:
    - goal
@@ -117,9 +117,9 @@ Použijte:
 7. Před větší implementací použijte plan a po větší změně review nebo check.
 8. Když už používáte externí workflow skill pack, napojte ho až nad tento základ místo toho, abyste jím nahrazovali kontext zapsaný v repu a ověřování.
 
-## Co sem nepatří
+## What Does Not Belong Here
 
-Learner kit nemá obsahovat plný backstage provozní detail, například:
+The learner kit should not include full backstage operational detail, for example:
 - runbooky pro konkrétní workshop instance
 - privátní runtime architekturu a operace
 - monitoring nebo řídicí postupy jen pro facilitátory

package/assets/workshop-bundle/materials/coaching-codex.md

@@ -0,0 +1,76 @@
+# Coaching Codex — the pocket card
+
+> One page. Steal the moves. Print it if you want.
+
+The workshop teaches that context, not prompts, is what makes agent work survive. This card is the other half: the **conversational moves** that keep the agent inside a working harness once you start a session. Most of the gap between "it worked" and "it didn't" is right here.
+
+---
+
+## Before you let the agent write code
+
+Ask these, in this order. Do not skip ahead.
+
+1. **"Before you implement, read [file X] and state the three patterns you're going to reuse."**
+   Catches misreading in 30 seconds. Costs nothing.
+
+2. **"What's the smallest change that could prove this approach works?"**
+   Forces a tracer bullet instead of a spec rewrite. The answer is often "one function plus one test."
+
+3. **"What's the done criteria — a command I can run or a file I can look at — that tells us this is finished?"**
+   If the agent can't name one, neither of you knows what "done" means. Stop.
+
+4. **"What could go wrong? Name one failure mode I haven't told you about."**
+   This is the single best drift detector. If the agent says "nothing", treat that as a yellow flag and push back.
+
+5. **"Show me the plan as three steps. Not the code. The plan."**
+   Cheap to redirect a plan. Expensive to redirect 300 lines of code.
+
+---
+
+## While the agent is working
+
+- **If it starts implementing before answering the five questions above, stop it.** The session is drifting. Go back to the plan.
+- **If it says "I've completed the task", ask: "What did you verify?"** Not "did the tests pass" — "what did you verify". Force it to name the evidence, not the feeling.
+- **If it adds a file you didn't ask for, ask "why this file?" before accepting.** Extra files are the first sign of improvisation.
+- **If it tries to weaken a constraint ("we could skip this test"), refuse and re-read the constraint aloud.** Constraints you negotiate down always come back.
+
+---
+
+## When the agent says it's done
+
+Run this short script, always:
+
+1. **"Show me the diff."** Read it. If you don't want to read it, the agent isn't done — you are.
+2. **"What test covers the change?"** If none, the change isn't covered. That's not a moral judgment; it's a statement about tomorrow's bug.
+3. **"What could the next team misread about this?"** This is your handoff check. The agent's answer is where your next `AGENTS.md` update comes from.
+4. **"What is the next safe step if we continue from here?"** If the answer is "I'm not sure", you haven't left a harness; you've left debris.
+
+---
+
+## When you disagree with the agent
+
+- **Don't argue.** Arguing with an agent in a session is a sign the harness is missing. Exit the chat, strengthen the repo, re-enter.
+- **Name the disagreement as a rule.** "We don't use `any` in this repo" is a rule. Write it down. Move it into `AGENTS.md`. Don't re-type it next session.
+- **Ask: "Which file in the repo should have prevented this?"** The answer is usually a doc that doesn't exist yet. Create it.
+
+---
+
+## The three questions that reset a stuck session
+
+When you feel the session going sideways, stop and ask these out loud, to yourself first:
+
+1. **What are we trying to prove right now?**
+2. **Which repo artifact is missing that would have prevented this?**
+3. **What is the smallest check that returns this work from confidence back to reality?**
+
+If you can't answer any of the three, the session is done. Close it. Come back when you can.
+
+---
+
+## The one rule to remember
+
+**You are not prompting the agent. You are coaching a collaborator that forgets everything between sessions.** The only memory you share is the repo. Act accordingly.
+
+---
+
+*Pairs with [`content/codex-craft.md`](../content/codex-craft.md) — the tool-specific fluency doc — and with the workshop talk [`content/talks/context-is-king.md`](../content/talks/context-is-king.md).*

package/assets/workshop-bundle/materials/locales/en/participant-resource-kit.md

@@ -17,8 +17,7 @@ Default template:
 
 Choose at least one:
 - build/test commands
-- a RED test
-- a tracer bullet
+- an executable check (unit test or tracer bullet)
 - a review checklist
 
 When the agent handles a larger slice of work, “I skimmed it quickly” is not enough.
@@ -60,6 +59,8 @@ Do not let the model drive your normal signed-in browser by default without sand
 - [`workshop-skill/locales/en/reference.md`](../../../workshop-skill/locales/en/reference.md)
 - [`workshop-skill/locales/en/recap.md`](../../../workshop-skill/locales/en/recap.md)
 - [`docs/locales/en/learner-reference-gallery.md`](../../../docs/locales/en/learner-reference-gallery.md)
+- [`content/codex-craft.md`](../../../content/codex-craft.md) — Codex-specific craft: approval modes, sandboxing, long-horizon drift, a representative before/after prompt pair, and a failure-recovery walkthrough
+- [`materials/coaching-codex.md`](../../coaching-codex.md) — the one-page pocket card of conversational moves for coaching an agent
 
 Note:
 - the `workshop` skill is the guaranteed workshop default
@@ -70,3 +71,14 @@ Note:
 1. Add `AGENTS.md` to one real project.
 2. Move one durable rule from a prompt into the repo.
 3. Add one review or handoff checklist.
+
+## What to read after the workshop to stay current
+
+Codex and other coding agents ship new capabilities monthly. This kit is not a frozen reference — it is a starting harness for your own reading practice.
+
+- **Codex CLI release notes** — read them on every release. The approval-mode and sandboxing changes are the ones that matter most.
+- **Simon Willison's blog** ([simonwillison.net](https://simonwillison.net/)) — one of the densest practical sources on Codex, Claude Code, and other coding agents. He works with these tools daily and writes it down.
+- **OpenAI Harness Engineering articles** — see `docs/learner-reference-gallery.md` for links.
+- **Anthropic engineering blog** — if you use Claude Code, follow the official posts.
+- **Your own `AGENTS.md` as a living document** — re-read them every quarter with a skeptical eye. Delete anything that is no longer load-bearing. Simplicity is part of the harness.
+- **Your own `docs/solutions/` or runbook** — when you find a failure mode in your own work, write it down. Your team should learn from your team's mistakes, not just from this kit.

package/assets/workshop-bundle/materials/participant-resource-kit.md

@@ -1,6 +1,6 @@
 # Participant Resource Kit
 
-Krátká sada artefaktů, které si můžete odnést z Harness Lab do vlastního projektu.
+Krátká sada artefaktů, které si můžete odnést z Harness Lab do vlastního projektu.
 
 ## 1. Začněte `AGENTS.md`
 
@@ -17,8 +17,7 @@ Výchozí šablona:
 
 Vyberte si alespoň jeden:
 - build/test příkazy
-- RED test
-- tracer bullet
+- spustitelné ověření (unit test nebo tracer bullet)
 - review checklist
 
 Když agent dělá větší kus práce, nestačí „rychle jsem to projel očima“.
@@ -29,16 +28,16 @@ Checklist pro handoff:
 ## 3. Používejte malý workflow, ne chaos
 
 Doporučený základ:
-- `workshop` pro orientaci a další bezpečný krok
+- `workshop` pro orientaci a další bezpečný krok
 - `/brainstorm`, když ještě není jasný scope nebo první slice
 - `/plan` před větší implementací
 - `/work` nebo jiný úzký implementační loop, když už víte co stavíte
-- test nebo jiný executable check před důležitou změnou
+- test nebo jiné spustitelné ověření před důležitou změnou
 - `/review` po větším kusu práce
-- `/compound` nebo krátká poznámka zapsaná přímo v repu, když objev udělá další práci levnější
-- průběžný úklid: build/test příkazy, omezení a handoff poznámky přesouvejte z chatu do repa
+- `/compound` nebo krátká poznámka zapsaná přímo v repu, když objev udělá další práci levnější
+- průběžný úklid: build/test příkazy, omezení a handoff poznámky přesouvejte z chatu do repa
 
-## 4. Přesuňte jedno pravidlo z chatu do repa
+## 4. Přesuňte jedno pravidlo z chatu do repa
 
 Typické kandidáty:
 - build/test příkazy
@@ -53,20 +52,33 @@ Výchozí pattern:
 - `Playwright regression`
 - `human review`
 
-Nenechávejte model jako výchozí volbu ovládat váš běžný přihlášený browser bez sandboxu a kontroly.
+Nenechávejte model jako výchozí volbu ovládat váš běžný přihlášený browser bez sandboxu a kontroly.
 
 ## 6. Co si projít po workshopu
 
 - [`workshop-skill/reference.md`](../workshop-skill/reference.md)
 - [`workshop-skill/recap.md`](../workshop-skill/recap.md)
 - [`docs/learner-reference-gallery.md`](../docs/learner-reference-gallery.md)
+- [`content/codex-craft.md`](../content/codex-craft.md) — Codex-specific craft (approval módy, sandboxing, long-horizon drift, před/po příklad, failure recovery)
+- [`materials/coaching-codex.md`](coaching-codex.md) — jednostránkový pocket card konverzačních tahů pro coaching agenta
 
 Poznámka:
 - `workshop` skill je garantovaný výchozí nástroj workshopu
-- další workflow skills a veřejné toolkity berte jako volitelné akcelerátory, ne povinný setup
+- další workflow skills a veřejné toolkity berte jako volitelné akcelerátory, ne povinný setup
 
 ## Výzva na příští týden
 
 1. Přidejte `AGENTS.md` do jednoho reálného projektu.
-2. Přesuňte jedno trvalé pravidlo z promptu do repa.
+2. Přesuňte jedno trvalé pravidlo z promptu do repa.
 3. Přidejte jeden review nebo handoff checklist.
+
+## Co číst po workshopu, abyste zůstali aktuální
+
+Codex a další kódovací agenti se mění měsíčně. Tenhle kit není zmrazená reference — je to startovní harness pro vaši vlastní čtecí praxi.
+
+- **Codex CLI release notes** — čtěte při každém vydání. Změny v approval módech a sandboxingu jsou ty nejdůležitější.
+- **Simon Willison's blog** ([simonwillison.net](https://simonwillison.net/)) — jeden z nejhustších praktických zdrojů o Codexu, Claude Code a dalších agentech. Denně pracuje s těmito nástroji a zapisuje si to.
+- **OpenAI Harness Engineering articles** — viz `docs/learner-reference-gallery.md` pro odkazy.
+- **Anthropic engineering blog** — když pracujete s Claude Code, sledujte oficiální posts.
+- **Vlastní `AGENTS.md` jako živý dokument** — každé čtvrtletí si je znovu přečtěte skeptickým okem. Smažte, co už není nosné. Jednoduchost je součást harnessu.
+- **Vlastní `docs/solutions/` nebo runbook** — když narazíte na failure mode ve své práci, zapište si ho. Váš tým se má učit ze svých vlastních chyb, ne jen z tohoto kitu.

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

@@ -18,8 +18,7 @@ Do not use this folder for live event state. Real dates, rooms, rosters, checkpo
 2. [`teaching-spine.md`](teaching-spine.md)
 3. [`operator-guide.md`](operator-guide.md)
 4. [`control-surfaces.md`](control-surfaces.md)
-5. [`edit-boundaries.md`](edit-boundaries.md)
-6. [`agenda.json`](agenda.json)
+5. [`agenda.json`](agenda.json)
 
 ## Blueprint Contents
 
@@ -33,8 +32,6 @@ Do not use this folder for live event state. Real dates, rooms, rosters, checkpo
   Explains how a facilitator prepares, runs, and closes a workshop.
 - [`control-surfaces.md`](control-surfaces.md)
   Defines participant surface, facilitator dashboard, facilitator skill, and the `harness` CLI as equal clients of one runtime model.
-- [`edit-boundaries.md`](edit-boundaries.md)
-  Explains what changes in the public repo, what changes only in runtime, and how learnings are published back deliberately.
 
 ### Structured data
 
@@ -45,7 +42,7 @@ Do not use this folder for live event state. Real dates, rooms, rosters, checkpo
 
 - [`harness-cli-foundation.md`](../docs/harness-cli-foundation.md)
 
-The deeper runtime and maintainer docs such as blueprint import, publish-back flow, and workshop-instance runbooks remain part of the source repository and maintainer path. They are intentionally not part of the portable participant bundle.
+The deeper runtime and maintainer docs such as blueprint import, publish-back flow, workshop-instance runbooks, and the governance rules in `edit-boundaries.md` remain part of the source repository and maintainer path. They are intentionally not part of the portable participant bundle. Read them directly from the [Harness Lab source repository](https://github.com/ondrej-svec/harness-lab/tree/main/workshop-blueprint) when you need them as a maintainer.
 
 For maintainers working in the source repository, the runtime-facing structured agenda sources are:
 

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

@@ -13,6 +13,20 @@ Participants should leave with two things:
 
 The workshop does not optimize for maximum feature count. It optimizes for continuation quality.
 
+## The Question This Day Answers
+
+One framing question runs through every phase:
+
+> **Does the repo speak for itself?**
+
+- The opening asks it.
+- The `Context is King` talk explains why the answer matters.
+- Build Phase 1 is the team's first chance to make the answer yes.
+- The continuation shift checks whether the answer actually is yes.
+- The reveal turns whatever was learned into next-week practice and into blueprint updates.
+
+Every phase should deepen this one question, not add a new habit on top of it. Facilitators should be able to ask it aloud at any moment in the day and have the room understand exactly what it means.
+
 ## Design Rule
 
 Harness Lab teaches by forcing the useful behavior:

package/assets/workshop-bundle/workshop-skill/analyze-checklist.md

@@ -2,15 +2,15 @@
 
 Když agent dělá `/workshop analyze`, měl by projít:
 
-- existenci a kvalitu `AGENTS.md`
+- existenci a kvalitu `AGENTS.md`
 - jestli je `AGENTS.md` mapa nebo přerostlý dump
 - jestli `AGENTS.md` říká, co číst jako první
 - jestli `AGENTS.md` odkazuje na skutečné source-of-truth docs
 - přítomnost build/test příkazů
 - jestli repo rozlišuje hotové vs. rozpracované části
-- jestli je v repu plan nebo runbook pro další tým
+- jestli je v repu plán nebo runbook pro další tým
 - jestli je dohledatelné, co bylo skutečně ověřeno
-- kolik pravidel žije jen v promptu a ne v repu
+- kolik pravidel žije jen v promptu a ne v repu
 - jak snadné by bylo pokračovat po rotaci bez ústního handoffu
 - jestli je zřejmý další bezpečný krok
 

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

@@ -6,25 +6,25 @@ Na konci dne vytvoř krátké shrnutí workshopu, které je:
 
 - konkrétní
 - systémové, ne osobní
-- lehce meta: ukazuje, že agent umí shrnout práci agentů i lidí dohromady
+- lehce meta: ukazuje, že agent umí shrnout práci agentů i lidí dohromady
 
 ## Vstupy
 
-- sprint checkpoint feed z dashboardu
+- sprint checkpoint feed z dashboardu
 - monitoring summary nebo manuální scan
 - W³ sticky notes nebo přepsané commitments
-- případně poznámky z intermezz
+- případně poznámky z intermezz
 
 ## Výstup
 
 1. Co pomohlo týmům pokračovat po handoffu
 2. Co opakovaně chybělo
 3. Jaké 2-3 principy si má místnost odnést do příštího týdne
-4. Jedna závěrečná věta, která propojí workshop s reálnou prací v týmu
+4. Jedna závěrečná věta, která propojí workshop s reálnou prací v týmu
 
 ## Styl
 
 - česky
 - věcně
 - bez oslavného tónu
-- zjištění opírej o konkrétní signály z dne
+- zjištění opírej o konkrétní signály z dne

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

@@ -2,8 +2,8 @@
 
 ## Jak skill používat
 
-- V Codexu používejte `$workshop ...`
-- V pi načtěte `/skill:workshop` a potom si řekněte o konkrétní akci přirozeně nebo přes název příkazu
+- V Codexu používejte `$workshop ...`
+- V pi načtěte `/skill:workshop` a potom si řekněte o konkrétní akci přirozeně nebo přes název příkazu
 - Skill má být nainstalovaný přímo ve vašem pracovním repu přes `harness skill install`. Nemusíte kvůli tomu klonovat Harness Lab repo.
 - Když si nejste jistí, začněte `workshop commands` nebo `workshop reference`
 
@@ -17,28 +17,28 @@
 
 ## Co který příkaz dělá
 
-- `workshop` - kde v workshopu právě jste a co je další bezpečný krok
-- `workshop setup` - jak se co nejrychleji rozběhnout v Codexu nebo pi
-- `workshop brief` - zadání týmu a první ukotvení scope
+- `workshop` - kde v workshopu právě jste a co je další bezpečný krok
+- `workshop setup` - jak se co nejrychleji rozběhnout v Codexu nebo pi
+- `workshop brief` - zadání týmu a první ukotvení scope
 - `workshop challenges` - challenge cards pro další posun
-- `workshop team` - tým, repo a checkpoint
+- `workshop team` - tým, repo a checkpoint
 - `workshop reference` - krátká karta pracovních výchozích bodů pro dnešek
 - `workshop help` - coaching podle fáze dne nebo podle problému, na kterém jste zaseknutí
 - `workshop template` - starter `AGENTS.md`
-- `workshop analyze` - rychlý handoff check repa
-- `workshop resources` - účastnický kit, learner kit a další navazující materiály
-- `workshop follow-up` - co si odnést a co udělat 48 hodin až 1 týden po workshopu
-- `workshop gallery` - ověřené externí docs a veřejné repozitáře pro další učení
+- `workshop analyze` - rychlá kontrola handoffu v repu
+- `workshop resources` - účastnický kit, learner kit a další navazující materiály
+- `workshop follow-up` - co si odnést a co udělat 48 hodin až 1 týden po workshopu
+- `workshop gallery` - ověřené externí docs a veřejné repozitáře pro další učení
 - `workshop recap` - krátké uzavření nebo připomínka po workshopu
 
 ## Kdy co použít
 
 - Když nevíte, kde začít: `workshop reference`
-- Když je zadání rozmazané: `workshop brief`, potom `brainstorm` nebo `plan`
+- Když je zadání rozmazané: `workshop brief`, potom `brainstorm` nebo `$plan`
 - Když repu chybí kontext: `workshop template`
 - Když si nejste jistí workflow: `workshop commands`
-- Když chcete materiály i po workshopu: `workshop resources`, `workshop follow-up`, `workshop gallery`
+- Když chcete materiály i po workshopu: `workshop resources`, `workshop follow-up`, `workshop gallery`
 
 ## Důležitá poznámka
 
-`workshop` skill je garantovaný výchozí nástroj workshopu. Další workflow skills a veřejné toolkity jsou doporučené rozšíření, ne podmínka účasti.
+`workshop` skill je garantovaný výchozí nástroj workshopu. Další workflow skills a veřejné toolkity jsou doporučené rozšíření, ne podmínka účasti.

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

@@ -41,6 +41,20 @@ Note:
 - if the facilitator wants OS-native storage, they can use `HARNESS_SESSION_STORAGE=keychain`, `credential-manager`, or `secret-service`
 - `--auth basic` and `--auth neon` remain explicit fallbacks for local dev/bootstrap
 
+Preferred operator flow after login:
+
+```bash
+harness workshop list-instances
+harness workshop select-instance sample-workshop-demo-orbit
+harness workshop current-instance
+harness workshop status
+```
+
+Rules:
+- prefer this flow over reading local CLI session files or composing ad hoc authenticated `node -e` scripts
+- once a local selection exists, the CLI may use it as the default target for subsequent facilitator operations
+- when an agent needs machine-readable output, prefer `harness --json ...`
+
 ### `/workshop facilitator logout`
 
 Ask the facilitator to run:
@@ -68,6 +82,48 @@ Show:
 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.
 
+Targeting behavior:
+- if the facilitator previously ran `harness workshop select-instance <instance-id>`, `status` reports that selected instance
+- if no local selection exists, `status` falls back to the deployment-default workshop context
+- for exact machine parsing, prefer `harness --json workshop status`
+
+### `/workshop facilitator current-instance`
+
+Preferred path:
+
+```bash
+harness workshop current-instance
+```
+
+Show:
+- the locally selected instance id when one exists
+- whether the current target came from persisted selection or `HARNESS_WORKSHOP_INSTANCE_ID`
+- the resolved instance summary and full record for operator verification
+
+Rules:
+- use this after `select-instance` when the facilitator wants to confirm the CLI target before update, reset, or remove
+- if nothing is selected, the command should say so clearly instead of forcing the facilitator into session-file inspection
+
+### `/workshop facilitator select-instance <instance-id>`
+
+Preferred path:
+
+```bash
+harness workshop select-instance sample-workshop-demo-orbit
+```
+
+Clear the stored selection:
+
+```bash
+harness workshop select-instance --clear
+```
+
+Rules:
+- use this when a facilitator will perform several operations against the same live workshop instance
+- the CLI should validate the instance through the server before persisting the selection
+- after selection, `status` and `phase set` should target that instance instead of the deployment default
+- `show-instance`, `update-instance`, `reset-instance`, `prepare`, and `remove-instance` may omit `<instance-id>` when a valid selection already exists
+
 ### `/workshop facilitator list-instances`
 
 Preferred path:
@@ -93,6 +149,7 @@ 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
+- when an agent needs to parse the output, prefer `harness --json workshop list-instances`
 
 ### `/workshop facilitator show-instance <instance-id>`
 
@@ -117,6 +174,40 @@ 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
+- if a local selection already exists, the facilitator may omit `<instance-id>` and let the CLI use the stored target
+
+### `/workshop facilitator participant-access`
+
+Preferred inspection path:
+
+```bash
+harness --json workshop participant-access
+```
+
+Preferred rotation path:
+
+```bash
+harness --json workshop participant-access --rotate
+```
+
+Optional explicit code:
+
+```bash
+harness --json workshop participant-access --rotate --code orbit7-bridge4-shift2
+```
+
+Show:
+- whether participant access is active for the current instance
+- code id and expiry
+- the current raw code only when it is still recoverable from sample/bootstrap configuration
+- the newly issued raw code in the rotation response
+
+Rules:
+- treat the runtime store as hash-only after rotation; if the current raw code is unavailable, issue a new one instead of trying to recover it
+- prefer this command over inspecting env vars, deployment config, or database rows directly
+- if a local selection already exists, the CLI may omit `<instance-id>` and use the stored target
+- use `--json` for agent consumption so the skill can quote the issued code exactly without scraping prose
+- keep the participant event code separate from facilitator credentials and do not present it as an admin password
 
 ### `/workshop facilitator grant <email> <role>`
 
@@ -230,6 +321,7 @@ Rules:
 - 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
+- if the facilitator already selected a local current instance, the CLI may omit `<instance-id>` and use the stored target
 
 ### `/workshop facilitator reset-instance <instance-id>`
 
@@ -256,6 +348,7 @@ Rules:
 - 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
+- if the facilitator already selected a local current instance, the CLI may omit `<instance-id>` and use the stored target
 
 ### `/workshop facilitator prepare`
 
@@ -275,6 +368,7 @@ Content-Type: application/json
 ```
 
 This sets the instance to `prepared` state and verifies the event code.
+If a local current instance is already selected, the CLI may omit `<instance-id>` and use the stored target.
 
 ### `/workshop facilitator remove-instance <instance-id>`
 
@@ -296,6 +390,7 @@ Content-Type: application/json
 Rules:
 - remove remains an owner-only operation
 - the skill should warn the facilitator that this is destructive removal from the active list, not routine metadata editing
+- if the facilitator already selected a local current instance, the CLI may omit `<instance-id>` and use the stored target
 
 ### `/workshop facilitator agenda`