@harness-lab/cli 0.2.9 → 0.3.1

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
+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
 
 ## 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,32 @@
 
 ## 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`
+
+## Facilitátorské příkazy
+
+- `workshop facilitator learnings` — dotaz do learnings logu: záznamy z rotace z minulých i aktuálních workshopů. Podporuje filtrování podle tagu, instance a cohortu.
 
 ## 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

@@ -176,6 +176,39 @@ Rules:
 - 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>`
 
 Use the CLI-backed privileged request path. The skill should not handle auth bootstrap itself.

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

@@ -7,29 +7,34 @@ Pošli účastníkům:
 1. Krátké připomenutí hlavních principů:
    - Kontext je pracovní systém
    - `AGENTS.md` je týmová infrastruktura
-   - `Done When` a build/test příkazy zvyšují šanci na dobrý handoff
+   - `Done When` a build/test příkazy zvyšují šanci na dobrý handoff
 2. Odkaz na `/workshop recap`
 3. Odkaz nebo výřez z `workshop-skill/template-agents.md`
-4. Výzvu týdne:
+4. Jednu větu, která vrátí room contract:
+   - „Nejde o chytřejší prompt. Jde o repo, ze kterého naváže další tým.“
+5. Výzvu týdne:
    - „Přidejte `AGENTS.md` do jednoho reálného projektu.“
-   - „Přesuňte jedno trvalé pravidlo z promptu do repa.“
-5. Odkaz na learner kit:
+   - „Přesuňte jedno trvalé pravidlo z promptu do repa.“
+6. Odkaz na learner kit:
    - [`docs/learner-resource-kit.md`](../docs/learner-resource-kit.md)
    - [`docs/learner-reference-gallery.md`](../docs/learner-reference-gallery.md)
    - [`materials/participant-resource-kit.md`](../materials/participant-resource-kit.md)
-6. Připomeňte, že stejné materiály lze vyžádat i přes skill:
+7. Připomeňte, že stejné materiály lze vyžádat i přes skill:
    - `workshop resources`
    - `workshop gallery`
    - `workshop follow-up`
+8. Přidejte malý závazek:
+   - „Pošlete si sami sobě nebo týmu jeden commit, task nebo PR, který tenhle týden opravdu vznikne.“
 
 ## 1 týden po workshopu
 
 Krátký navazující dotaz:
 
-- Vytvořili jste `AGENTS.md` v reálném projektu?
+- Vytvořili jste `AGENTS.md` v reálném projektu?
 - Přidali jste build/test příkazy nebo sekci `Done When`?
-- Co vám pomohlo a co vás zablokovalo?
+- Přidali jste další safe move nebo krátký handoff runbook?
+- Co vám pomohlo a co vás zablokovalo?
 
 ## W³ připomínka
 
-Pokud máš fotku sticky notes z části `A teď?`, pošli každému jeho vlastní závazek jako osobní připomínku.
+Pokud máš fotku sticky notes z části `A teď?`, pošli každému jeho vlastní závazek jako osobní připomínku.

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

@@ -5,9 +5,9 @@
 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 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
-- účastník má mít funkční workshop companion přímo v týmovém repu
+- 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
+- účastník má mít funkční workshop companion přímo v týmovém repu
 
 ## Doporučený postup pro účastníka
 
@@ -35,8 +35,8 @@ harness skill install --target /cesta/k/repu
    - Codex: `$workshop commands`, `$workshop reference`, `$workshop brief`
    - pi: `/skill:workshop`, potom si říct o `commands`, `reference` nebo `brief`
 
-Po úspěšné instalaci `harness skill install` rovnou vypíše doporučené první kroky, aby účastník věděl, že může začít buď v Codexu přes `$workshop ...`, nebo v pi přes `/skill:workshop`.
-Když příkaz pustíte znovu později, CLI zkontroluje, jestli je bundle v cílovém repu aktuální. Pokud je zastaralý, rovnou ho obnoví. `--force` používejte jen tehdy, když chcete vynutit plný reinstall.
+Po úspěšné instalaci `harness skill install` rovnou vypíše doporučené první kroky, aby účastník věděl, že může začít buď v Codexu přes `$workshop ...`, nebo v pi přes `/skill:workshop`.
+Když příkaz pustíte znovu později, CLI zkontroluje, jestli je bundle v cílovém repu aktuální. Pokud je zastaralý, rovnou ho obnoví. `--force` používejte jen tehdy, když chcete vynutit plný reinstall.
 
 ## Co čekat dál
 
@@ -47,12 +47,12 @@ Doporučený další postup:
 1. rozběhnout `workshop` skill
 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 materiály pro účastníky bez hledání v GitHubu, použijte `workshop resources`, `workshop gallery` a `workshop follow-up`
+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 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.
+`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í autorský zdroj.
 
 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

