@harness-lab/cli 0.2.2 → 0.2.4

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

@@ -0,0 +1,72 @@
+# Participant Resource Kit
+
+A short set of artifacts you can take from Harness Lab into your own project.
+
+## 1. Start with `AGENTS.md`
+
+Use this baseline:
+- `goal`
+- `context`
+- `constraints`
+- `done when`
+
+Default template:
+- [`workshop-skill/template-agents.md`](../../../workshop-skill/template-agents.md)
+
+## 2. Add one trust anchor
+
+Choose at least one:
+- build/test commands
+- a RED test
+- a tracer bullet
+- a review checklist
+
+When the agent handles a larger slice of work, “I skimmed it quickly” is not enough.
+
+Checklist for handoff:
+- [`workshop-skill/analyze-checklist.md`](../../../workshop-skill/analyze-checklist.md)
+
+## 3. Use a small workflow, not chaos
+
+Recommended baseline:
+- `workshop` for orientation and the next safe move
+- `/brainstorm` when the scope or first slice is still unclear
+- `/plan` before larger implementation
+- `/work` or another narrow implementation loop once you know what you are building
+- a test or another executable check before an important change
+- `/review` after a larger slice of work
+- `/compound` or a short repo-native note when a discovery makes future work cheaper
+- small ongoing cleanup: move build/test commands, constraints, and handoff notes from chat into the repo
+
+## 4. Move one rule from chat into the repo
+
+Typical candidates:
+- build/test commands
+- safety constraints
+- the definition of done
+- a handoff rule
+
+## 5. Keep UI work on a safe track
+
+Default pattern:
+- `agent exploration`
+- `Playwright regression`
+- `human review`
+
+Do not let the model drive your normal signed-in browser by default without sandboxing and control.
+
+## 6. What to revisit after the workshop
+
+- [`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)
+
+Note:
+- the `workshop` skill is the guaranteed workshop default
+- additional workflow skills and public toolkits are optional accelerators, not required setup
+
+## Next-week challenge
+
+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.

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

@@ -29,14 +29,14 @@ Checklist pro handoff:
 ## 3. Používejte malý workflow, ne chaos
 
 Doporučený základ:
-- `workshop` pro orientaci a další safe move
+- `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
 - `/review` po větším kusu práce
-- `/compound` nebo krátká repo-native poznámka, když objev udělá další práci levnější
-- malý cleanup průběžně: 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
 
@@ -53,7 +53,7 @@ Výchozí pattern:
 - `Playwright regression`
 - `human review`
 
-Nenechávejte model jako default 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
 
@@ -62,7 +62,7 @@ Nenechávejte model jako default ovládat váš běžný přihlášený browser
 - [`docs/learner-reference-gallery.md`](../docs/learner-reference-gallery.md)
 
 Poznámka:
-- `workshop` skill je garantovaný workshop default
+- `workshop` skill je garantovaný výchozí nástroj workshopu
 - další workflow skills a veřejné toolkity berte jako volitelné akcelerátory, ne povinný setup
 
 ## Výzva na příští týden

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

@@ -39,10 +39,17 @@ Do not use this folder for live event state. Real dates, rooms, rosters, checkpo
 ### Structured data
 
 - [`agenda.json`](agenda.json)
-  Canonical reusable agenda and workshop metadata for blueprint import.
+  Public-readable workshop agenda summary and workshop metadata.
 
 ## Related Runtime Documents
 
 - [`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.
+
+For maintainers working in the source repository, the runtime-facing structured agenda sources are:
+
+- `docs/workshop-content-language-architecture.md`
+- `dashboard/lib/workshop-blueprint-agenda.json`
+
+Treat those as maintainer/source-repo references, not as portable participant-bundle docs.

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

@@ -12,7 +12,7 @@ Když agent dělá `/workshop analyze`, měl by projít:
 - jestli je dohledatelné, co bylo skutečně ověřeno
 - 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ší safe move
+- jestli je zřejmý další bezpečný krok
 
 ## Výstup
 

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

@@ -3,11 +3,11 @@
 ## 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 commandu
+- 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`
 
-## Nejkratší participant flow
+## Nejkratší pracovní postup
 
 1. `workshop reference`
 2. `workshop brief`
@@ -15,18 +15,18 @@
 4. `workshop help`
 5. `workshop resources`
 
-## Co který command dělá
+## Co který příkaz dělá
 
-- `workshop` - kde v workshopu právě jste a co je další safe move
+- `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 reference` - krátká karta pracovních defaultů pro dnešek
+- `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` - participant resource kit, learner kit a další navazující materiály
+- `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
@@ -41,4 +41,4 @@
 
 ## Důležitá poznámka
 
-`workshop` skill je garantovaný workshop default. 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

@@ -16,6 +16,11 @@ harness auth login
 
 CLI provede browser/device auth flow, uloží session do lokálního file storage a zpřístupní ji pro další privileged příkazy.
 
+Model:
+- `harness auth login` autentizuje facilitátora vůči platformě
+- konkrétní workshop instance se vybírá až při operaci nebo přes default context
+- instance grant se vyhodnocuje při přístupu ke konkrétní akci, ne při samotném loginu
+
 Aktuální praktický path v repu:
 
 - default / browser-device auth:
@@ -92,6 +97,7 @@ Preferovaný path je CLI příkaz nad sdíleným runtime API:
 ```bash
 harness workshop create-instance developer-hackathon-praha-24-4-saturn \
   --template-id blueprint-default \
+  --content-lang cs \
   --event-title "Developer Hackathon Praha" \
   --city Praha \
   --date-range "24. dubna 2026" \
@@ -111,6 +117,7 @@ Content-Type: application/json
 {
   "id": "developer-hackathon-praha-24-4-saturn",
   "templateId": "blueprint-default",
+  "contentLang": "cs",
   "eventTitle": "Developer Hackathon Praha",
   "city": "Praha",
   "dateRange": "24. dubna 2026",
@@ -125,6 +132,7 @@ Content-Type: application/json
 Poznámky pro skill:
 - skill má preferovat CLI, ne ručně skládané `fetch` skripty
 - `id` musí být lowercase slug s písmeny, čísly a pomlčkami
+- `contentLang` určuje jazyk workshopového obsahu pro dashboard, presenter a skill delivery; není to totéž jako UI language
 - když skill volá create opakovaně se stejným `id`, route vrací `created: false` a existující instance record
 - nehádej venue metadata zkráceně, když je facilitátor zná; pošli je rovnou při create
 
@@ -134,6 +142,7 @@ Preferovaný path:
 
 ```bash
 harness workshop update-instance developer-hackathon-praha-24-4-saturn \
+  --content-lang en \
   --event-title "Developer Hackathon Praha" \
   --date-range "24. dubna 2026" \
   --venue-name "Seyfor Praha jednička 103" \
@@ -151,6 +160,7 @@ Content-Type: application/json
 
 {
   "action": "update_metadata",
+  "contentLang": "en",
   "eventTitle": "Developer Hackathon Praha",
   "dateRange": "24. dubna 2026",
   "venueName": "Seyfor Praha jednička 103",
@@ -304,14 +314,14 @@ Content-Type: application/json
   "chromePreset": "agenda",
   "title": "Nejdřív bez kontextu, potom s mapou",
   "facilitatorNotes": [
-    "Držte jednu story, ne feature tour."
+    "Držte jednu story, ne přehlídku funkcí."
   ],
   "blocks": [
     {
       "id": "hero",
       "type": "hero",
       "title": "Nejdřív bez kontextu, potom s mapou",
-      "body": "Ukažte rozdíl mezi prompt blobem a krátkou repo-native mapou."
+      "body": "Ukažte rozdíl mezi prompt blobem a krátkou mapou zapsanou v repu."
     },
     {
       "id": "questions",
@@ -339,12 +349,12 @@ Content-Type: application/json
   "sceneType": "demo",
   "intent": "walkthrough",
   "chromePreset": "agenda",
-  "title": "Jedna story, ne feature tour",
+  "title": "Jedna story, ne přehlídka funkcí",
   "blocks": [
     {
       "id": "hero",
       "type": "hero",
-      "title": "Jedna story, ne feature tour",
+      "title": "Jedna story, ne přehlídka funkcí",
       "body": "Neukazujte pět režimů práce. Ukažte jeden čitelný workflow."
     }
   ]
@@ -386,10 +396,10 @@ Při práci přes API:
 - neznámé `agendaItemId` nebo `sceneId` vrací `404`
 - malformed payload pořád vrací `400`
 - skill má stale target ids hlásit explicitně, ne pokračovat jako by se změna povedla
-- room-facing obsah patří do `blocks`, facilitátorské guidance do `facilitatorNotes`
+- room-facing obsah patří do `blocks`, facilitátorské pokyny do `facilitatorNotes`
 - `title/body` zůstávají kvůli compatibility, ale skill má preferovat strukturované `blocks`
 - když runtime agenda existuje, skill má číst a citovat její `goal`, `roomSummary`, `facilitatorPrompts`, `watchFors`, `checkpointQuestions`, `facilitatorNotes` a `blocks`
-- když runtime data nejsou dostupná, fallbackni na repo-native blueprint/facilitation docs a explicitně to řekni
+- když runtime data nejsou dostupná, fallbackni na blueprint a facilitační docs z repa a explicitně to řekni
 
 ### `/workshop facilitator archive`
 

package/assets/workshop-bundle/workshop-skill/follow-up-package.md

@@ -24,7 +24,7 @@ Pošli účastníkům:
 
 ## 1 týden po workshopu
 
-Krátký follow-up dotaz:
+Krátký navazující dotaz:
 
 - Vytvořili jste `AGENTS.md` v reálném projektu?
 - Přidali jste build/test příkazy nebo sekci `Done When`?

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

@@ -5,11 +5,11 @@
 Výchozí doporučení pro Harness Lab je instalace přes `@harness-lab/cli` do vašeho aktuálního pracovního repa.
 
 Proč:
-- skill je pořád repo-native obsah, ale nemá záviset na tom, že máte zrovna klon tohoto veřejného repa
+- skill je pořád obsah opřený o repo, ale nemá záviset na tom, že máte zrovna klon tohoto veřejného repa
 - stejné soubory slouží jako fallback i jako dokumentace
-- participant má mít funkční workshop companion přímo v týmovém repu
+- účastník má mít funkční workshop companion přímo v týmovém repu
 
-## Doporučený participant flow
+## Doporučený postup pro účastníka
 
 1. otevřít svůj týmový nebo workshopový repo
 2. nainstalovat Harness CLI:
@@ -48,11 +48,11 @@ Doporučený další postup:
 2. otevřít `commands`, `reference` a `brief`
 3. doplnit `AGENTS.md`
 4. podle potřeby použít `brainstorm`, `plan`, `work`, `review` nebo `compound`, pokud je ve svém agent setupu máte k dispozici
-5. když chcete participant materiály bez hledání v GitHubu, použít `workshop resources`, `workshop gallery` a `workshop follow-up`
+5. když chcete materiály pro účastníky bez hledání v GitHubu, použijte `workshop resources`, `workshop gallery` a `workshop follow-up`
 
 ## Poznámka
 
 `harness skill install` vytvoří projektový bundle v `.agents/skills/harness-lab-workshop`, aby skill šel objevit v repu bez další distribuční vrstvy.
-Tuto složku berte jako generovaný workshop bundle, ne jako hlavní authoring surface.
+Tuto složku berte jako generovaný workshop bundle, ne jako hlavní autorský zdroj.
 
-Participant login není potřeba pro samotnou existenci skillu. `workshop login` je až krok pro odemčení live event contextu.
+Přihlášení účastníka není potřeba pro samotnou existenci skillu. `workshop login` je až krok pro odemčení live event contextu.

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

@@ -0,0 +1,44 @@
+# Workshop Commands
+
+## How to use the skill
+
+- In Codex, use `$workshop ...`
+- In pi, load `/skill:workshop` and then ask for the relevant action naturally or by command name
+- The skill should be installed directly in your working repo via `harness skill install`. You do not need to clone the Harness Lab source repo for that.
+- If you are not sure where to start, begin with `workshop commands` or `workshop reference`
+
+## Shortest participant flow
+
+1. `workshop reference`
+2. `workshop brief`
+3. `workshop template`
+4. `workshop help`
+5. `workshop resources`
+
+## What each command does
+
+- `workshop` - where you are in the workshop right now and what the next safe move is
+- `workshop setup` - the fastest viable path into Codex or pi
+- `workshop brief` - your team brief and the first scope anchor
+- `workshop challenges` - challenge cards for the next step forward
+- `workshop team` - team, repo, and checkpoint
+- `workshop reference` - the short working-defaults card for today
+- `workshop help` - coaching based on the phase of the day or the problem you are stuck on
+- `workshop template` - starter `AGENTS.md`
+- `workshop analyze` - a fast handoff check of the repo
+- `workshop resources` - participant resource kit, learner kit, and follow-on materials
+- `workshop follow-up` - what to keep and what to do 48 hours to 1 week after the workshop
+- `workshop gallery` - verified external docs and public repos for continued learning
+- `workshop recap` - a short close or reminder after the workshop
+
+## When to use what
+
+- If you do not know where to start: `workshop reference`
+- If the brief feels blurry: `workshop brief`, then `brainstorm` or `plan`
+- If the repo lacks context: `workshop template`
+- If you are unsure about workflow: `workshop commands`
+- If you want materials after the workshop too: `workshop resources`, `workshop follow-up`, `workshop gallery`
+
+## Important note
+
+The `workshop` skill is the guaranteed workshop default. Additional workflow skills and public toolkits are recommended accelerators, not a requirement for participation.

package/assets/workshop-bundle/workshop-skill/locales/en/follow-up-package.md

@@ -0,0 +1,35 @@
+# Follow-up Package
+
+## 48 hours after the workshop
+
+Send participants:
+
+1. A short reminder of the main principles:
+   - Context is a working system
+   - `AGENTS.md` is team infrastructure
+   - `Done When` and build/test commands improve the chances of a good handoff
+2. A pointer to `/workshop recap`
+3. A link to or excerpt from `workshop-skill/template-agents.md`
+4. A challenge for the week:
+   - "Add `AGENTS.md` to one real project."
+   - "Move one durable rule from a prompt into the repo."
+5. Links to the learner kit:
+   - [`docs/locales/en/learner-resource-kit.md`](../../../docs/locales/en/learner-resource-kit.md)
+   - [`docs/locales/en/learner-reference-gallery.md`](../../../docs/locales/en/learner-reference-gallery.md)
+   - [`materials/locales/en/participant-resource-kit.md`](../../../materials/locales/en/participant-resource-kit.md)
+6. A reminder that the same materials are available through the skill too:
+   - `workshop resources`
+   - `workshop gallery`
+   - `workshop follow-up`
+
+## 1 week after the workshop
+
+Short follow-up questions:
+
+- Did you create `AGENTS.md` in a real project?
+- Did you add build/test commands or a `Done When` section?
+- What helped you and what blocked you?
+
+## W³ reminder
+
+If you have a photo of the sticky notes from the `And now?` section, send each person their own commitment as a personal reminder.

package/assets/workshop-bundle/workshop-skill/locales/en/recap.md

@@ -0,0 +1,22 @@
+# Workshop Recap
+
+## What to keep
+
+- Context is not cosmetics. It is a working system.
+- `AGENTS.md`, skills, and runbooks are not extra garnish. They are tools that help a team keep direction.
+- A good handoff is visible when the next team can start work without verbal backfilling.
+
+## Try this this week
+
+- Add `AGENTS.md` to one real project.
+- Add build and test commands plus a `Done When` section.
+- Move one durable rule from a prompt into the repo.
+- After a larger change, try writing a short runbook for the next person.
+
+## Your commitment
+
+Return to the sticky note from the `And now?` segment and turn it into the first concrete commit, pull request, or task in the repo.
+
+## When you are not sure
+
+Start simply: write down what you want to do, where the context is, what the constraints are, and how you will know it is done.

package/assets/workshop-bundle/workshop-skill/locales/en/reference.md

@@ -0,0 +1,80 @@
+# Workshop Reference
+
+## 4 working defaults for today
+
+- `Map before motion` - first make the repo a place people can navigate
+- `If it is not in the repo, it does not exist` - important agreements, rules, and next steps belong in files
+- `Verification is the trust boundary` - more autonomy requires stronger evidence
+- `Handoff is a continuous constraint` - the next team should find the first safe move without your explanation
+
+## 4 elements of a good task
+
+- `Goal` - what exactly the agent should create or change
+- `Context` - which files, decisions, and surrounding facts matter for the task
+- `Constraints` - the rules, standards, and solution boundaries
+- `Done When` - how you will know the work is actually finished
+
+## Fast handoff checklist
+
+- Does `AGENTS.md` exist?
+- Is `AGENTS.md` a short map rather than an overgrown dump?
+- Are there build and test commands in the repo that another team can run?
+- Is it clear what already works, what is in progress, and what is still only an idea?
+- Is there a plan, runbook, or another document that helps the next team understand the intent?
+- Can you find what was actually verified?
+- Can a new team find the first safe move within a few minutes?
+
+## Recommended commands
+
+- Workshop skill in Codex: `$workshop ...`
+- Workshop skill in pi: `/skill:workshop`, then ask for `reference`, `setup`, `brief`, or another workshop action
+- If you do not know what the skill can do: `Codex: $workshop commands`
+- The workshop skill is the guaranteed default. Workflow skills and external toolkits are recommended accelerators, not mandatory bootstrap.
+- Workflow skills like `$brainstorm`, `$plan`, `$work`, `$test-writer`, `$review`, and `$compound` are described Codex-first in this workshop. In pi, treat them as optional parts of your own setup rather than the guaranteed default.
+- `Codex: $workshop reference` at the start of the day or after you lose orientation
+- `Codex: $workshop brief` when you need to re-anchor the task
+- `Codex: $workshop resources` when you want the participant kit and learner kit without searching the repo
+- `Codex: $workshop gallery` when you want more public docs, repos, and optional toolkits
+- `Codex: $workshop follow-up` when you are deciding what to keep after the workshop
+- `Codex: $brainstorm` when the scope is still unclear
+- `Codex: $plan` before larger implementation
+- `Codex: $work` once you have a plan and want to keep implementation in one line
+- `Codex: $test-writer` or your own RED test before implementation when you need to keep the agent inside real boundaries
+- `Codex: $review` after a larger slice of work
+- `Codex: $compound` when a learning, fix, or workflow rule is worth preserving as a durable repo-native artifact
+- `Codex: $workshop` for orientation during the day
+- `Codex: $workshop template` when the repo is missing baseline context
+- `Codex: $workshop analyze` before handoff or after rotation when you want to expose blind spots in the repo quickly
+
+## Recommended participant loop
+
+- `workshop` for orientation and the next safe move
+- `brainstorm` or directly `plan` when the scope is already clear
+- `work` against one verifiable goal
+- `review` before you trust a change
+- `compound` or a short runbook when something is worth preserving
+- ongoing cleanup work: move build and test commands, constraints, and handoff notes from chat into the repo
+
+## Tests as the trust boundary
+
+- The more work the agent does independently, the less “I skimmed it quickly” is enough.
+- If you let the agent write without tests, you often just accelerate unverified complexity.
+- A RED test, tracer bullet, or simple end-to-end check is often the fastest way to tell the agent what must actually be true.
+
+## Safe UI workflow
+
+- The default pattern is: `agent exploration -> Playwright regression -> human review`.
+- Let the agent inspect the UI, screenshots, and console quickly in an isolated local environment.
+- Once you find an important flow, turn it into a repeatable browser test.
+- Then have a human review the change. Tests protect against regression, but they do not decide meaning or trade-offs for you.
+- “Let the model drive my normal signed-in browser” is not the default recommendation. That belongs only in a sandboxed, intentionally constrained environment.
+
+## Quick reminder
+
+A good prompt is not enough. If the work should survive handoff, the context must live in the repo and verification must stay traceable.
+
+## Where to go after the workshop
+
+- Official docs, the OpenAI Harness Engineering article, and verified public skill repos are collected in [`docs/learner-reference-gallery.md`](../../../docs/learner-reference-gallery.md).
+- If you already use another workflow pack or toolkit, treat it as an extension on top of this foundation, not as a replacement for `AGENTS.md`, verification, and repo-native handoff.
+- If you do not want to search the repo, use `workshop resources`, `workshop gallery`, or `workshop follow-up` directly.

package/assets/workshop-bundle/workshop-skill/locales/en/setup.md

@@ -0,0 +1,84 @@
+# Workshop Setup
+
+## Goal
+
+By 10:30, you need one working path into Codex or pi. Not a perfect setup. A working path.
+
+The first goal after setup is not a feature. It is orientation:
+
+- open the repo
+- load the workshop guidance
+- create a short `AGENTS.md`
+- name the first verifiable step
+
+The guaranteed default for today is the `workshop` skill. Additional workflow skills or external toolkits are optional accelerators, not a requirement for participation.
+
+## Fastest choice
+
+- terminal-first, hackable multi-model setup: `pi`
+- macOS / Linux: `Codex CLI`
+- Windows or macOS: `Codex App`
+- if you get blocked: web fallback or pair with someone whose setup already works
+
+## pi
+
+1. Install `pi`:
+
+```bash
+npm install -g @mariozechner/pi-coding-agent
+```
+
+2. Sign in to the provider or account you want to use.
+3. Open the repository.
+4. Run `pi`.
+5. Load the workshop skill with `/skill:workshop` and ask for `setup`, `reference`, or `brief`.
+
+## Codex CLI
+
+1. Confirm that you have access to your Codex account.
+2. Install the CLI using your organization's setup flow.
+3. Sign in.
+4. Open the repository.
+5. Send the first meaningful prompt and confirm that you get a response.
+
+## Codex App
+
+1. Install the app.
+2. Sign in with the same account.
+3. Open the workshop repo or your team project.
+4. Send the first prompt.
+5. Confirm that you can continue without another blocker.
+
+## If something does not work
+
+- Do not spend 20 minutes debugging setup alone.
+- After 7 minutes of being blocked, switch to App, web fallback, or pairing.
+- If authentication fails, continue with someone at your table and come back to your own setup later.
+- If you are unsure about the next step, use `$workshop setup` in Codex. In pi, load `/skill:workshop` and ask for setup help. Or call a facilitator.
+
+## First 15 minutes after setup
+
+1. Open workshop reference:
+   - Codex: `$workshop reference`
+   - pi: `/skill:workshop`, then ask for `reference`
+   - if you want a fast overview of the skill surface: `Codex: $workshop commands`
+2. Open the brief:
+   - Codex: `$workshop brief`
+   - pi: `/skill:workshop`, then ask for `brief`
+3. Add a short `AGENTS.md`:
+   - Codex: `$workshop template`
+4. Name the first safe move:
+   - ideally through `plan`, or `brainstorm` if the scope is still unclear
+5. Add one executable check:
+   - a RED test, tracer bullet, or at least a clear review or checklist step
+6. If you want materials for later too:
+   - `Codex: $workshop resources`
+   - `Codex: $workshop gallery`
+   - `Codex: $workshop follow-up`
+
+## Done when
+
+- You can open the repo.
+- You can send a prompt.
+- You have one working path for using an agent during the workshop.
+- You know the first safe move in the repo after setup.

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

@@ -1,11 +1,11 @@
 # Workshop Reference
 
-## 4 pracovní defaulty pro dnešek
+## 4 pracovní výchozí body pro dnešek
 
 - `Mapa před pohybem` — nejdřív udělejte z repa místo, kde se dá orientovat
-- `Co není v repu, neexistuje` — důležité dohody, pravidla a next steps patří do souborů
+- `Co není v repu, neexistuje` — důležité dohody, pravidla a další kroky patří do souborů
 - `Ověření je hranice důvěry` — s větší autonomií musí růst i kvalita evidence
-- `Handoff je průběžný constraint` — další tým má najít první safe move bez vašeho výkladu
+- `Handoff je průběžná podmínka práce` — další tým má najít první bezpečný krok bez vašeho výkladu
 
 ## 4 prvky dobrého zadání
 
@@ -24,16 +24,16 @@
 - Je dohledatelné, co bylo skutečně ověřeno?
 - Najde nový tým během pár minut první bezpečný krok?
 
-## Doporučené commands
+## Doporučené příkazy
 
 - Workshop skill v Codexu: `$workshop ...`
 - Workshop skill v pi: `/skill:workshop`, potom si řekněte o `reference`, `setup`, `brief` nebo jinou workshop akci
 - Když nevíte, co skill umí: `Codex: $workshop commands`
-- Workshop skill je garantovaný default. Workflow skills a externí toolkity jsou doporučené akcelerátory, ne povinný bootstrap.
-- Workflow skills jako `$brainstorm`, `$plan`, `$work`, `$test-writer`, `$review` a `$compound` jsou v tomto workshopu popsané Codex-first. V pi je berte jako volitelnou součást vlastního setupu, ne jako garantovaný default.
+- Workshop skill je garantovaný výchozí nástroj. Workflow skills a externí toolkity jsou doporučené akcelerátory, ne povinný bootstrap.
+- Workflow skills jako `$brainstorm`, `$plan`, `$work`, `$test-writer`, `$review` a `$compound` jsou v tomto workshopu popsané hlavně pro Codex. V pi je berte jako volitelnou součást vlastního setupu, ne jako garantovaný výchozí stav.
 - `Codex: $workshop reference` na začátku dne nebo po ztrátě orientace
 - `Codex: $workshop brief` když potřebujete znovu ukotvit zadání
-- `Codex: $workshop resources` když chcete participant kit a learner kit bez hledání v repu
+- `Codex: $workshop resources` když chcete účastnický kit a learner kit bez hledání v repu
 - `Codex: $workshop gallery` když chcete další veřejné docs, repozitáře a volitelné toolkity
 - `Codex: $workshop follow-up` když řešíte, co si odnést po workshopu
 - `Codex: $brainstorm` když ještě není jasné, co je nejrozumnější scope nebo slice
@@ -41,19 +41,19 @@
 - `Codex: $work` když už máte plan a chcete držet implementaci v jedné linii
 - `Codex: $test-writer` nebo vlastní RED test před implementací, když potřebujete držet agenta v mezích
 - `Codex: $review` po větším kusu práce
-- `Codex: $compound` když chcete převést learning, fix nebo workflow pravidlo do trvalého repo-native artefaktu
+- `Codex: $compound` když chcete převést nové zjištění, fix nebo workflow pravidlo do trvalého artefaktu v repu
 - `Codex: $workshop` pro orientaci během dne
 - `Codex: $workshop template` když repu chybí základní kontext
 - `Codex: $workshop analyze` před handoffem nebo po rotaci, když chcete rychle odhalit slepá místa v repu
 
-## Doporučený participant loop
+## Doporučený pracovní rytmus
 
-- `workshop` pro orientaci a další safe move
+- `workshop` pro orientaci a další bezpečný krok
 - `brainstorm` nebo rovnou `plan`, když už je scope zřejmý
 - `work` proti jednomu ověřitelnému cíli
 - `review` před tím, než změně uvěříte
 - `compound` nebo krátký runbook, když něco stojí za zachování
-- průběžná cleanup práce: build/test příkazy, omezení a handoff poznámky přesouvejte z chatu do repa
+- průběžný úklid: build/test příkazy, omezení a handoff poznámky přesouvejte z chatu do repa
 
 ## Testy jako hranice důvěry
 
@@ -76,5 +76,5 @@ Dobrý prompt nestačí. Když má práce přežít handoff, musí být kontext
 ## Kam dál po workshopu
 
 - Oficiální docs, OpenAI článek o Harness Engineering a ověřené veřejné skill repozitáře najdete v [`docs/learner-reference-gallery.md`](../docs/learner-reference-gallery.md).
-- Když už používáte další workflow pack nebo toolkit, berte ho jako rozšíření nad tímto základem, ne jako náhradu za `AGENTS.md`, ověřování a repo-native handoff.
+- Když už používáte další workflow pack nebo toolkit, berte ho jako rozšíření nad tímto základem, ne jako náhradu za `AGENTS.md`, ověřování a handoff opřený o repo.
 - Když nechcete hledat v repu, použijte přímo `workshop resources`, `workshop gallery` nebo `workshop follow-up`.