@harness-lab/cli 0.2.2 → 0.2.4

package/README.md

@@ -36,6 +36,11 @@ Participant-facing default install:
 npm install -g @harness-lab/cli
 ```
 
+Supported runtime:
+
+- Node `22` or newer
+- npm `10` or newer recommended
+
 Verify the binary:
 
 ```bash
@@ -78,6 +83,7 @@ harness skill install --target /path/to/team-repo
 This creates `.agents/skills/harness-lab-workshop` in the target repo. The install does not require a local clone of the Harness Lab source repo.
 Rerunning `harness skill install` refreshes the installed bundle when the packaged workshop content changed and reports clearly when the target is already current. Use `--force` only when you want a full reinstall.
 After install, the CLI prints the first recommended agent commands, starting with `Codex: $workshop commands` and `pi: /skill:workshop`.
+Treat the installed `workshop` skill as the first participant entrypoint. It should route setup, reference, and workshop guidance through live `contentLang` when available or the best reviewed bundled locale otherwise, instead of assuming the base authored Czech docs are always the right first stop.
 
 Treat `.agents/skills/harness-lab-workshop` as generated workshop bundle content. The canonical authored source remains in this repository under `workshop-skill/`, `workshop-blueprint/`, selected `docs/`, and selected `materials/`.
 

package/assets/workshop-bundle/SKILL.md

@@ -18,7 +18,7 @@ allowed-tools:
 
 # Workshop
 
-Participant-facing skill for the Harness Lab workshop. All participant-facing copy is Czech. Technical terms stay in English.
+Participant-facing skill for the Harness Lab workshop. Command semantics stay in English, but participant-facing delivery should follow the active workshop `contentLang` when live runtime data is available and fall back to the best reviewed bundled locale otherwise.
 
 ## Purpose
 
@@ -31,6 +31,8 @@ Core mental model:
 - dashboard facilitator surface = řízení workshop instance
 - workshop skill = AI interface ke stejnému workshop systému
 - workshop blueprint = veřejná kanonická definice workshop method
+- `uiLang` = jazyk product chrome
+- `contentLang` = jazyk workshopového obsahu pro participant-facing delivery
 
 ## Sources Of Truth
 
@@ -44,6 +46,7 @@ Use runtime dashboard data for anything that changes during the workshop day:
 Use repo-native content for stable public guidance:
 - `content/` workshop materials
 - `workshop-skill/` reference docs
+- `workshop-skill/locales/<locale>/` when a reviewed localized fallback doc exists for the requested delivery language
 - `workshop-blueprint/` for the reusable workshop method
 - challenge cards, project briefs, and public-safe framing
 
@@ -52,6 +55,10 @@ Rule:
 - repo docs first for durable workshop guidance
 - if runtime is unavailable, fall back to repo material and say explicitly that the answer is fallback rather than live state
 - runtime edits do not imply blueprint edits; reusable changes belong back in the repo deliberately
+- prefer workshop `contentLang` for participant-facing responses in live mode
+- if there is no live workshop context, prefer the best reviewed bundled locale and say when the answer is fallback content rather than live workshop state
+- for bundled fallback docs, resolve `workshop-skill/locales/<locale>/...` first; if a reviewed localized doc does not exist yet, fall back to the best reviewed bundled locale and say so explicitly
+- do not translate workshop copy ad hoc when a reviewed locale exists in the repo or bundle
 
 ## Commands
 
@@ -83,12 +90,12 @@ Clear the current participant session and return to fallback/public-only mode.
 
 ### `workshop setup`
 
-Guide the participant through Codex or pi setup in Czech. Prefer the fastest viable path:
+Guide the participant through Codex or pi setup in the active workshop content language. Prefer the fastest viable path:
 - pi in terminal when the participant wants a hackable multi-model interface
 - Codex CLI on macOS/Linux
 - Codex App on Windows or macOS
 - web fallback if local install is blocked
-Use the content from `workshop-skill/setup.md`.
+Use `workshop-skill/locales/<locale>/setup.md` when present, otherwise fall back to `workshop-skill/setup.md`.
 
 ### `workshop brief`
 
@@ -97,6 +104,7 @@ Show the assigned project brief. Include:
 - user stories
 - architecture considerations
 - first recommended prompt for the AI agent
+If live runtime brief data is unavailable, prefer `content/project-briefs/locales/<locale>/<brief>.md` when present and otherwise fall back to `content/project-briefs/<brief>.md`.
 
 ### `workshop challenges`
 