@@ -39,6 +39,10 @@
 - If you are unsure about workflow: `workshop commands`
 - If you want materials after the workshop too: `workshop resources`, `workshop follow-up`, `workshop gallery`
 
+## Facilitator commands
+
+- `workshop facilitator learnings` — query the cross-cohort learnings log: rotation signals from past and current workshops. Supports filtering by tag, instance, and cohort.
+
 ## 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

@@ -10,17 +10,21 @@ Send participants:
    - `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:
+4. One sentence that brings the room contract back:
+   - "This is not about a smarter prompt. It is about a repo another team can continue from."
+5. 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:
+6. 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:
+7. A reminder that the same materials are available through the skill too:
    - `workshop resources`
    - `workshop gallery`
    - `workshop follow-up`
+8. Add one small commitment:
+   - "Send yourself or your team one commit, task, or PR that will actually happen this week."
 
 ## 1 week after the workshop
 
@@ -28,6 +32,7 @@ Short follow-up questions:
 
 - Did you create `AGENTS.md` in a real project?
 - Did you add build/test commands or a `Done When` section?
+- Did you add the next safe move or a short handoff runbook?
 - What helped you and what blocked you?
 
 ## W³ reminder

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

@@ -6,12 +6,19 @@
 - `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.
 
+## 3 things to take out of the room
+
+- One signal you want to install permanently in your own repo.
+- One weakness you do not want to leave in conversation next time.
+- One concrete move for next week.
+
 ## 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.
+- After one handoff or review, write down what the next team actually needed and what was missing.
 
 ## Your commitment
 
@@ -19,4 +26,4 @@ Return to the sticky note from the `And now?` segment and turn it into the first
 
 ## 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.
+Start simply: write down what you want to do, where the context is, what the constraints are, how you will know it is done, and what the next safe move is if the work stays unfinished.

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

@@ -24,6 +24,20 @@
 - Can you find what was actually verified?
 - Can a new team find the first safe move within a few minutes?
 
+## 3 questions to return to when you get stuck
+
+- What are we trying to prove right now?
+- Which artifact or repo signal is missing?
+- What is the smallest check that moves the work from confidence back to reality?
+
+## What to reach for during the day
+
+- After the opening and talk: `workshop setup` or `workshop reference`
+- In Build 1: `template-agents`, the brief, the plan, and the first check
+- Before lunch: write the next safe move and use `workshop analyze` if the handoff still feels vague
+- After rotation: `workshop analyze`, the learner kit, and challenge cards instead of verbal rescue
+- At the end of the day: `workshop recap` and `workshop follow-up`
+
 ## Recommended commands
 
 - Workshop skill in Codex: `$workshop ...`
@@ -39,12 +53,13 @@
 - `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: $test-writer` or your own executable check 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
+- `Codex: $workshop facilitator learnings` or `harness workshop learnings` to query the cross-cohort learnings log (rotation signals from past workshops). Prefers the CLI path for machine-readable output with filtering by tag, instance, or cohort.
 
 ## Recommended participant loop
 
@@ -59,7 +74,7 @@
 
 - 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.
+- An executable check (unit test, tracer bullet, or simple end-to-end probe) is often the fastest way to tell the agent what must actually be true.
 
 ## Safe UI workflow
 
@@ -71,10 +86,12 @@
 
 ## 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.
+A good prompt is not enough. If the work should survive handoff, the context must live in the repo, the next safe move must stay traceable, and verification must remain legible to a different team.
 
 ## 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).
