@harness-lab/cli 0.2.9 → 0.3.0

package/assets/workshop-bundle/content/project-briefs/standup-bot.md

@@ -2,30 +2,32 @@
 
 ## Problém
 
-Denní standupy v chatu často končí jako dlouhé vlákno bez struktury. Blokery zapadnou, návaznosti mezi lidmi nejsou vidět a po pár hodinách už se těžko dohledává, co se vlastně domluvilo.
+Denní standupy v chatu často končí jako dlouhé vlákno bez struktury. Blokery zapadnou, návaznosti mezi lidmi nejsou vidět a po pár hodinách už se těžko dohledává, co se vlastně domluvilo.
 
-Vaším úkolem je navrhnout nástroj, který ze standup vstupů vytvoří přehled, se kterým se dá dál pracovat.
+Vaším úkolem je navrhnout nástroj, který ze standup vstupů vytvoří přehled, se kterým se dá dál pracovat i bez původního autora nebo bez otevřeného původního vlákna.
 
 ## User stories
 
 - Jako team lead chci sesbírat standup odpovědi do jednoho přehledného souhrnu.
-- Jako vývojář chci rychle vidět blokery, dependency a témata, která potřebují domluvu.
-- Jako tým po rotaci chci pochopit datový tok i integrační body bez ústního handoffu.
+- Jako vývojář chci rychle vidět blokery, dependency a témata, která potřebují domluvu.
+- Jako tým po rotaci chci pochopit datový tok i integrační body bez ústního handoffu.
 
 ## Architektonické poznámky
 
 - Upřednostněte jasný datový model před složitou integrací.
-- Mock data jsou v pořádku, pokud workflow působí realisticky a je dobře popsané.
-- Oddělte ingest, zpracování a prezentaci výstupu.
-- Prompty, runbooky a rozhodnutí musí být uložené v repu, ne jen v hlavách původního týmu.
+- Mock data jsou v pořádku, pokud workflow působí realisticky a je dobře popsané.
+- Oddělte ingest, zpracování a prezentaci výstupu.
+- Prompty, runbooky a rozhodnutí musí být uložené v repu, ne jen v hlavách původního týmu.
+- Neřešte „hezký summary text“ dřív než to, jestli jsou vidět blokery, dependency a další safe move.
 
 ## Hotovo když
 
-- Nástroj umí ingestovat seed data a vytvořit čitelný souhrn.
+- Nástroj umí ingestovat seed data a vytvořit čitelný souhrn.
 - Výstup zvýrazní blokery nebo položky, které potřebují pozornost.
 - Repo obsahuje instrukce, jak řešení napojit na reálný chat nebo jiný vstupní kanál.
 - Po rotaci lze navázat bez dalšího vysvětlování.
+- Je jasné, co je jisté shrnutí a co je jen heuristika nebo návrh.
 
 ## První krok pro agenta
 
-Rozděl práci na ingest, sumarizaci a kontext pro další tým. Nejdřív napiš dokumentaci, kterou nový tým otevře jako první, a až potom navrhni implementační kroky.
+Rozděl práci na ingest, sumarizaci a kontext pro další tým. Nejdřív napiš datový model, jistoty vs. heuristiky a dokumentaci, kterou nový tým otevře jako první. Až potom navrhni implementační kroky.

package/assets/workshop-bundle/content/talks/codex-demo-script.md

@@ -2,15 +2,15 @@
 
 ## Cíl
 
-Jedna příběhová ukázka, ne seznam funkcí. Publikum má během 15 minut pochopit, jak vypadá dobrý workflow s agentem.
+Jedna příběhová ukázka, ne seznam funkcí. Publikum má během 15 minut pochopit, jak vypadá dobrý workflow s agentem a proč tenhle repozitář drží pohromadě díky harnessu, ne díky improvizaci.
 
 ## Příběh
 
-„Jsem vývojář, dostal jsem malý úkol a nechci být s agentem jen někdo, kdo zkouší další prompt. Chci postavit pracovní systém, který unese další iterace.“
+„Jsem vývojář, dostal jsem malý úkol a nechci být s agentem jen někdo, kdo zkouší další prompt. Chci postavit pracovní systém, který unese další iterace, review i převzetí jiným člověkem.“
 
 ## Flow
 
-1. Otevři jednoduchý repozitář nebo sandbox projekt.
+1. Otevři jednoduchý repozitář nebo přímo Harness Lab slice, na kterém je vidět `README`, `AGENTS.md`, rozpad práce do kroků a způsob kontroly změny.
 2. Ukaž, že bez kontextu agent rychle tápe.
 3. Vytvoř `AGENTS.md` se 4 prvky:
    - Goal
@@ -18,12 +18,13 @@ Jedna příběhová ukázka, ne seznam funkcí. Publikum má během 15 minut poc
    - Constraints
    - Done When
 4. Spusť `/plan`, aby agent rozpadl práci na kroky.