@@ -104,6 +112,7 @@ Show available challenge cards, clearly marking:
 - semi-mandatory before lunch
 - semi-mandatory after the continuation shift
 - optional stretch cards
+If live runtime challenge data is unavailable, prefer `content/challenge-cards/locales/<locale>/deck.md` when present and otherwise fall back to `content/challenge-cards/deck.md`.
 
 ### `workshop team`
 
@@ -135,8 +144,8 @@ Keep it short and map-like. Prefer links to deeper docs over long prose dumps.
 
 ### `workshop recap`
 
-Return a short post-workshop reinforcement prompt in Czech.
-Use the content from `workshop-skill/recap.md`.
+Return a short post-workshop reinforcement prompt in the active workshop content language.
+Use `workshop-skill/locales/<locale>/recap.md` when present, otherwise fall back to `workshop-skill/recap.md`.
 
 ### `workshop commands`
 
@@ -144,7 +153,7 @@ Return a short participant-facing menu of the skill surface:
 - what the main commands are
 - when to use them
 - the shortest recommended path for a new participant
-Use `workshop-skill/commands.md`.
+Use `workshop-skill/locales/<locale>/commands.md` when present, otherwise fall back to `workshop-skill/commands.md`.
 
 ### `workshop closing`
 
@@ -157,14 +166,14 @@ Treat this as facilitator-facing. Do not proactively surface it to participants
 
 ### `workshop reference`
 
-Return the workshop reference card from `workshop-skill/reference.md`.
+Return the workshop reference card from `workshop-skill/locales/<locale>/reference.md` when present, otherwise fall back to `workshop-skill/reference.md`.
 
 ### `workshop resources`
 
 Return the participant-facing resource bundle after or during the workshop.
 Use these sources together:
-- `materials/participant-resource-kit.md`
-- `docs/learner-resource-kit.md`
+- `materials/locales/<locale>/participant-resource-kit.md` when present, otherwise `materials/participant-resource-kit.md`
+- `docs/locales/<locale>/learner-resource-kit.md` when present, otherwise `docs/learner-resource-kit.md`
 
 The response should:
 - summarize what is in the kit
@@ -173,12 +182,12 @@ The response should:
 
 ### `workshop gallery`
 
-Return the curated external reference gallery from `docs/learner-reference-gallery.md`.
+Return the curated external reference gallery from `docs/locales/<locale>/learner-reference-gallery.md` when present, otherwise `docs/learner-reference-gallery.md`.
 Use this when the participant asks for further reading, public examples, optional skill packs, or recommended external resources after the workshop.
 
 ### `workshop follow-up`
 
-Return the follow-up package from `workshop-skill/follow-up-package.md`.
+Return the follow-up package from `workshop-skill/locales/<locale>/follow-up-package.md` when present, otherwise `workshop-skill/follow-up-package.md`.
 Use this when the participant asks what to do after the workshop, what to revisit tomorrow, or what materials to keep using next week.
 
 ### `workshop facilitator login`
@@ -209,6 +218,7 @@ Prefer invoking `harness workshop create-instance` over raw API scripts.
 The skill should support rich event metadata, not just id and city:
 - `id`
 - `templateId`
+- `contentLang`
 - `eventTitle`
 - `city`
 - `dateRange`
@@ -223,6 +233,7 @@ The skill should support rich event metadata, not just id and city:
 Update event metadata for an existing workshop instance. Requires facilitator session.
 Prefer invoking `harness workshop update-instance` over raw API scripts.
 Use this when the facilitator wants to correct or refine date, venue, room, address, or event title without resetting the instance.
+Support `contentLang` changes explicitly so facilitators can choose workshop delivery language per instance without changing admin UI language.
 
 ### `workshop facilitator remove-instance`
 

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

