@harness-lab/cli 0.2.1 → 0.2.3

package/assets/workshop-bundle/content/style-examples.md

@@ -0,0 +1,127 @@
+# Czech Style Examples
+
+## Do / Don't
+
+### 1. Instrukce
+
+Do:
+
+- „Otevřete repozitář a nejdřív doplňte `AGENTS.md`.“
+
+Don't:
+
+- „V prvním kroku je vhodné provést vytvoření souboru `AGENTS.md`.“
+
+### 2. Setup
+
+Do:
+
+- „Když se setup sekne, přejděte na Codex App nebo web fallback.“
+
+Don't:
+
+- „V případě komplikací v procesu instalace je možné využít alternativní variantu přístupu.“
+
+### 3. Facilitation
+
+Do:
+
+- „Prvních 10 minut po rotaci jen čtěte a mapujte repo.“
+
+Don't:
+
+- „Po realizaci rotace doporučujeme zahájit aktivitu detailní analýzou repozitáře.“
+
+### 4. Workshop framing
+
+Do:
+
+- „Dnes nejde o to být nejrychlejší. Jde o to předat práci tak, aby ji cizí tým dokázal převzít.“
+
+Don't:
+
+- „Hlavním cílem dnešního dne je maximalizace schopnosti efektivního předávání výstupů mezi týmy.“
+
+### 5. Czech + English
+
+Do:
+
+- „Nejdřív spusťte `/plan`, potom implementujte malý krok a nakonec udělejte `/review`.“
+
+Don't:
+
+- „Nejdříve vytvořte plán, pak proveďte implementaci a následně zrevidujte změnu.“
+
+Poznámka:
+
+Tady je angličtina přirozenější, protože jde o konkrétní commands a workflow terms.
+
+### 6. Technical explanation
+
+Do:
+
+- „Monitoring teď běží jako manuální MVP. Ondřej spustí scan repozitářů a z výsledku připraví intermezzo brief.“
+
+Don't:
+
+- „Monitoring je aktuálně realizován prostřednictvím minimální životaschopné verze manuálního typu.“
+
+### 7. Briefs
+
+Do:
+
+- „Mock data jsou v pořádku, pokud workflow působí realisticky.“
+
+Don't:
+
+- „Použití simulovaných dat je akceptovatelné za předpokladu, že výsledný proces bude působit realisticky.“
+
+### 8. Error / fallback messaging
+
+Do:
+
+- „Pokud vám nefunguje CLI, pokračujte přes App a neztrácejte dalších 20 minut.“
+
+Don't:
+
+- „V případě nefunkčnosti rozhraní příkazové řádky doporučujeme zvážit alternativní postup.“
+
+## Approved English Terms
+
+Tyto výrazy se v textech pro účastníky běžně nechávají v angličtině:
+
+- `prompt`
+- `review`
+- `workflow`
+- `skill`
+- `runbook`
+- `build`
+- `deploy`
+- `checkpoint`
+- `fallback`
+- `handoff`
+- `CLI`
+- `App`
+- `repo`
+- `README`
+- `AGENTS.md`
+- `Done When`
+
+## Usually Better In Czech
+
+Tyto části bývají lepší česky:
+
+- cíle a instrukce
+- facilitační věty
+- reflexe a uzavírání
+- vysvětlení, proč něco děláme
+- očekávání a pravidla workshopu
+
+## Rewrite Heuristic
+
+Když text zní moc tvrdě přeloženě, uprav ho takto:
+
+1. zkrať větu
+2. vrať české sloveso do aktivního rodu
+3. nech technický termín v angličtině
+4. zkontroluj, že věta vede k akci

package/assets/workshop-bundle/content/style-guide.md