-5. Nech agenta implementovat malý kus.
-6. Spusť `/review` a ukaž, že kontrola je součást workflow, ne nouzová brzda na konci.
-7. Krátce ukaž skill:
-   - instalovaný skill
-   - nebo jednoduchý command z workshop skillu
-8. Zavři to větou:
+5. Krátce ukaž, jak se v repu propisuje záměr: kde je mapa, kde je další bezpečný krok a kde je vidět, že tenhle repozitář vznikal jako continuation-ready systém.
+6. Nech agenta implementovat malý kus.
+7. Spusť `/review` a ukaž, že kontrola je součást workflow, ne nouzová brzda na konci.
+8. Krátce ukaž workshop skill:
+   - jak se instaluje přes `harness skill install`
+   - jak z něj plyne první použitelný krok v Codexu nebo v pi
+9. Zavři to větou:
    - „Nástroj sám nestačí. Rozhoduje pracovní systém kolem něj.“
 
 ## Fallbacky
@@ -37,7 +38,8 @@ Jedna příběhová ukázka, ne seznam funkcí. Publikum má během 15 minut poc
 - pět různých režimů práce
 - složitou přehlídku funkcí
 - dlouhé čekání na generování
+- demo odtržené od repa, ve kterém právě workshop běží
 
 ## Pointa pro místnost
 
-Nejde o to ukázat „kouzelný výsledek“. Jde o to ukázat, jak rychle roste kvalita, když přidáme kontext, plán a review.
+Nejde o to ukázat „kouzelný výsledek“. Jde o to ukázat, jak rychle roste kvalita, když přidáme kontext, plán, review a repozitář postavený tak, aby se v něm dalo pokračovat.

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

@@ -2,25 +2,25 @@
 
 ## Otevírací modul
 
-Tenhle workshop skill i dashboard vznikly stejným způsobem, jakým dnes budeme pracovat my: s AI agentem, ale s důrazem na kontext. Nejde mi o prodej nástroje. Jde mi o to ukázat disciplínu, která z nástroje dělá použitelného spolupracovníka.
+Tenhle workshop skill i dashboard vznikly stejným způsobem, jakým dnes budeme pracovat my: s AI agentem, ale s důrazem na kontext. Nejde mi o prodej nástroje. Jde mi o to ukázat disciplínu, která z nástroje dělá použitelného spolupracovníka.
 
-Rámec pro room launch:
+Rámec pro otevření dne:
 
-- dnes nezačínáme tool demo ani soutěž v promptování
-- budeme se učit, stavět, předávat i přebírat
-- odpoledne se ukáže, co z práce přežije bez nás
+- dnes nezačínáme tool demo ani soutěž v promptování
+- budeme se učit, stavět, předávat i přebírat
+- odpoledne se ukáže, co z práce přežije bez nás
 
 ## Klíčová linka
 
-Harness engineering je práce s instrukcemi, kontextem a workflow tak, aby agent dělal správné věci opakovaně a předvídatelně. Team lead přece neříká každých třicet sekund jednomu vývojáři, co má dělat. Staví systém, ve kterém tým funguje. A přesně tohle dnes budeme dělat pro agenty.
+Harness engineering je práce s instrukcemi, kontextem a workflow tak, aby agent dělal správné věci opakovaně a předvídatelně. Team lead přece neříká každých třicet sekund jednomu vývojáři, co má dělat. Staví systém, ve kterém tým funguje. A přesně tohle dnes budeme dělat pro agenty.
 
 Moje hlavní věta pro dnešek:
 
-> Neučíme se "lépe promptovat". Učíme se postavit repo a workflow, ve kterém agent i cizí tým dokážou bezpečně pokračovat.
+> Neučíme se „lépe promptovat". Učíme se postavit repo a workflow, ve kterém agent i cizí tým dokážou bezpečně pokračovat.
 
 ## Analogický beat
 
-Když dáte lidem stejné kostky, nevznikne jedna správná kachna. Stejně tak ze stejného modelu nevzniká jedna správná práce. Rozdíl nedělá jen model. Rozdíl dělá kontext, mantinely, ověřování a představivost týmu.
+Když dáte lidem stejné kostky, nevznikne jedna správná kachna. Stejně tak ze stejného modelu nevzniká jedna správná práce. Rozdíl nedělá jen model. Rozdíl dělá kontext, mantinely, ověřování a představivost týmu.
 
 Pointa analogie:
 
@@ -30,9 +30,9 @@ Pointa analogie:
 
 ## Mikro-cvičení
 
-Tohle je krátká facilitátorova ukázka, ne práce pro celý room.
+Tohle je krátká facilitátorova ukázka, ne práce pro celou místnost.
 
-Vezmeme stejný malý task ve dvou podmínkách. Jedna varianta bude prompt blob. Druhá varianta bude krátké zadání se 4 prvky a s odkazem na kontext zapsaný v repu. Pak porovnáme výsledky. Nehledáme „nejhezčí prompt“. Hledáme způsob práce, který přenese záměr, omezení a done criteria i do dalšího kroku.
+Vezmeme stejný malý task ve dvou podmínkách. Jedna varianta bude prompt blob. Druhá varianta bude krátké zadání se 4 prvky a s odkazem na kontext zapsaný v repu. Pak porovnáme výsledky. Nehledáme „nejhezčí prompt“. Hledáme způsob práce, který přenese záměr, omezení a done criteria i do dalšího kroku.
 
 4 prvky pro druhou variantu:
 