@@ -1,8 +1,8 @@
 {
   "manifestVersion": 1,
   "bundleName": "harness-lab-workshop",
-  "bundleVersion": "0.2.2",
-  "contentHash": "6d6ce5d3aa65d63167694b96c4db70bdd77c6084b529fdf78711c0a24c4e704d",
+  "bundleVersion": "0.2.4",
+  "contentHash": "9e57d44e4a3f9296f4913cd51eefbf9dff7d6d9da8d4afb1ae5a2ce2a7dc4323",
   "files": [
     {
       "path": "content/challenge-cards/.gitkeep",
@@ -10,12 +10,20 @@
     },
     {
       "path": "content/challenge-cards/deck.md",
-      "sha256": "de269aabe1a598294dbd1a2c2fb5dc858fd381811446fc649ff29555a67eda07"
+      "sha256": "c2828eb5258031351d6d5abd3388b26b0894a9122e88e3203efaccbfd95a3e82"
+    },
+    {
+      "path": "content/challenge-cards/locales/en/deck.md",
+      "sha256": "6b6a3882ef31b3bca9f1f1ed43ef4fb2d8340af9879fee4261922fb55f6cd921"
     },
     {
       "path": "content/challenge-cards/print-spec.md",
       "sha256": "be7ecfdae9ada4145272f12e2d6018ccde7cfaeb9f48feb58aca7da7236815c0"
     },
+    {
+      "path": "content/czech-editorial-review-checklist.md",
+      "sha256": "23539ba8b2c6ed193cfadc7ad0f0f75e99b2926ebff5beade5df9789e6071fcf"
+    },
     {
       "path": "content/facilitation/.gitkeep",
       "sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"
@@ -26,7 +34,7 @@
     },
     {
       "path": "content/facilitation/master-guide.md",
-      "sha256": "3199e25208552384efc5bafd9be512dd8e9cb428a39ea443af9eb4569f32d37a"
+      "sha256": "e22f4a811459be1fe23412e7d85c02fe20170e6e6c8534fc97c1616f65b2cfd8"
     },
     {
       "path": "content/project-briefs/.gitkeep",
@@ -44,6 +52,26 @@
       "path": "content/project-briefs/doc-generator.md",
       "sha256": "3f3bea866c68a927916d90fa3e387ceccdd174290944bc83db7b89d43f3ba7a0"
     },
+    {
+      "path": "content/project-briefs/locales/en/code-review-helper.md",
+      "sha256": "57339193c04eb3cfd444e5477d86923b0c9d189163437f0c56a7db5a0045aa87"
+    },
+    {
+      "path": "content/project-briefs/locales/en/devtoolbox-cli.md",
+      "sha256": "cb7a92f20fa0565611feb9f24eb65aafc4a7b151a32de42c93d33b93049f161e"
+    },
+    {
+      "path": "content/project-briefs/locales/en/doc-generator.md",
+      "sha256": "5ff49a57e51c030b34385709ab7519a5d8e19cd98a1e3a5b26603a7eb59c02e3"
+    },
+    {
+      "path": "content/project-briefs/locales/en/metrics-dashboard.md",
+      "sha256": "ff6b429001ea4ab2d9c23fbdfe02c5daaaf413d52609f9dabc365902f2ad063a"
+    },
+    {
+      "path": "content/project-briefs/locales/en/standup-bot.md",
+      "sha256": "bc3972786dac4298607c63e15262cf5330c7e7fcf754e5df64e8fae081f5b44b"
+    },
     {
       "path": "content/project-briefs/metrics-dashboard.md",
       "sha256": "a678058b6515fec4acba5d288bb71a725dfe9e75320efa11a475d63492db14f6"
@@ -54,11 +82,11 @@
     },
     {
       "path": "content/style-examples.md",
-      "sha256": "21bc5f03aeff64cc6441e521ab006f8fcf1ec0c2f55630f218a08108fe6a32f2"
+      "sha256": "c8e62493e119995fca1c738584b864506bc838203b1adad008c37b6f6ec57c50"
     },
     {
       "path": "content/style-guide.md",
-      "sha256": "0f4661a267bdec133d3eeddb36a4c86ad15c3f09a4975d6d1ed0afa7c918ae1c"
+      "sha256": "ec9a49e040efbc6c365eb264bd3452fdf1906f141f358ff28d2e0e3360648d28"
     },
     {
       "path": "content/talks/.gitkeep",
@@ -66,35 +94,47 @@
     },
     {
       "path": "content/talks/codex-demo-script.md",
-      "sha256": "560eec6e45a45e0cf02a85a47f5c34ea30cf741ab592c411eab96fd90ca4c1f8"
+      "sha256": "4f40188a8d3ccaddf44b89b39178c7e9cfb53298a8803815f91dce204181a9c2"
     },
     {
       "path": "content/talks/context-is-king.md",
-      "sha256": "338a357e1a61cdc5b2956f0191d699d13cee8ba1ea5047af4656985cd2ff4713"
+      "sha256": "c380947051f4a66cdf47e846d5cc5d60ace0487f75dbc718b03fb7164cb94ef1"
     },
     {
       "path": "docs/harness-cli-foundation.md",
-      "sha256": "94d5004a795e3e3669433be9f5b480bbe71b0aaf8ba32b060f930896fb1ee2ac"
+      "sha256": "65b0b2cee7be792ad03f9be794230298d3efe8283e8e73acb033ef401d204e51"
     },
     {
       "path": "docs/learner-reference-gallery.md",
-      "sha256": "fe00f671111eba6092cf28941277c6e4b45dff3c01396cffd351799daee292e5"
+      "sha256": "42a9e595e28a580b4d5104cf9967211d611c03e7ee020cb14daed25c26ef575d"
     },
     {
       "path": "docs/learner-resource-kit.md",
-      "sha256": "47819b6134e5184ec229a5f0cc61d9be0718434d59ad1cc49c263b8fb8388a48"
+      "sha256": "c1c35a7896a835a49599688993f9782ad09e4f1c012b7c2b8d60b90b826eab1b"
+    },
+    {
+      "path": "docs/locales/en/learner-reference-gallery.md",
+      "sha256": "1ab9df5b5ce9e95dd594974d867377a6d32463a4e3f7590f3611400e8fae59ed"
+    },
+    {
+      "path": "docs/locales/en/learner-resource-kit.md",
+      "sha256": "70a8acd554f8785360d0fb40b5b9648d9fbc90bf70b8b6776e98d33c931f4348"
     },
     {
       "path": "docs/workshop-event-context-contract.md",
       "sha256": "a7706a398ea5250537fb34323c4371ea2a7db15e477aec3a7893e6089fcd281f"
     },
+    {
+      "path": "materials/locales/en/participant-resource-kit.md",
+      "sha256": "1d8b2fbf019db86c56db9cd001965f97985461c79cd615cd861562f336b175fb"
+    },
     {
       "path": "materials/participant-resource-kit.md",
-      "sha256": "73cf30345820fec8547af96a360997562dbd4c18c8f1cfb8758e20d727c449bf"
+      "sha256": "19564e2e1156f60654e07a1c965f87668a8cb78cab5f9d06b1e1127ce812f13c"
     },
     {
       "path": "SKILL.md",
-      "sha256": "8a390c373bde15558f3a552803cad2240cf926578f2b54b33baf56f4d472374f"
+      "sha256": "b25a7730eb123edd941bcb176bd861ad209868189601c49845d1b6892f689647"
     },
     {
       "path": "workshop-blueprint/agenda.json",
@@ -118,7 +158,7 @@
     },
     {
       "path": "workshop-blueprint/README.md",
-      "sha256": "f82176f7476fd2ce3673f42dbdbe6a1ea250e833b177be0a7a5dc8318a6b3e41"
+      "sha256": "ae809a473bbc88411891044de7609fa053e66e370a8d4063e5d7b9e68179a98c"
     },
     {
       "path": "workshop-blueprint/teaching-spine.md",
@@ -130,7 +170,7 @@
     },
     {
       "path": "workshop-skill/analyze-checklist.md",
-      "sha256": "46c96ddda53e9b6086187c519e7126cce9b63d6d71f9462e306c741445756077"
+      "sha256": "b8ec5bb13a5ec25f0d3b8cbd60295c0b290aaae195d833956cd906092efc945d"
     },
     {
       "path": "workshop-skill/closing-skill.md",
@@ -138,19 +178,39 @@
     },
     {
       "path": "workshop-skill/commands.md",
-      "sha256": "c6e432e770df361c03cf81910ffef9724f50a2c8e99faec54263c27921cbfc59"
+      "sha256": "932305291e1fc943308f218a5d2714f43a2fea471f4702fe5c94192ed3cbc1e8"
     },
     {
       "path": "workshop-skill/facilitator.md",
-      "sha256": "3ba33e10a9820b8f46beb0cdfae362a7bd35e093aa3ee250647a45000667c681"
+      "sha256": "39dcb46914f19b66fd270627f42702b1f394ceb05dd0f3cf1f0c514becb6dca1"
     },
     {
       "path": "workshop-skill/follow-up-package.md",
-      "sha256": "01bbd1f9bf7458a1e8ceb55eee5aab749448c613cc70a91bb7b2bf14240ce593"
+      "sha256": "a8c9e847ac1c7dd03bc044ab4d82f8ce18f83c48b665aee3723e64487f845963"
     },
     {
       "path": "workshop-skill/install.md",
-      "sha256": "196226385ac1bf38dfa7df3845692505db62f9e08a4c0027e2722c423bf4fa24"
+      "sha256": "2bb08f93523348de834d1e7004ef4603905c8d036247037e2111153cd0fea76b"
+    },
+    {
+      "path": "workshop-skill/locales/en/commands.md",
+      "sha256": "17856fa19a44c3336709186cba171505db4b503d11bc16ad2fbc49f67d6c78a0"
+    },
+    {
+      "path": "workshop-skill/locales/en/follow-up-package.md",
+      "sha256": "c3d4b0057ddc7a2a50713b6a01e7a3564b4e8668118464e19f932d2baa7a81a0"
+    },
+    {
+      "path": "workshop-skill/locales/en/recap.md",
+      "sha256": "68141bac34417fbc8669ebd2e998658dcb66a2a8d1df6cf8ac8d2f449baacdae"
+    },
+    {
+      "path": "workshop-skill/locales/en/reference.md",
+      "sha256": "5269750632ab577f9373cd84ae57741b11364cfbd9a05d6ac7dd8de555236b53"
+    },
+    {
+      "path": "workshop-skill/locales/en/setup.md",
+      "sha256": "b5efeee9bb2ee1ada3ab2c86ae47c63afd51534fe58a849f0584384737150375"
     },
     {
       "path": "workshop-skill/recap.md",
@@ -158,15 +218,15 @@
     },
     {
       "path": "workshop-skill/reference.md",
-      "sha256": "45364102e4e57af38e150671eb42602a572d9588ad45e7604a6e5327a311f14c"
+      "sha256": "2023dabca1aba04a539152131e8cec2eb832c0e1107e2bb808bd8b296159bbdb"
     },
     {
       "path": "workshop-skill/setup.md",
-      "sha256": "ed5af717dadf8aeac256a393bd6edc103362cc91674a0c36a0a3580aa37c18ae"
+      "sha256": "ef67c05751f2c48182b834314e411fc912d0ec99f7cb28fab540534e2a07096c"
     },
     {
       "path": "workshop-skill/template-agents.md",
-      "sha256": "14141706f104f16373642a08a43e66ac9fd8231da46615c898587fad2fa503ee"
+      "sha256": "07dd6ee5a017a0af01bf3bdcc465f06a9d8701851a413e805d29cbb22a7d991a"
     }
   ]
 }