@@ -0,0 +1,108 @@
+# Czech Voice & Style Guide
+
+## Purpose
+
+Tento workshop mluví česky, ale přemýšlí jako moderní developerský tým. Cílem není přeložit celý obor do češtiny. Cílem je psát tak, aby český developer text pochopil napoprvé a zároveň měl pocit, že čte přirozený, profesionální a jazykově kultivovaný obsah.
+
+## Core Principle
+
+Preferujeme porozumění před doslovným překladem.
+
+- čeština pro význam, instrukce, facilitaci a vysvětlení
+- angličtina pro běžné technické termíny, commands, file names a tool names
+
+## Tone of Voice
+
+- Piš jako zkušený peer, ne jako marketér a ne jako školní učebnice.
+- Buď věcný, klidný a praktický.
+- Piš s energií, ale bez hype.
+- Vysvětluj jasně, ale ne patronizujícím tónem.
+- Preferuj přesnost a použitelnost před efektní formulací.
+
+## Language Rules
+
+- Základní jazyk je spisovná, přirozená čeština.
+- Technické výrazy nech v angličtině, pokud jsou v developerské praxi běžnější než český ekvivalent.
+- Nepřekládej násilně výrazy jako `prompt`, `review`, `workflow`, `skill`, `runbook`, `deploy`, `build`, `checkpoint`, `handoff`, `fallback`, `CLI`, `App`.
+- Slash commands, file names, paths a config keys vždy nech v originále.
+- Když je anglický termín méně samozřejmý, při prvním výskytu ho krátce ukotvi česky.
+
+## Sentence Style
+
+- Používej kratší věty.
+- Preferuj aktivní rod.
+- Piš konkrétní slovesa místo abstraktních obratů.
+- Každý odstavec má mít jeden jasný účel.
+- Když lze něco říct jednodušeji, zjednoduš to.
+
+## What Good Looks Like
+
+- „Nejdřív spusťte `/plan` a teprve potom začněte implementaci.“
+- „Pokud se zaseknete déle než 7 minut, přejděte na fallback nebo pairing.“
+- „Do 10:30 potřebujete mít jednu funkční cestu do Codexu.“
+
+## What To Avoid
+
+- korporátní omáčka
+- doslovné kalky z angličtiny
+- přehnaně akademický tón
+- agresivní marketingový tón
+- zbytečné vykřičníky
+
+## Preferred Vocabulary
+
+- `udělejte`
+- `zkontrolujte`
+- `spusťte`
+- `doplňte`
+- `ověřte`
+- `pokračujte`
+- `když se zaseknete`
+
+## Avoid These Patterns
+
+- „je žádoucí realizovat“
+- „dochází k implementaci“
+- „v rámci workshopu bude umožněno“
+- „s cílem maximalizace efektivity“
+- „využitím tohoto přístupu dosáhnete…“
+
+## Czech + English Mixing Rule
+
+Česká věta má zůstat česká, i když obsahuje anglické technické termíny.
+
+Dobře:
+
+- „Po rotaci si nejdřív přečtěte `README`, `AGENTS.md` a aktuální plan.“
+- „Použijte `/review`, když chcete zkontrolovat větší změnu.“
+
+Špatně:
+
+- „Use `/plan` before coding, because it gives better context.“
+- „V rámci challenge budete implementing a new workflow.“
+
+## Formatting Rule
+
+- Commands, file names, slash commands a literal terms piš v backticks.
+- Nadpisy a běžný výklad piš normální češtinou.
+- V textech pro účastníky nezahlcuj čtenáře dlouhými bloky textu.
+
+## Audience Calibration
+
+Workshop je pro developery. Nepiš, jako by publikum bylo netechnické.
+
+- není nutné vysvětlovat běžné výrazy typu `repo`, `review`, `deploy`
+- je vhodné vysvětlit nový koncept, pokud je specifický pro workshop
+- když volíš mezi „přeložit“ a „zachovat známý termín“, preferuj známý termín
+
+## Final Check Before Publishing
+
+Před uložením textu pro účastníky si ověř:
+
+1. Zní to jako přirozená čeština?
+2. Pochopí to český developer napoprvé?
+3. Nepřekládám něco, co má zůstat v angličtině?
+4. Nezní to jako marketing nebo korporát?
+5. Je z textu jasné, co má člověk udělat?
+
+Pro finální workshop-ready revizi použijte i [`content/czech-editorial-review-checklist.md`](./czech-editorial-review-checklist.md).

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

@@ -0,0 +1,43 @@
+# Codex Demo Script
+
+## Cíl
+
+Jedna příběhová ukázka, ne seznam funkcí. Publikum má během 15 minut pochopit, jak vypadá dobrý workflow s agentem.
+
+## 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.“
+
+## Flow
+
+1. Otevři jednoduchý repozitář nebo sandbox projekt.
+2. Ukaž, že bez kontextu agent rychle tápe.
+3. Vytvoř `AGENTS.md` se 4 prvky:
+   - Goal
+   - Context
+   - 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:
+   - „Nástroj sám nestačí. Rozhoduje pracovní systém kolem něj.“
+
+## Fallbacky
+
+- Když nefunguje CLI: přejdi na Codex App
+- Když nefunguje App: použij web fallback
+- Když je demo pomalé: měj připravený repo snapshot po každém kroku
+
+## Co explicitně neukazovat
+
+- pět různých režimů práce
+- složitou přehlídku funkcí
+- dlouhé čekání na generování
+
+## 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.

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

