@harness-lab/cli 0.2.1 → 0.2.2

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

@@ -0,0 +1,416 @@
+# Facilitator Commands
+
+Příkazy pro facilitátory, kteří řídí workshop instance přes AI agenta.
+
+## Auth
+
+Facilitátor se musí nejdřív přihlásit přes `harness` CLI. Skill nemá být další secret store pro raw credentials ani dlouhodobou session.
+
+### `/workshop facilitator login`
+
+Pokud není aktivní facilitátorská session, řekni facilitátorovi, aby spustil:
+
+```bash
+harness auth login
+```
+
+CLI provede browser/device auth flow, uloží session do lokálního file storage a zpřístupní ji pro další privileged příkazy.
+
+Aktuální praktický path v repu:
+
+- default / browser-device auth:
+```bash
+harness auth login --dashboard-url https://harness-lab-dashboard.vercel.app
+```
+- file mode / lokální demo fallback:
+```bash
+harness auth login --auth basic --dashboard-url http://localhost:3000 --username facilitator --password secret
+```
+- neon mode / sdílený dashboard bootstrap fallback:
+```bash
+harness auth login --auth neon --dashboard-url https://harness-lab-dashboard.vercel.app --email facilitator@example.com
+```
+
+Poznámka:
+- CLI dnes defaultně používá browser/device auth a ukládá session do lokálního file storage
+- Pokud facilitátor chce OS-native storage, může použít `HARNESS_SESSION_STORAGE=keychain`, `credential-manager` nebo `secret-service`
+- `--auth basic` a `--auth neon` zůstávají jen jako explicitní fallback pro lokální dev/bootstrap
+
+### `/workshop facilitator logout`
+
+Požádej o:
+
+```bash
+harness auth logout
+```
+
+## Instance Management
+
+### `/workshop facilitator status`
+
+Preferovaný path:
+
+```bash
+harness workshop status
+```
+
+Zobraz:
+- aktivní instanci a její stav
+- aktuální fázi
+- seznam facilitátorů s rolemi
+- počet týmů
+
+### `/workshop facilitator grant <email> <role>`
+
+Použij CLI-backed privileged request path. Skill nemá řešit auth bootstrap sám.
+
+API capability zůstává:
+
+```http
+POST {DASHBOARD_URL}/api/admin/facilitators
+Content-Type: application/json
+
+{ "email": "...", "role": "operator" }
+```
+
+Vyžaduje `owner` roli. Vrací info o novém grantu.
+
+### `/workshop facilitator revoke <email>`
+
+Nejdřív zavolej `GET /api/admin/facilitators` a najdi grant podle emailu.
+Pak:
+```
+DELETE {DASHBOARD_URL}/api/admin/facilitators/{grantId}
+```
+
+Vyžaduje `owner` roli.
+
+### `/workshop facilitator create-instance`
+
+Preferovaný path je CLI příkaz nad sdíleným runtime API:
+
+```bash
+harness workshop create-instance developer-hackathon-praha-24-4-saturn \
+  --template-id blueprint-default \
+  --event-title "Developer Hackathon Praha" \
+  --city Praha \
+  --date-range "24. dubna 2026" \
+  --venue-name "Seyfor Praha jednička 103" \
+  --room-name Saturn \
+  --address-line "CZ, Praha 8, Sokolovska 695/115b" \
+  --location-details "17 osob + lektor" \
+  --facilitator-label Ondrej
+```
+
+Raw API reference zůstává jen jako diagnostická nebo architektonická reference:
+
+```http
+POST {DASHBOARD_URL}/api/workshop/instances
+Content-Type: application/json
+
+{
+  "id": "developer-hackathon-praha-24-4-saturn",
+  "templateId": "blueprint-default",
+  "eventTitle": "Developer Hackathon Praha",
+  "city": "Praha",
+  "dateRange": "24. dubna 2026",
+  "venueName": "Seyfor Praha jednička 103",
+  "roomName": "Saturn",
+  "addressLine": "CZ, Praha 8, Sokolovska 695/115b",
+  "locationDetails": "17 osob + lektor",
+  "facilitatorLabel": "Ondrej"
+}
+```
+
+Poznámky pro skill:
+- skill má preferovat CLI, ne ručně skládané `fetch` skripty
+- `id` musí být lowercase slug s písmeny, čísly a pomlčkami
+- když skill volá create opakovaně se stejným `id`, route vrací `created: false` a existující instance record
+- nehádej venue metadata zkráceně, když je facilitátor zná; pošli je rovnou při create
+
+### `/workshop facilitator update-instance <instance-id>`
+
+Preferovaný path:
+
+```bash
+harness workshop update-instance developer-hackathon-praha-24-4-saturn \
+  --event-title "Developer Hackathon Praha" \
+  --date-range "24. dubna 2026" \
+  --venue-name "Seyfor Praha jednička 103" \
+  --room-name Saturn \
+  --address-line "CZ, Praha 8, Sokolovska 695/115b" \
+  --location-details "17 osob + lektor" \
+  --facilitator-label Ondrej
+```
+
+Raw API reference:
+
+```http
+PATCH {DASHBOARD_URL}/api/workshop/instances/{instanceId}
+Content-Type: application/json
+
+{
+  "action": "update_metadata",
+  "eventTitle": "Developer Hackathon Praha",
+  "dateRange": "24. dubna 2026",
+  "venueName": "Seyfor Praha jednička 103",
+  "roomName": "Saturn",
+  "addressLine": "CZ, Praha 8, Sokolovska 695/115b",
+  "locationDetails": "17 osob + lektor",
+  "facilitatorLabel": "Ondrej"
+}
+```
+
+Pravidla:
+- pošli jen fieldy, které chceš změnit
+- nepoužívej reset pro obyčejnou opravu názvu, venue nebo room
+- když route vrátí `400`, payload je špatně; když vrátí `404`, instance neexistuje
+
+### `/workshop facilitator prepare`
+
+Preferovaný path:
+
+```bash
+harness workshop prepare developer-hackathon-praha-24-4-saturn
+```
+
+Raw API reference:
+
+```http
+POST {DASHBOARD_URL}/api/workshop
+Content-Type: application/json
+
+{ "action": "prepare", "instanceId": "developer-hackathon-praha-24-4-saturn" }
+```
+
+Nastaví instanci do stavu `prepared`, ověří event code.
+
+### `/workshop facilitator remove-instance <instance-id>`
+
+Preferovaný path:
+
+```bash
+harness workshop remove-instance developer-hackathon-praha-24-4-saturn
+```
+
+Raw API reference:
+
+```http
+PATCH {DASHBOARD_URL}/api/workshop/instances/{instanceId}
+Content-Type: application/json
+
+{ "action": "remove" }
+```
+
+Pravidla:
+- remove zůstává owner-only operace
+- skill má facilitátora upozornit, že jde o destruktivní odebrání z aktivního seznamu, ne o běžnou editaci metadata
+
+### `/workshop facilitator agenda`
+
+Lokální editace agendy pro konkrétní instanci používá instanční route:
+
+```http
+GET {DASHBOARD_URL}/api/workshop/instances/{instanceId}/agenda
+PATCH {DASHBOARD_URL}/api/workshop/instances/{instanceId}/agenda
+POST {DASHBOARD_URL}/api/workshop/instances/{instanceId}/agenda
+DELETE {DASHBOARD_URL}/api/workshop/instances/{instanceId}/agenda
+```
+
+Příklady:
+
+```http
+PATCH {DASHBOARD_URL}/api/workshop/instances/{instanceId}/agenda
+Content-Type: application/json
+
+{
+  "action": "update",
+  "itemId": "build-1",
+  "title": "...",
+  "time": "...",
+  "goal": "...",
+  "roomSummary": "...",
+  "facilitatorPrompts": ["..."],
+  "watchFors": ["..."],
+  "checkpointQuestions": ["..."]
+}
+```
+
+```http
+PATCH {DASHBOARD_URL}/api/workshop/instances/{instanceId}/agenda
+Content-Type: application/json
+
+{ "action": "move", "itemId": "build-1", "direction": "up" }
+```
+
+```http
+POST {DASHBOARD_URL}/api/workshop/instances/{instanceId}/agenda
+Content-Type: application/json
+
+{
+  "title": "...",
+  "time": "...",
+  "goal": "...",
+  "roomSummary": "...",
+  "facilitatorPrompts": ["..."],
+  "watchFors": ["..."],
+  "checkpointQuestions": ["..."],
+  "afterItemId": "build-1"
+}
+```
+
+Pravidla:
+
+- agenda item je facilitátorský pack, ne jen `title/time/description`
+- preferované fieldy jsou `goal`, `roomSummary`, `facilitatorPrompts`, `watchFors`, `checkpointQuestions`
+- `description` zůstává compatibility field pro starší surface; pro room-facing shrnutí preferuj `roomSummary`
+- používej kanonická agenda ids jako `opening`, `talk`, `demo`, `build-1`, `intermezzo-1`, `rotation`, `build-2`, `intermezzo-2`, `reveal`
+- skill nemá vymýšlet vlastní názvy workshop momentů mimo tuto kostru
+
+### `/workshop facilitator scenes`
+
+Presenter scenes jsou agenda-linked room-facing výstupy pro facilitátora a projektor. Skill má umět:
+
+- vypsat scény pro celou instanci nebo konkrétní agenda item
+- vytvořit novou scénu
+- upravit obsah, label, scene type a CTA
+- změnit default scénu pro danou agenda položku
+- přeuspořádat scény
+- skrýt nebo znovu povolit scénu
+- smazat lokální scénu
+- číst a případně upravit `facilitatorNotes`, `sourceRefs` a `blocks`
+
+Instanční route:
+
+```http
+GET {DASHBOARD_URL}/api/workshop/instances/{instanceId}/scenes
+GET {DASHBOARD_URL}/api/workshop/instances/{instanceId}/scenes?agendaItemId=talk
+POST {DASHBOARD_URL}/api/workshop/instances/{instanceId}/scenes
+PATCH {DASHBOARD_URL}/api/workshop/instances/{instanceId}/scenes
+DELETE {DASHBOARD_URL}/api/workshop/instances/{instanceId}/scenes
+```
+
+Příklady:
+
+```http
+POST {DASHBOARD_URL}/api/workshop/instances/{instanceId}/scenes
+Content-Type: application/json
+
+{
+  "agendaItemId": "talk",
+  "label": "Prompt blob vs repo context",
+  "sceneType": "demo",
+  "intent": "walkthrough",
+  "chromePreset": "agenda",
+  "title": "Nejdřív bez kontextu, potom s mapou",
+  "facilitatorNotes": [
+    "Držte jednu story, ne feature tour."
+  ],
+  "blocks": [
+    {
+      "id": "hero",
+      "type": "hero",
+      "title": "Nejdřív bez kontextu, potom s mapou",
+      "body": "Ukažte rozdíl mezi prompt blobem a krátkou repo-native mapou."
+    },
+    {
+      "id": "questions",
+      "type": "bullet-list",
+      "title": "Pointa",
+      "items": [
+        "Co není v repu, neexistuje.",
+        "Kontext je páka, ne kosmetika."
+      ]
+    }
+  ],
+  "ctaLabel": "Potom přepnout na participant walkthrough"
+}
+```
+
+```http
+PATCH {DASHBOARD_URL}/api/workshop/instances/{instanceId}/scenes
+Content-Type: application/json
+
+{
+  "action": "update",
+  "agendaItemId": "talk",
+  "sceneId": "scene-123",
+  "label": "Upravený demo flow",
+  "sceneType": "demo",
+  "intent": "walkthrough",
+  "chromePreset": "agenda",
+  "title": "Jedna story, ne feature tour",
+  "blocks": [
+    {
+      "id": "hero",
+      "type": "hero",
+      "title": "Jedna story, ne feature tour",
+      "body": "Neukazujte pět režimů práce. Ukažte jeden čitelný workflow."
+    }
+  ]
+}
+```
+
+```http
+PATCH {DASHBOARD_URL}/api/workshop/instances/{instanceId}/scenes
+Content-Type: application/json
+
+{ "action": "set_default", "agendaItemId": "talk", "sceneId": "talk-participant-view" }
+```
+
+```http
+PATCH {DASHBOARD_URL}/api/workshop/instances/{instanceId}/scenes
+Content-Type: application/json
+
+{ "action": "move", "agendaItemId": "talk", "sceneId": "scene-123", "direction": "up" }
+```
+
+```http
+PATCH {DASHBOARD_URL}/api/workshop/instances/{instanceId}/scenes
+Content-Type: application/json
+
+{ "action": "set_enabled", "agendaItemId": "talk", "sceneId": "scene-123", "enabled": false }
+```
+
+```http
+DELETE {DASHBOARD_URL}/api/workshop/instances/{instanceId}/scenes
+Content-Type: application/json
+
+{ "agendaItemId": "talk", "sceneId": "scene-123" }
+```
+
+Když facilitátor chce změnit wording, flow nebo participant walkthrough přes coding agenta, preferuj tuto route místo ručního popisu změn v UI.
+
+Při práci přes API:
+
+- neznámé `agendaItemId` nebo `sceneId` vrací `404`
+- malformed payload pořád vrací `400`
+- skill má stale target ids hlásit explicitně, ne pokračovat jako by se změna povedla
+- room-facing obsah patří do `blocks`, facilitátorské guidance do `facilitatorNotes`
+- `title/body` zůstávají kvůli compatibility, ale skill má preferovat strukturované `blocks`
+- když runtime agenda existuje, skill má číst a citovat její `goal`, `roomSummary`, `facilitatorPrompts`, `watchFors`, `checkpointQuestions`, `facilitatorNotes` a `blocks`
+- když runtime data nejsou dostupná, fallbackni na repo-native blueprint/facilitation docs a explicitně to řekni
+
+### `/workshop facilitator archive`
+
+Zavolej:
+```
+POST {DASHBOARD_URL}/api/workshop/archive
+Content-Type: application/json
+
+{ "reason": "manual", "notes": "..." }
+```
+
+## Environment
+
+Agent potřebuje vědět URL dashboardu:
+- `HARNESS_DASHBOARD_URL` — URL produkčního nebo preview dashboardu
+- Pokud není nastaveno, použij `https://harness-lab-dashboard.vercel.app`
+
+## Poznámky
+
+- Facilitátorské příkazy jsou oddělené od participant příkazů
+- `/workshop facilitator login` má facilitátora navést do `harness auth login`
+- Všechny ostatní privileged příkazy používají CLI-backed uloženou session
+- Pokud session expiruje, agent řekne facilitátorovi, aby se znovu přihlásil
+- Tyto příkazy nikdy nezobrazuj participant účastníkům

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