package/assets/workshop-bundle/content/challenge-cards/deck.md

@@ -11,7 +11,7 @@ Karty nejsou body navíc. Jsou to malé zásahy, které zlepšují způsob prác
 
 ## Workflow
 
-- `Použijte /plan před kódováním` — ukažte, z jakého planu tým vycházel, co z něj opravdu plní a jaký je další safe move.
+- `Použijte /plan před kódováním` — ukažte, z jakého plánu tým vycházel, co z něj opravdu plní a jaký je další bezpečný krok.
 - `Rozdělte práci do více vláken` — zkuste dvě nezávislé linie práce a jednoho člověka na integraci.
 - `Delegujte úkol a vraťte se ke kontrole za 10 minut` — neskákejte agentovi do každého kroku, kontrolujte až výsledek.
 - `Přidejte nejmenší užitečné ověření` — vytvořte RED test, tracer bullet nebo jednoduchý browser check dřív, než agent dostane víc autonomie.
@@ -32,7 +32,7 @@ Karty nejsou body navíc. Jsou to malé zásahy, které zlepšují způsob prác
 
 ## Jak s kartami pracovat
 
-- Před obědem má každý tým splnit aspoň jednu kartu z `Context Engineering`.
-- Před rotací má být v repu dohledatelné, co bylo opravdu ověřeno a jaký je další safe move.
+- Před obědem má každý tým splnit aspoň jednu kartu z části `Context Engineering`.
+- Před rotací má být v repu dohledatelné, co bylo opravdu ověřeno a jaký je další bezpečný krok.
 - Po rotaci má každý tým splnit aspoň jednu kartu z `Workflow`.
 - Ostatní karty jsou dobrovolné. Berte je jako stretch cíle nebo inspiraci, když nevíte, co zlepšit dál.