@@ -44,34 +44,34 @@ Vezmeme stejný malý task ve dvou podmínkách. Jedna varianta bude prompt blob
 ## Hlavní teze
 
 - Kontext je páka, ne kosmetika.
-- `AGENTS.md`, skills a runbooky jsou týmová infrastruktura.
+- `AGENTS.md`, skills a runbooky jsou týmová infrastruktura.
 - `AGENTS.md` nemá být encyklopedie. Má to být mapa, která ukáže, kam sáhnout dál.
-- Co není v repu, neexistuje. Slack, ústní dovysvětlení a "to si pamatujeme" se při návaznosti rozpadají.
+- Co není v repu, neexistuje. Slack, ústní dovysvětlení a "to si pamatujeme" se při návaznosti rozpadají.
 - Testy jsou hranice důvěry. Když agent pracuje samostatněji, musíte mnohem líp ověřovat, že udělal právě to, co jste chtěli.
-- Jednoduché mantinely zrychlují práci. Agentovi pomáhá jasný build/test flow, viditelné hranice a předvídatelná struktura.
-- U UI práce je výchozí pattern: agent exploration, potom repeatable browser test, potom lidské review.
-- „Nech model jezdit v mém běžném přihlášeném browseru“ není výchozí doporučení. Bezpečnější je izolované lokální prostředí a jasné mantinely.
-- RED → GREEN není s agenty pomalejší. Naopak často zlevňuje korekce, protože agent dostane přesnější mantinely.
-- Úklid není bonus po workshopu. Když narazíte na opakující se chaos, je čas ho proměnit v lepší template, check nebo runbook.
-- Odpolední návaznost prověří, jestli váš kontext funguje i bez vás.
+- Jednoduché mantinely zrychlují práci. Agentovi pomáhá jasný build/test flow, viditelné hranice a předvídatelná struktura.
+- U UI práce je výchozí pattern: agent exploration, potom repeatable browser test, potom lidské review.
+- „Nech model jezdit v mém běžném přihlášeném browseru“ není výchozí doporučení. Bezpečnější je izolované lokální prostředí a jasné mantinely.
+- Ověření napsané dřív, než pustíte agenta do většího kusu práce, není test-first dogma. Je to zápis done criteria do formy, kterou agent i další tým umí zkontrolovat. Iteraci to zrychluje, protože agent dostane přesné mantinely, ne další prompt.
+- Úklid není bonus po workshopu. Když narazíte na opakující se chaos, je čas ho proměnit v lepší template, ověření nebo runbook.
+- Odpolední návaznost prověří, jestli váš kontext funguje i bez vás.
 
 ## Co chci, aby si adoptovali
 
-- Než začnu generovat další funkci, udělám z repa místo, kde se dá orientovat.
+- Než začnu generovat další funkci, udělám z repa místo, kde se dá orientovat.
 - Když řekneme nějaké pravidlo dvakrát nahlas, patří do repa.
 - Když agent dělá víc, já musím lépe ověřovat.
 - Handoff není závěr dne. Je to průběžná podmínka celé práce.
 
 ## Most do Build fáze 1
 
-Po tomhle talku se tým nemá vracet k repu s pocitem, že potřebuje jen chytřejší prompt. Má se vracet s jedním jasným očekáváním:
+Po tomhle talku se tým nemá vracet k repu s pocitem, že potřebuje jen chytřejší prompt. Má se vracet s jedním jasným očekáváním:
 
 - pokud ještě nemá workshop skill, teď je chvíle na `harness skill install`, pak `Codex: $workshop setup` nebo `pi: /skill:workshop`
-- nejdřív krátká mapa v repu
-- potom plan
-- potom první explicitní check
+- nejdřív krátká mapa v repu
+- potom krátký plán kroků
+- potom první explicitní ověření
 - teprve potom další feature motion
 
 ## Závěr
 
-Odpoledne nezažijete jen to, že „AI někdy funguje a někdy ne“. Zažijete, jak moc výsledek závisí na kvalitě pracovního systému, který kolem agenta postavíte.
+Odpoledne nezažijete jen to, že „AI někdy funguje a někdy ne“. Zažijete, jak moc výsledek závisí na kvalitě pracovního systému, který kolem agenta postavíte.

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

@@ -43,6 +43,7 @@ Required commands:
 - `harness workshop status`
 - `harness workshop list-instances`
 - `harness workshop show-instance <instance-id>`
+- `harness workshop participant-access [<instance-id>]`
 - `harness workshop create-instance`
 - `harness workshop update-instance`
 - `harness workshop reset-instance <instance-id>`
@@ -99,6 +100,7 @@ Current command posture:
   - `harness workshop list-instances`
 - explicit target preferred but selected-instance fallback allowed:
   - `harness workshop show-instance [<instance-id>]`
+  - `harness workshop participant-access [<instance-id>]`
   - `harness workshop update-instance [<instance-id>]`
   - `harness workshop reset-instance [<instance-id>]`
   - `harness workshop prepare [<instance-id>]`

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