+- Codex-specific craft (approval modes, sandboxing, long-horizon drift, a representative before/after prompt pair, and a failure-recovery walkthrough) lives in [`content/codex-craft.md`](../../../content/codex-craft.md).
+- The one-page pocket card of conversational moves for coaching an agent is [`materials/coaching-codex.md`](../../../materials/coaching-codex.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

@@ -70,7 +70,7 @@ npm install -g @mariozechner/pi-coding-agent
 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
+   - an executable check (unit 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`

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

@@ -3,20 +3,27 @@
 ## Co si odnést
 
 - Kontext není kosmetika. Je to pracovní systém.
-- `AGENTS.md`, skills a runbooky nejsou doplněk navíc. Jsou to nástroje, díky kterým tým drží směr.
+- `AGENTS.md`, skills a runbooky nejsou doplněk navíc. Jsou to nástroje, díky kterým tým drží směr.
 - Dobrý handoff poznáte podle toho, že nový tým začne pracovat bez ústního dovysvětlování.
 
+## 3 věci, které si máte odnést z místnosti
+
+- Jeden signál, který chcete zavést natrvalo ve vlastním repu.
+- Jednu slabinu, kterou už příště nenecháte žít jen v hovoru.
+- Jeden konkrétní tah pro příští týden.
+
 ## Zkuste tento týden
 
 - Přidejte `AGENTS.md` do jednoho reálného projektu.
-- Doplňte build/test příkazy a sekci `Done When`.
-- Jedno trvalé pravidlo přesuňte z promptu do repa.
+- Doplňte build/test příkazy a sekci `Done When`.
+- Jedno trvalé pravidlo přesuňte z promptu do repa.
 - Po větší změně zkuste udělat krátký runbook pro dalšího člověka.
+- Po jednom handoffu nebo review si napište, co další tým skutečně potřeboval a co mu chybělo.
 
 ## Váš závazek
 
-Vraťte se ke sticky note z části `A teď?` a převeďte ji na první konkrétní commit, pull request nebo task v repu.
+Vraťte se ke sticky note z části `A teď?` a převeďte ji na první konkrétní commit, pull request nebo task v repu.
 
 ## Až si nebudete jistí
 
-Začněte jednoduše: napište, co chcete udělat, kde je kontext, jaká jsou omezení a podle čeho poznáte hotovo.
+Začněte jednoduše: napište, co chcete udělat, kde je kontext, jaká jsou omezení, podle čeho poznáte hotovo a jaký je další safe move, když práce zůstane rozdělaná.

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

@@ -2,79 +2,103 @@
 
 ## 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 další kroky patří do souborů
-- `Ověření je hranice důvěry` — s větší autonomií musí růst i kvalita evidence
+- `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 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á 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í
 
 - `Cíl` — co má agent konkrétně vytvořit nebo změnit
-- `Kontext` — které soubory, rozhodnutí a souvislosti jsou pro úkol důležité
-- `Omezení` — pravidla, standardy a hranice řešení
+- `Kontext` — které soubory, rozhodnutí a souvislosti jsou pro úkol důležité
+- `Omezení` — pravidla, standardy a hranice řešení
 - `Hotovo když` — podle čeho poznáte, že je práce opravdu dokončená
 
 ## Rychlý checklist pro handoff
 
 - Existuje `AGENTS.md`?
 - Je `AGENTS.md` krátká mapa, ne přerostlý dump?
-- Jsou v repu build/test příkazy, které umí spustit i další tým?
-- Je jasné, co už funguje, co je rozpracované a co je jen nápad?
-- Je v repu plan, runbook nebo jiný dokument, ze kterého další tým pochopí záměr?
+- Jsou v repu build/test příkazy, které umí spustit i další tým?
+- Je jasné, co už funguje, co je rozpracované a co je jen nápad?
+- Je v repu plán, runbook nebo jiný dokument, ze kterého další tým pochopí záměr?
 - Je dohledatelné, co bylo skutečně ověřeno?
 - Najde nový tým během pár minut první bezpečný krok?
 
+## 3 otázky, ke kterým se vraťte, když se zaseknete
+
+- Čeho se právě snažíme dosáhnout?
+- Který artefakt nebo signál v repu nám chybí?
+- Jaké je nejmenší ověření, které vrátí práci z dojmu do reality?
+
+## Kdy po čem sáhnout během dne
+
+- Po openingu a talku: `workshop setup` nebo `workshop reference`
+- V prvním buildu: `template-agents`, brief, plán a první ověření
+- Před obědem: dopsat další bezpečný krok a použít `workshop analyze`, když si nejste jistí handoffem
+- Po rotaci: `workshop analyze`, learner kit a challenge cards místo ústního rescue
+- Na konci dne: `workshop recap` a `workshop follow-up`
+
 ## 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
+- 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ý 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.
+- 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 úč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 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
 - `Codex: $plan` před větší implementací
-- `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: $work` když už máte plán a chcete držet implementaci v jedné linii
+- `Codex: $test-writer` nebo vlastní spustitelné ověření 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 nové zjištění, fix nebo workflow pravidlo do trvalého artefaktu v repu
+- `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
+- `Codex: $workshop analyze` před handoffem nebo po rotaci, když chcete rychle odhalit slepá místa v repu
 
 ## Doporučený pracovní rytmus
 
-- `workshop` pro orientaci a další bezpečný krok
-- `brainstorm` nebo rovnou `plan`, když už je scope zřejmý
+- `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ý úklid: 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
 
 - Čím víc práce dělá agent samostatně, tím méně stačí „já jsem to rychle projel očima“.
 - Když necháte agenta psát bez testů, často jen urychlíte vznik neověřené složitosti.
-- RED test, tracer bullet nebo jednoduché e2e ověření je často nejrychlejší způsob, jak agentovi říct, co přesně má být pravda.
+- Spustitelné ověření (unit test, tracer bullet nebo jednoduché e2e ověření) je často nejrychlejší způsob, jak agentovi říct, co přesně má být pravda.
 
 ## Bezpečný UI workflow
 
 - Výchozí pattern je: `agent exploration -> Playwright regression -> human review`.
-- Nechte agenta rychle projít UI, screenshoty a konzoli v izolovaném lokálním prostředí.
+- Nechte agenta rychle projít UI, screenshoty a konzoli v izolovaném lokálním prostředí.
 - Jakmile najdete důležitý flow, převeďte ho do opakovatelného browser testu.
-- Nakonec změnu projděte člověkem. Testy chrání proti regresi, ale neřeší automaticky smysl a trade-offy.
-- „Nech model řídit můj běžný přihlášený browser“ není výchozí doporučení. To patří jen do sandboxovaného a záměrně omezeného prostředí.
+- Nakonec změnu projděte člověkem. Testy chrání proti regresi, ale neřeší automaticky smysl a trade-offy.
+- „Nech model řídit můj běžný přihlášený browser“ není výchozí doporučení. To patří jen do sandboxovaného a záměrně omezeného prostředí.
 
 ## Rychlá připomínka
 
-Dobrý prompt nestačí. Když má práce přežít handoff, musí být kontext uložený v repu a ověření musí být dohledatelné.
+Dobrý prompt nestačí. Když má práce přežít handoff, musí být kontext uložený v repu, další bezpečný krok musí být dohledatelný a ověření musí zůstat čitelné i pro cizí tým.
+
+## Learnings log — pro facilitátory
+
+- Po rotaci můžete procházet zachycené signály přímo v CLI: `harness workshop learnings`
+- Filtrujte podle tagu: `harness --json workshop learnings --tag missing_runbook`
+- Filtrujte podle kohorty nebo instance: `--cohort 2026-Q2`, `--instance <id>`
+- V dashboardu: rotační panel v detailu instance obsahuje capture formulář i přehled posledních záznamů
+- Learnings log přežije smazání instance a postupně buduje evidenci pro vylepšení blueprintu
 
 ## 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 handoff opřený o repo.
-- Když nechcete hledat v repu, použijte přímo `workshop resources`, `workshop gallery` nebo `workshop follow-up`.
+- 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).
+- Codex-specific craft (approval módy, sandboxing, long-horizon drift, před/po příklad) je v [`content/codex-craft.md`](../content/codex-craft.md).
+- Conversational moves pro coaching agenta sežene v jedné straně v [`materials/coaching-codex.md`](../materials/coaching-codex.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 handoff opřený o repo.
+- Když nechcete hledat v repu, použijte přímo `workshop resources`, `workshop gallery` nebo `workshop follow-up`.

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

@@ -18,7 +18,7 @@ Garantovaný výchozí nástroj pro dnešek je `workshop` skill. Další workflo
 - terminálový, hackovatelný multi-model setup: `pi`
 - macOS / Linux: `Codex CLI`
 - Windows nebo macOS: `Codex App`
-- Když se zaseknete: web fallback nebo pairing s někým, komu už setup běží
+- Když se zaseknete: web fallback nebo pairing s někým, komu už setup běží
 
 ## pi
 
@@ -31,7 +31,7 @@ npm install -g @mariozechner/pi-coding-agent
 2. Přihlaste provider nebo účet, který chcete používat.
 3. Otevřete repozitář.
 4. Spusťte `pi`.
-5. Načtěte workshop skill přes `/skill:workshop` a řekněte si o `setup`, `reference` nebo `brief`.
+5. Načtěte workshop skill přes `/skill:workshop` a řekněte si o `setup`, `reference` nebo `brief`.
 
 ## Codex CLI
 
@@ -39,7 +39,7 @@ npm install -g @mariozechner/pi-coding-agent
 2. Nainstalujte CLI podle interního setup flow vaší organizace.
 3. Přihlaste se.
 4. Otevřete repozitář.
-5. Pošlete první smysluplný prompt a ověřte, že dostáváte odpověď.
+5. Pošlete první smysluplný prompt a ověřte, že dostáváte odpověď.
 
 ## Codex App
 
@@ -53,8 +53,8 @@ npm install -g @mariozechner/pi-coding-agent
 
 - Neztrácejte 20 minut sólo debugováním setupu.
 - Po 7 minutách blokace přepněte na App, web fallback nebo pairing.
-- Když nefunguje autentizace, pokračujte s někým od stolu a vraťte se k vlastnímu setupu později.
-- Když si nejste jistí dalším krokem, použijte v Codexu `$workshop setup`. V pi načtěte `/skill:workshop` a řekněte si o setup pomoc. Nebo si zavolejte facilitátora.
+- Když nefunguje autentizace, pokračujte s někým od stolu a vraťte se k vlastnímu setupu později.
+- Když si nejste jistí dalším krokem, použijte v Codexu `$workshop setup`. V pi načtěte `/skill:workshop` a řekněte si o setup pomoc. Nebo si zavolejte facilitátora.
 
 ## Prvních 15 minut po setupu
 
@@ -68,10 +68,10 @@ npm install -g @mariozechner/pi-coding-agent
 3. Doplňte krátké `AGENTS.md`:
    - Codex: `$workshop template`
 4. Pojmenujte první bezpečný krok:
-   - ideálně přes `plan`, případně `brainstorm`, když scope ještě není jasný
-5. Přidejte jeden executable check:
-   - RED test, tracer bullet nebo aspoň jasný review/checklist krok
-6. Když chcete materiály i po workshopu:
+   - ideálně přes `$plan`, případně `brainstorm`, když scope ještě není jasný
+5. Přidejte jedno spustitelné ověření:
+   - unit test, tracer bullet nebo aspoň jasný review/checklist krok
+6. Když chcete materiály i po workshopu:
    - `Codex: $workshop resources`
    - `Codex: $workshop gallery`
    - `Codex: $workshop follow-up`
@@ -80,5 +80,5 @@ npm install -g @mariozechner/pi-coding-agent
 
 - Umíte otevřít repo.
 - Umíte poslat prompt.
-- Máte jednu funkční cestu, jak během workshopu pracovat s agentem.
-- Víte, jaký je první bezpečný krok v repu po setupu.
+- Máte jednu funkční cestu, jak během workshopu pracovat s agentem.
+- Víte, jaký je první bezpečný krok v repu po setupu.