package/assets/workshop-bundle/content/challenge-cards/locales/en/deck.md

@@ -0,0 +1,38 @@
+# Challenge Cards
+
+These cards are not bonus points. They are small interventions that improve both the way of working with the agent and the quality of the handoff.
+
+## Context Engineering
+
+- `Create AGENTS.md as a map` - write down the goal, build and test commands, durable rules, and where the next team should look first.
+- `Add build/test commands` - the agent must be able to verify the result without manual backfilling.
+- `Write a code review skill` - formalize one review routine that another team could use too.
+- `Move one rule from conversation into the repo` - anything the team has said out loud twice should be turned into `AGENTS.md`, README, a runbook, or a test.
+
+## Workflow
+
+- `Use /plan before coding` - show which plan the team is working from, what is actually being executed, and what the next safe move is.
+- `Split the work into multiple threads` - try two independent work streams and one person on integration.
+- `Delegate a task and come back to check it in 10 minutes` - do not jump into every agent step; inspect the outcome instead.
+- `Add the smallest useful verification` - create a RED test, tracer bullet, or simple browser check before the agent gets more autonomy.
+
+## Advanced
+
+- `Run 2 parallel Codex sessions` - split the problem into two independent parts and compare the outputs.
+- `Create a deployment runbook` - even if the deploy stays simulated.
+- `Write AGENTS.md for a subfolder` - show that context can be global and local at the same time.
+- `Introduce garbage collection` - find one repeating form of chaos and turn it into a check, template, or rule.
+
+## Meta
+
+- `Move a durable rule from a prompt into AGENTS.md`.
+- `Add a Done When section to every task`.
+- `Write README for the team after rotation, not for yourself`.
+- `Record what is actually verified` - distinguish done, in progress, and assumed.
+
+## How to use the cards
+
+- Before lunch, every team should complete at least one `Context Engineering` card.
+- Before rotation, the repo should clearly show what was actually verified and what the next safe move is.
+- After rotation, every team should complete at least one `Workflow` card.
+- The other cards are optional. Treat them as stretch goals or prompts for what to improve next.