@@ -0,0 +1,35 @@
+# Follow-up Package
+
+## 48 hodin po workshopu
+
+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
+2. Odkaz na `/workshop recap`
+3. Odkaz nebo výřez z `workshop-skill/template-agents.md`
+4. 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:
+   - [`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:
+   - `workshop resources`
+   - `workshop gallery`
+   - `workshop follow-up`
+
+## 1 týden po workshopu
+
+Krátký follow-up dotaz:
+
+- 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?
+
+## 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.

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

@@ -0,0 +1,58 @@
+# Workshop Skill Install
+
+## Doporučená distribuce
+
+Výchozí doporučení pro Harness Lab je instalace přes `@harness-lab/cli` do vašeho aktuálního pracovního repa.
+
+Proč:
+- skill je pořád repo-native obsah, ale nemá záviset na tom, že máte zrovna klon tohoto veřejného repa
+- stejné soubory slouží jako fallback i jako dokumentace
+- participant má mít funkční workshop companion přímo v týmovém repu
+
+## Doporučený participant flow
+
+1. otevřít svůj týmový nebo workshopový repo
+2. nainstalovat Harness CLI:
+
+```bash
+npm install -g @harness-lab/cli
+```
+
+3. nainstalovat workshop skill do aktuálního repa:
+
+```bash
+harness skill install
+```
+
+Volitelně můžete cílit jinam:
+
+```bash
+harness skill install --target /cesta/k/repu
+```
+
+4. otevřít agent nástroj nad tímto repem
+5. ověřit, že fungují minimálně:
+   - 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.
+
+## Co čekat dál
+
+`harness skill install` instaluje garantovaný workshop bundle. Neinstaluje za vás další workflow skills ani externí toolkity.
+
+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 participant materiály bez hledání v GitHubu, použít `workshop resources`, `workshop gallery` a `workshop follow-up`
+
+## Poznámka
+
+`harness skill install` vytvoří projektový bundle v `.agents/skills/harness-lab-workshop`, aby skill šel objevit v repu bez další distribuční vrstvy.
+Tuto složku berte jako generovaný workshop bundle, ne jako hlavní authoring surface.
+
+Participant login není potřeba pro samotnou existenci skillu. `workshop login` je až krok pro odemčení live event contextu.

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

@@ -0,0 +1,22 @@
+# Workshop Recap
+
+## 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.
+- Dobrý handoff poznáte podle toho, že nový tým začne pracovat bez ústního dovysvětlování.
+
+## 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.
+- Po větší změně zkuste udělat krátký runbook pro dalšího člověka.
+
+## 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.
+
+## 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.

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

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

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

@@ -0,0 +1,84 @@
+# Workshop Setup
+
+## Cíl
+
+Do 10:30 potřebujete jednu funkční cestu do Codexu nebo pi. Ne perfektní setup. Funkční cestu.
+
+První cíl po setupu není feature. Je to orientace:
+
+- otevřít repo
+- načíst workshop guidance
+- vytvořit krátké `AGENTS.md`
+- pojmenovat první ověřitelný krok
+
+Garantovaný default pro dnešek je `workshop` skill. Další workflow skills nebo externí toolkity jsou volitelné zrychlení, ne podmínka účasti.
+
+## Nejrychlejší volba
+
+- 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ěží
+
+## pi
+
+1. Nainstalujte `pi`:
+
+```bash
+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`.
+
+## Codex CLI
+
+1. Ověřte, že máte přístup ke svému Codex účtu.
+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ěď.
+
+## Codex App
+
+1. Nainstalujte aplikaci.
+2. Přihlaste se stejným účtem.
+3. Otevřete workshop repo nebo týmový projekt.
+4. Pošlete první prompt.
+5. Ověřte, že můžete pokračovat bez další blokace.
+
+## Když něco nefunguje
+
+- 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.
+
+## Prvních 15 minut po setupu
+
+1. Spusťte `workshop` reference:
+   - Codex: `$workshop reference`
+   - pi: `/skill:workshop`, potom si řekněte o `reference`
+   - když chcete rychlý přehled skill surface: `Codex: $workshop commands`
+2. Otevřete brief:
+   - Codex: `$workshop brief`
+   - pi: `/skill:workshop`, potom si řekněte o `brief`
+3. Doplňte krátké `AGENTS.md`:
+   - Codex: `$workshop template`
+4. Pojmenujte první safe move:
+   - 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:
+   - `Codex: $workshop resources`
+   - `Codex: $workshop gallery`
+   - `Codex: $workshop follow-up`
+
+## Hotovo když
+
+- 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í safe move v repu po setupu.