@@ -0,0 +1,42 @@
+# Context is King
+
+## Otevírací moment
+
+Tento 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.
+
+## 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.
+
+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.
+
+## Mikro-cvičení
+
+Všichni dostanou stejný malý úkol. 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 kritéria hotovo i do dalšího kroku.
+
+## Hlavní teze
+
+- Kontext je páka, ne kosmetika.
+- `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í.
+- 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.
+
+## Co chci, aby si adoptovali
+
+- 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.
+
+## 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.

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

@@ -0,0 +1,143 @@
+# `harness` CLI Foundation
+
+This document defines the deliberately small v1 scope for the facilitator-side `harness` CLI.
+
+## Current Repo Status
+
+Current implementation in this repo:
+
+- lives in the repository `harness-cli/` package and ships publicly as `@harness-lab/cli`
+- distributes a portable participant workshop skill bundle through `harness skill install`
+- covers `auth login/logout/status` plus `workshop status/create-instance/update-instance/prepare/remove-instance/archive/phase set`
+- targets the existing shared dashboard facilitator APIs
+- is tested for browser/device auth, local-dev Basic Auth fallback, and cookie-backed Neon bootstrap fallback
+- stores sessions in a local file under `HARNESS_CLI_HOME` or `~/.harness` by default
+- supports macOS Keychain, Windows Credential Manager, or Linux Secret Service as explicit storage overrides
+- exposes dashboard-side device auth routes plus a facilitator approval page at `/admin/device`
+
+Current npm release posture:
+
+- participant-facing npm publication is supported through an explicit release workflow
+- routine development still happens from this repository
+- broader live-runtime manual validation against a deployed dashboard remains part of the first-release checklist
+
+## Why The CLI Exists
+
+The facilitator skill and any other local tooling need a privileged auth path, but raw facilitator credentials and long-lived session state should not live inside arbitrary skill state.
+
+The CLI creates a narrower trust boundary:
+
+- browser or device-based facilitator login
+- local session storage
+- short operational commands over the same runtime APIs used by the dashboard
+
+## V1 Scope
+
+Required commands:
+
+- `harness auth login`
+- `harness auth logout`
+- `harness auth status`
+- `harness workshop status`
+- `harness workshop create-instance`
+- `harness workshop update-instance`
+- `harness workshop archive`
+- `harness workshop prepare`
+- `harness workshop remove-instance`
+- `harness workshop phase set <phase-id>`
+
+The CLI may also expose a thin authenticated request wrapper for facilitator skills.
+
+## V1 Non-Goals
+
+- participant teaching logic beyond portable skill distribution and install guidance
+- replacing dashboard UX
+- storing reusable workshop blueprint content
+- becoming a second API surface with different nouns
+- automatic publish-back of runtime edits into the repo
+
+## Auth Model
+
+Preferred interactive path:
+
+1. facilitator starts `harness auth login`
+2. CLI opens browser or emits a device-code style flow
+3. dashboard auth/backend completes facilitator identity verification
+4. CLI stores the resulting platform session material in local session storage
+
+The facilitator skill should call the CLI for privileged operations instead of storing raw auth/session material itself.
+
+Control model:
+
+- skill invokes CLI
+- CLI invokes shared protected dashboard APIs
+- APIs enforce authz, validation, idempotency, and audit logging
+
+Current auth layering:
+
+- `harness auth login` authenticates the facilitator to the platform
+- workshop commands then target a concrete workshop instance explicitly or through a default-selection rule
+- instance grants are checked when a workshop is targeted, not during login bootstrap
+
+Current target-selection order:
+
+1. an explicit command or route instance id
+2. the selected control-room instance in the dashboard
+3. the deployment default `HARNESS_WORKSHOP_INSTANCE_ID`
+4. a repository fallback only on surfaces that intentionally present a workspace-level default
+
+Current command posture:
+
+- explicit target required:
+  - `harness workshop update-instance <instance-id>`
+  - `harness workshop prepare <instance-id>`
+  - `harness workshop remove-instance <instance-id>`
+- explicit target is the created resource:
+  - `harness workshop create-instance [<instance-id>]`
+- deployment-default target:
+  - `harness workshop status`
+  - `harness workshop archive`
+  - `harness workshop phase set <phase-id>`
+
+Current discoverability path:
+
+- facilitators can inspect available workshop instances through the dashboard workspace view
+- the same platform-scoped list lives behind the authenticated instances API surface at `/api/workshop/instances`
+
+For the current facilitator lifecycle slice:
+
+- `workshop status`, `create-instance`, `update-instance`, and `prepare` are brokered-session commands
+- `workshop remove-instance` remains owner-only on the server
+- facilitator `grant` and `revoke` remain a later step-up policy slice rather than part of this lifecycle command set
+
+Current step-up posture:
+
+- the existing CLI command set (`workshop status/archive/phase set`) may run on a valid brokered device session
+- future higher-risk commands such as facilitator grant/revoke or destructive instance mutations should require a fresh browser approval window rather than silently reusing an older CLI session
+
+## Session Storage Posture
+
+Default storage backend:
+
+- file-based storage under `HARNESS_CLI_HOME` or `~/.harness`
+
+Optional storage backends:
+
+- macOS Keychain
+- Windows Credential Manager
+- Linux Secret Service
+
+The default should optimize for reliability and low-friction setup across facilitator machines. OS-native credential stores remain available through `HARNESS_SESSION_STORAGE` when a facilitator prefers them.
+
+## Packaging Posture
+
+V1 should optimize for cross-platform setup speed, not native-binary perfection.
+
+Recommended posture:
+
+- ship as a small Node-based CLI from this repository or its derived package
+- support straightforward installation on macOS and Windows
+- carry the portable public-safe workshop skill bundle needed for participant install
+- keep the command surface stable enough that the facilitator skill can depend on it
+
+If facilitator setup friction remains high, native single-file packaging can be evaluated later without changing the control model.

package/assets/workshop-bundle/docs/learner-reference-gallery.md

@@ -0,0 +1,82 @@
+# Learner Reference Gallery
+
+Tohle je krátký seznam zdrojů pro účastníky po workshopu.
+
+Pravidlo je jednoduché:
+- nejdřív oficiální dokumentace
+- potom několik silných veřejných repozitářů
+- nakonec malý počet patternů přímo relevantních pro Harness Lab
+
+Jakmile tato stránka začne připomínat „awesome list“, je moc dlouhá.
+
+## Oficiální dokumentace
+
+- [OpenAI Codex documentation](https://developers.openai.com/codex)
+  Použijte jako hlavní zdroj pro aktuální Codex workflow, skills, `AGENTS.md`, subagenty a bezpečnostní doporučení.
+
+- [OpenAI Codex best practices](https://developers.openai.com/codex/learn/best-practices)
+  Nejlepší rychlý vstup pro to, jak Codex používat jako dlouhodobého spolupracovníka: kontext, `AGENTS.md`, review, verification, MCP a automatizace.
+
+- [OpenAI Codex skills documentation](https://developers.openai.com/codex/skills)
+  Hodí se ve chvíli, kdy chcete z opakovaných promptů udělat znovupoužitelné skills zapsané přímo v repu.
+
+- [OpenAI Codex plugins](https://developers.openai.com/codex/plugins)
+  Dobré pro pochopení, kdy v Codexu použít pluginy a marketplace místo samotných skills zapsaných v repu. Pro workshop je berte jako volitelný Codex akcelerátor, ne jako základní bootstrap.
+
+- [OpenAI Codex build plugins](https://developers.openai.com/codex/plugins/build)
+  Hodí se maintainerům, když chtějí pochopit marketplace model, repo-local marketplace nebo balení skills, app integrací a MCP serverů do jednoho Codex balíčku.
+
+- [OpenAI Codex workflows](https://developers.openai.com/codex/workflows)
+  Dobré pro převedení workshopových návyků do reálných projektových workflow.
+
+- [OpenAI: Harness engineering: leveraging Codex in an agent-first world](https://openai.com/index/harness-engineering/)
+  Dobré pro pochopení, proč má být repo knowledge systémem záznamu a proč jsou plans, review a garbage collection součást engineering discipline, ne bonus navíc.
+
+- [Next.js AI Coding Agents](https://nextjs.org/docs/app/guides/ai-agents)
+  Důležité hlavně pro Next.js projekty: ukazuje, proč mají agenti číst version-matched framework docs místo spoléhání na starší paměť modelu.
+
+## Veřejné repozitáře
+
+- [openai/codex](https://github.com/openai/codex)
+  Oficiální CLI repozitář a nejlepší kotva pro to, jak se samotný nástroj vyvíjí.
+
+- [openai/skills](https://github.com/openai/skills)
+  Oficiální katalog skills a nejlepší reference pro to, jak vypadá Codex-native skill.
+
+- [openai/codex-action](https://github.com/openai/codex-action)
+  Silný příklad úzké a bezpečné automatizace kolem Codexu v CI.
+
+- [vercel-labs/skills](https://github.com/vercel-labs/skills)
+  Užitečné ve chvíli, kdy chcete skill packaging přenositelný napříč více coding agenty.
+
+- [vercel-labs/agent-skills](https://github.com/vercel-labs/agent-skills)
+  Dobré příklady kvalitních a praktických skills, hlavně pro frontend a React práci.
+
+## Volitelné workflow packs
+
+- [EveryInc/compound-engineering-plugin](https://github.com/EveryInc/compound-engineering-plugin)
+  Silná volitelná volba pro lidi, kteří chtějí explicitní loop `brainstorm -> plan -> work -> review -> compound`. Repo dnes umí instalaci i pro Codex a pi, ale berte to jako akcelerátor nad workshop defaultem, ne jako nutný setup.
+
+## Praktické patterny
+
+- Začněte repo kontextem dřív, než začnete opakovat prompt.
+  V praxi: nejdřív přidejte `AGENTS.md`, build/test příkazy a konkrétní definici hotovo.
+
+- Skills používejte pro opakované workflow, ne jako jednorázové chat makro.
+  Když se stejný task vrací napříč více sessions nebo repy, je to kandidát na skill.
+
+- Pluginy a marketplace berte jako Codex-specific distribuční vrstvu, ne jako definici workshop metody.
+  Když něco učíme jako výchozí přístup v Harness Labu, mělo by to dávat smysl i mimo Codex. Plugin má smysl tam, kde skutečně přidává Codex integrace nebo pohodlnější distribuci.
+
+- Testy, tracer bullets a checklisty berte jako hranici důvěry.
+  Čím víc autonomie agent dostane, tím méně stačí „rychle jsem projel diff“.
+
+- Příklady pro účastníky držte menší než backstage systémy.
+  Dobrý learner artefakt je kopírovatelný a čitelný, ne vyčerpávající.
+
+## Pravidlo čerstvosti
+
+Tento seznam zrevidujte:
+- před každým workshopovým během
+- po větší změně Codex capabilities
+- když doporučený repozitář zastará, začne být noisy nebo přestane být nejlepší ukázkou

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

@@ -0,0 +1,126 @@
+# Learner Resource Kit
+
+Tato stránka definuje účastnický kit zdrojů pro 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.
+
+## Základní pravidlo
+
+Learner kit není celý backstage workshopu.
+
+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?
+
+Výchozí pracovní rytmus, který má learner kit posilovat, je:
+- `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
+
+### 1. Workshop skill
+
+Hlavní rozhraní pro účastníky:
+- [`SKILL.md`](../SKILL.md)
+- [`workshop-skill/setup.md`](../workshop-skill/setup.md)
+- [`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
+
+### 2. `AGENTS.md` příklad
+
+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
+
+### 3. Příklad pro ověření a review
+
+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
+
+### 4. Challenge cards
+
+Doporučený subset:
+- [`content/challenge-cards/deck.md`](../content/challenge-cards/deck.md)
+
+Použití:
+- malé zásahy během workshopu
+- nápověda, co zlepšit později v reálném repu
+
+### 5. Follow-up package
+
+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í
+
+## Kdy který artefakt použít
+
+### Během setupu
+
+Použijte:
+- [`workshop-skill/setup.md`](../workshop-skill/setup.md)
+- [`workshop-skill/reference.md`](../workshop-skill/reference.md)
+
+### Během build fáze 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)
+
+### Během odpoledního převzetí
+
+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)
+
+### Po workshopu
+
+Použijte:
+- [`workshop-skill/recap.md`](../workshop-skill/recap.md)
+- [`workshop-skill/follow-up-package.md`](../workshop-skill/follow-up-package.md)
+- [`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
+
+Účastníci by měli odejít s těmito konkrétními kroky:
+
+1. Přidejte `AGENTS.md` s částmi:
+   - goal
+   - context
+   - constraints
+   - done when
+2. Do `context` napište, co má agent číst jako první a které docs jsou zdroj pravdy.
+3. Do `done when` napište konkrétní ověření a další bezpečný krok, když práce zůstane rozdělaná.
+4. Přidejte build/test příkazy, které zvládne spustit další tým nebo agent bez ústního dovysvětlení.
+5. Přidejte jeden review nebo handoff checklist.
+6. Přesuňte jedno trvalé pravidlo z chatu do repa.
+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ří
+
+Learner kit nemá obsahovat plný backstage provozní detail, například:
+- runbooky pro konkrétní workshop instance
+- privátní runtime architekturu a operace
+- monitoring nebo řídicí postupy jen pro facilitátory
+- maintainer-level deployment a security postupy, pokud se zrovna neučí explicitně jako skill pro účastníky