package/assets/workshop-bundle/content/czech-editorial-review-checklist.md

@@ -0,0 +1,88 @@
+# Czech Editorial Review Checklist
+
+Použijte tento checklist při revizi českého obsahu pro účastníky, hlavně pro:
+
+- workshop agenda a presenter scenes
+- pokyny pro participant room
+- project briefs
+- challenge cards
+- setup, reference, recap, follow-up a learner-kit materiály
+
+Tento checklist doplňuje [`content/style-guide.md`](./style-guide.md) a [`content/style-examples.md`](./style-examples.md). Není to náhrada. Je to poslední quality gate před tím, než se text bere jako workshop-ready.
+
+## 1. Přirozenost češtiny
+
+- Zní text jako přirozená čeština, ne jako překlad?
+- Přečetl by to český developer bez škobrtnutí?
+- Nejsou ve větách doslovné anglické kalky?
+- Nejsou věty zbytečně dlouhé nebo toporné?
+
+## 2. Kvalita míchání češtiny a angličtiny
+
+- Zůstává česká věta česká?
+- Jsou anglické termíny použité jen tam, kde jsou v developerské praxi opravdu přirozené?
+- Není v textu náhodně promíchaná angličtina jen proto, že původní zdroj byl anglický?
+- Když se méně známý anglický termín objevuje poprvé, je stručně ukotvený česky?
+
+## 3. Jasnost instrukce
+
+- Je z textu jasné, co má člověk udělat právě teď?
+- Mají věty konkrétní slovesa jako `spusťte`, `zkontrolujte`, `doplňte`, `ověřte`?
+- Neschovává se akce za abstraktní formulace typu „je vhodné realizovat“?
+- Nejsou odstavce přeplněné více cíli najednou?
+
+## 4. Workshop voice
+
+- Zní text jako zkušený peer, ne jako marketér nebo korporát?
+- Drží se text klidného, věcného a praktického tónu?
+- Nezní text jako slide, slogan nebo generický AI obsah?
+- Je z textu cítit disciplína workshopu: kontext zapsaný v repu, ověření, handoff?
+
+## 5. Terminologická disciplína
+
+- Jsou opakované workshop terms použité konzistentně?
+- Neobjevují se slabé nebo matoucí fráze jen proto, že znějí „AI-ish“?
+- Jsou výrazy jako `safe move`, `handoff`, `checkpoint`, `workflow`, `review`, `skill`, `runbook` použité záměrně, ne náhodně?
+- Není stejná věc jednou česky a podruhé napůl anglicky bez důvodu?
+
+## 6. Vyhněte se těmto signálům
+
+Pokud se v textu objeví něco z toho, vraťte ho do editace:
+
+- doslovný překlad anglické vazby
+- česká věta s náhodně vloženými anglickými slovy mimo technické termíny
+- korporátní nebo školometský tón
+- fráze, které nic nekotví k akci
+- generické AI obraty bez konkrétního významu
+
+## 7. Spoken check
+
+Přečtěte text nahlas nebo aspoň polohlasem.
+
+Text vrátit do editace, pokud:
+
+- se nedá říct plynule
+- obsahuje nepřirozený slovosled
+- zní tvrdě přeloženě
+- potřebuje v hlavě „opravovat“, co tím autor asi myslel
+
+## 8. Cross-locale check
+
+Pokud text vznikal z anglického source:
+
+- není to doslovný překlad?
+- drží česká verze stejný význam, ale přirozenější formulací?
+- není česká verze výrazně slabší, plošší nebo méně konkrétní než anglická?
+- není anglický source sám o sobě slabý a nehodí se nejdřív přepsat?
+
+## 9. Before publish
+
+Před schválením českého textu pro účastníky musí být možné říct `ano` na všechno:
+
+1. Je to přirozená čeština?
+2. Rozumí tomu český developer napoprvé?
+3. Je jasné, co má člověk udělat nebo pochopit?
+4. Drží text workshop voice bez hype a bez korporátu?
+5. Je míchání češtiny a angličtiny disciplinované?
+6. Neobsahuje text slabé fráze nebo „AI slop“?
+7. Obstojí text při čtení nahlas?

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

@@ -14,7 +14,7 @@ Nastavit energii dne a jasně pojmenovat, o čem workshop je.
 
 - Nejde o soutěž v promptování.
 - Jde o práci s agentem tak, aby po vás zůstával použitelný kontext.
-- Odpolední část prověří, jestli repo umí mluvit samo za sebe.
+- Odpolední část prověří, jestli repo opravdu unese převzetí dalším týmem.
 - Pokud nějaké důležité pravidlo žije jen v hovoru u stolu, ještě neexistuje.
 
 ### Co má facilitátor průběžně vracet
@@ -24,7 +24,7 @@ Nastavit energii dne a jasně pojmenovat, o čem workshop je.
 - „Je `AGENTS.md` mapa, nebo už se z něj stává dump?“
 - „Jaký je další bezpečný krok pro cizího člověka nebo agenta?“
 
-## Build Phase 1
+## Build fáze 1
 
 ### Viditelný milestone board
 
@@ -32,14 +32,14 @@ Nastavit energii dne a jasně pojmenovat, o čem workshop je.
 2. do 11:15 existuje `AGENTS.md`
 3. do 11:30 existuje plan
 4. do 11:45 existuje build/test command nebo tracer bullet
-5. do 12:00 existuje první reviewed output
+5. do 12:00 existuje první ověřený výstup
 
 ### Role facilitátora
 
 - nejdřív coach — ptejte se, co tým potřebuje a kde je zaseknutý
 - pak mentor — pomozte s workflow nebo s nástrojem
 - učitel až jako poslední možnost — krátce vysvětlete princip a vraťte tým do práce
-- participantům vracejte hlavně learner-facing artefakty, ne celý backstage Harness Lab
+- vracejte týmům hlavně artefakty, ze kterých se dá opravdu pracovat, ne celý backstage Harness Lab
 
 ### Na co se při obcházení dívat
 
@@ -84,7 +84,7 @@ Preferované checkpoint otázky:
 
 - zviditelnit učení napříč týmy
 - udělat z průběhu dne sérii krátkých checkpointů
-- připomenout, že workflow je stejně důležité jako samotný output
+- připomenout, že workflow je stejně důležité jako samotný výsledek
 - vracet týmy k tomu, že bez ověření jen akcelerují nejistotu
 
 ## Rotace
@@ -98,13 +98,13 @@ Preferované checkpoint otázky:
 - Začněte `README`, `AGENTS.md` a planem.
 - Needitujte hned první soubor, který otevřete.
 - Nejprve si udělejte mapu: co funguje, co chybí, co je rizikové.
-- Nejdřív napište vlastní diagnózu: co pomáhá, co chybí, co je rizikové a jaký je další safe move.
-- Když tým neví, po čem sáhnout, vraťte ho k learner kit artefaktům: `template-agents`, `reference`, `analyze-checklist`, challenge cards.
+- Nejdřív napište vlastní diagnózu: co pomáhá, co chybí, co je rizikové a jaký je další bezpečný krok.
+- Když tým neví, po čem sáhnout, vraťte ho k learner kitu: `template-agents`, `reference`, `analyze-checklist` a challenge cards.
 
 ### Facilitační pointa k rotaci
 
 - Frustrace je užitečný signál, pokud ukazuje na skrytý kontext nebo chybějící verifikaci.
-- Nepomáhejte týmům ústním handoffem nahrazovat slabý repo signal.
+- Nepomáhejte týmům ústním handoffem nahrazovat slabý signál v repu.
 - Pomáhejte jim pojmenovat, co musí být po rotaci dopsáno, zpřesněno nebo ověřeno.
 
 ## Reveal a reflexe
@@ -128,4 +128,4 @@ Otázky:
 - Nehodnotíme, který tým byl lepší.
 - Díváme se na systém: které signály pomáhají práci přežít handoff a které ji brzdí.
 - Sbíráme konkrétní příklady, ne obecné dojmy.
-- Každá opakující se bolest je kandidát na lepší template, challenge card nebo guidance v blueprintu.
+- Každá opakující se bolest je kandidát na lepší template, challenge card nebo vodítko v blueprintu.

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

@@ -0,0 +1,31 @@
+# Code Review Helper
+
+## Problem
+
+Code review is often uneven. Some changes arrive with a strong checklist and clear risk framing, while others come through without a shared standard. The reviewer improvises, the author does not know what to verify in advance, and the team loses consistency.
+
+Your task is to design a tool that turns a diff or change set into a usable review checklist.
+
+## User stories
+
+- As a reviewer, I want a fast checklist of risks, questions, and focus areas from a diff.
+- As the author of a change, I want to know what I should verify before the review starts.
+- As the team after rotation, I want to continue from the heuristics the original team already discovered instead of reinventing them.
+
+## Architecture notes
+
+- This can be a CLI, web app, or simple script. The important part is a clear `diff -> analysis -> checklist` flow.
+- It must be obvious which inputs the tool expects and what it cannot evaluate reliably.
+- Add a seed diff or `examples/` so the workflow can be checked locally.
+- Separate heuristic from certainty clearly. The tool should help the reviewer, not pretend to be infallible.
+
+## Done when
+
+- The tool produces a review checklist from a seed diff.
+- The output distinguishes certain findings from recommendations or hypotheses.
+- It is clear how to add another rule or heuristic without a long onboarding pass.
+- Another team can continue development within minutes without chaos.
+
+## First step for the agent
+
+Do not start with code. First write the review rules, the input flow, and a definition of what a good checklist means. Only then propose the first implementation slice.

package/assets/workshop-bundle/content/project-briefs/locales/en/devtoolbox-cli.md

@@ -0,0 +1,31 @@
+# DevToolbox CLI
+
+## Problem
+
+Almost every team ends up with small one-off scripts for log cleanup, JSON conversion, suspicious commit lookup, or fast repo checks. They work for a while, often for one person only, and after a few days nobody remembers how to run or extend them.
+
+Your task is to design a CLI tool that handles several common developer tasks in a way that survives handoff to another team.
+
+## User stories
+
+- As a developer, I want to turn a log or JSON blob into a readable format with one command.
+- As a developer, I want to quickly find suspicious commits, branches, or changes without manually assembling git commands.
+- As a team, I want both the commands and the way of working documented so another team can continue after rotation without confusion.
+
+## Architecture notes
+
+- Choose any language or framework, but the CLI must stay easy to run and easy to discover.
+- Separate commands from helper utilities and configuration from the start.
+- `AGENTS.md` should describe the build and test flow, output conventions, and the rules for future extension.
+- A runbook for the team that inherits the project after lunch matters as much as a working command.
+
+## Done when
+
+- There are at least 3 useful commands or subcommands.
+- `README` and `AGENTS.md` describe local execution and verification.
+- It is clear where to add another command without breaking the project structure.
+- A new team can add or fix another command within 10 minutes.
+
+## First step for the agent
+
+First design the minimal architecture that survives handoff. Start with `AGENTS.md`, then prepare a plan, and only then implement the first command.