@harness-lab/cli 0.2.9 → 0.3.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +5 -0
- package/assets/workshop-bundle/SKILL.md +16 -0
- package/assets/workshop-bundle/bundle-manifest.json +46 -54
- package/assets/workshop-bundle/content/challenge-cards/deck.md +19 -17
- package/assets/workshop-bundle/content/challenge-cards/locales/en/deck.md +7 -5
- package/assets/workshop-bundle/content/challenge-cards/print-spec.md +1 -1
- package/assets/workshop-bundle/content/codex-craft.md +190 -0
- package/assets/workshop-bundle/content/facilitation/codex-setup-verification.md +5 -5
- package/assets/workshop-bundle/content/facilitation/master-guide.md +133 -66
- package/assets/workshop-bundle/content/project-briefs/code-review-helper.md +9 -9
- package/assets/workshop-bundle/content/project-briefs/devtoolbox-cli.md +11 -9
- package/assets/workshop-bundle/content/project-briefs/doc-generator.md +10 -8
- package/assets/workshop-bundle/content/project-briefs/locales/en/devtoolbox-cli.md +4 -2
- package/assets/workshop-bundle/content/project-briefs/locales/en/doc-generator.md +5 -3
- package/assets/workshop-bundle/content/project-briefs/locales/en/metrics-dashboard.md +4 -2
- package/assets/workshop-bundle/content/project-briefs/locales/en/standup-bot.md +4 -2
- package/assets/workshop-bundle/content/project-briefs/metrics-dashboard.md +14 -12
- package/assets/workshop-bundle/content/project-briefs/standup-bot.md +11 -9
- package/assets/workshop-bundle/content/talks/codex-demo-script.md +12 -10
- package/assets/workshop-bundle/content/talks/context-is-king.md +25 -25
- package/assets/workshop-bundle/docs/harness-cli-foundation.md +2 -0
- package/assets/workshop-bundle/docs/learner-resource-kit.md +37 -37
- package/assets/workshop-bundle/materials/coaching-codex.md +76 -0
- package/assets/workshop-bundle/materials/locales/en/participant-resource-kit.md +14 -2
- package/assets/workshop-bundle/materials/participant-resource-kit.md +23 -11
- package/assets/workshop-bundle/workshop-blueprint/README.md +2 -5
- package/assets/workshop-bundle/workshop-blueprint/day-structure.md +14 -0
- package/assets/workshop-bundle/workshop-skill/analyze-checklist.md +3 -3
- package/assets/workshop-bundle/workshop-skill/closing-skill.md +6 -6
- package/assets/workshop-bundle/workshop-skill/commands.md +17 -13
- package/assets/workshop-bundle/workshop-skill/facilitator.md +33 -0
- package/assets/workshop-bundle/workshop-skill/follow-up-package.md +13 -8
- package/assets/workshop-bundle/workshop-skill/install.md +8 -8
- package/assets/workshop-bundle/workshop-skill/locales/en/commands.md +4 -0
- package/assets/workshop-bundle/workshop-skill/locales/en/follow-up-package.md +8 -3
- package/assets/workshop-bundle/workshop-skill/locales/en/recap.md +8 -1
- package/assets/workshop-bundle/workshop-skill/locales/en/reference.md +20 -3
- package/assets/workshop-bundle/workshop-skill/locales/en/setup.md +1 -1
- package/assets/workshop-bundle/workshop-skill/recap.md +12 -5
- package/assets/workshop-bundle/workshop-skill/reference.md +53 -29
- package/assets/workshop-bundle/workshop-skill/setup.md +11 -11
- package/assets/workshop-bundle/workshop-skill/template-agents.md +4 -4
- package/package.json +1 -1
- package/src/client.js +9 -0
- package/src/io.js +1 -0
- package/src/run-cli.js +197 -0
- package/src/skill-install.js +108 -7
- package/src/workshop-bundle.js +30 -2
- package/assets/workshop-bundle/content/czech-editorial-review-checklist.md +0 -88
- package/assets/workshop-bundle/content/style-examples.md +0 -127
- package/assets/workshop-bundle/content/style-guide.md +0 -108
- package/assets/workshop-bundle/workshop-blueprint/edit-boundaries.md +0 -64
|
@@ -2,30 +2,32 @@
|
|
|
2
2
|
|
|
3
3
|
## Problém
|
|
4
4
|
|
|
5
|
-
Týmy často data mají, ale chybí jim obrazovka, která z
|
|
5
|
+
Týmy často data mají, ale chybí jim obrazovka, která z nich udělá rychle čitelný přehled. Bez toho se hůř rozhoduje, hůř diskutuje a každý si z čísel odnese něco jiného.
|
|
6
6
|
|
|
7
|
-
Vaším úkolem je navrhnout jednoduchý dashboard, který z
|
|
7
|
+
Vaším úkolem je navrhnout jednoduchý dashboard, který z několika metrik vytvoří srozumitelný společný pohled a zůstane čitelný i po handoffu na jiný tým.
|
|
8
8
|
|
|
9
9
|
## User stories
|
|
10
10
|
|
|
11
|
-
- Jako tým chci zobrazit několik metrik na jedné obrazovce tak, aby z
|
|
11
|
+
- Jako tým chci zobrazit několik metrik na jedné obrazovce tak, aby z nich šlo rychle vyčíst stav.
|
|
12
12
|
- Jako facilitátor chci snadno měnit seed data bez zásahu do UI logiky.
|
|
13
|
-
- Jako tým po rotaci chci během několika minut pochopit strukturu dat, komponent i
|
|
13
|
+
- Jako tým po rotaci chci během několika minut pochopit strukturu dat, komponent i obrazovek.
|
|
14
14
|
|
|
15
15
|
## Architektonické poznámky
|
|
16
16
|
|
|
17
|
-
- Seed data a
|
|
18
|
-
- Mobile-first je výhoda, ale dashboard musí být dobře čitelný i
|
|
19
|
-
- README a
|
|
20
|
-
- Myslete na to, aby přidání další metriky nevedlo k
|
|
17
|
+
- Seed data a UI oddělte hned od prvního commitu.
|
|
18
|
+
- Mobile-first je výhoda, ale dashboard musí být dobře čitelný i na projekci.
|
|
19
|
+
- README a monitoring mají vysvětlit, co už funguje, co je mock a co zatím chybí.
|
|
20
|
+
- Myslete na to, aby přidání další metriky nevedlo k přepisování celé obrazovky.
|
|
21
|
+
- Neoptimalizujte jen vzhled. Hlídejte, aby nový tým rychle pochopil datový model, layout pravidla a způsob ověření.
|
|
21
22
|
|
|
22
23
|
## Hotovo když
|
|
23
24
|
|
|
24
|
-
- Dashboard ukáže alespoň 3 metriky a
|
|
25
|
-
- Repo popisuje datové zdroje i
|
|
26
|
-
- Je jasné, kde se přidává nová metrika a
|
|
25
|
+
- Dashboard ukáže alespoň 3 metriky a jeden trend nebo srovnání.
|
|
26
|
+
- Repo popisuje datové zdroje i mock fallback.
|
|
27
|
+
- Je jasné, kde se přidává nová metrika a jak se ověřuje layout.
|
|
27
28
|
- Nový tým zvládne rozšířit dashboard bez rozbití struktury.
|
|
29
|
+
- Layout je čitelný na mobilu i na větší obrazovce a je jasné, jak to ověřit.
|
|
28
30
|
|
|
29
31
|
## První krok pro agenta
|
|
30
32
|
|
|
31
|
-
Navrhni dashboard, který zvládne handoff. Nejdřív popiš datový model, komponenty a
|
|
33
|
+
Navrhni dashboard, který zvládne handoff. Nejdřív popiš datový model, komponenty, layout pravidla a kritéria `Hotovo když`, teprve potom stav UI.
|
|
@@ -2,30 +2,32 @@
|
|
|
2
2
|
|
|
3
3
|
## Problém
|
|
4
4
|
|
|
5
|
-
Denní standupy v
|
|
5
|
+
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.
|
|
6
6
|
|
|
7
|
-
Vaším úkolem je navrhnout nástroj, který ze standup vstupů vytvoří přehled, se kterým se dá dál pracovat.
|
|
7
|
+
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.
|
|
8
8
|
|
|
9
9
|
## User stories
|
|
10
10
|
|
|
11
11
|
- Jako team lead chci sesbírat standup odpovědi do jednoho přehledného souhrnu.
|
|
12
|
-
- Jako vývojář chci rychle vidět blokery, dependency a
|
|
13
|
-
- Jako tým po rotaci chci pochopit datový tok i
|
|
12
|
+
- Jako vývojář chci rychle vidět blokery, dependency a témata, která potřebují domluvu.
|
|
13
|
+
- Jako tým po rotaci chci pochopit datový tok i integrační body bez ústního handoffu.
|
|
14
14
|
|
|
15
15
|
## Architektonické poznámky
|
|
16
16
|
|
|
17
17
|
- Upřednostněte jasný datový model před složitou integrací.
|
|
18
|
-
- Mock data jsou v
|
|
19
|
-
- Oddělte ingest, zpracování a
|
|
20
|
-
- Prompty, runbooky a
|
|
18
|
+
- Mock data jsou v pořádku, pokud workflow působí realisticky a je dobře popsané.
|
|
19
|
+
- Oddělte ingest, zpracování a prezentaci výstupu.
|
|
20
|
+
- Prompty, runbooky a rozhodnutí musí být uložené v repu, ne jen v hlavách původního týmu.
|
|
21
|
+
- Neřešte „hezký summary text“ dřív než to, jestli jsou vidět blokery, dependency a další safe move.
|
|
21
22
|
|
|
22
23
|
## Hotovo když
|
|
23
24
|
|
|
24
|
-
- Nástroj umí ingestovat seed data a
|
|
25
|
+
- Nástroj umí ingestovat seed data a vytvořit čitelný souhrn.
|
|
25
26
|
- Výstup zvýrazní blokery nebo položky, které potřebují pozornost.
|
|
26
27
|
- Repo obsahuje instrukce, jak řešení napojit na reálný chat nebo jiný vstupní kanál.
|
|
27
28
|
- Po rotaci lze navázat bez dalšího vysvětlování.
|
|
29
|
+
- Je jasné, co je jisté shrnutí a co je jen heuristika nebo návrh.
|
|
28
30
|
|
|
29
31
|
## První krok pro agenta
|
|
30
32
|
|
|
31
|
-
Rozděl práci na ingest, sumarizaci a
|
|
33
|
+
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.
|
|
@@ -2,15 +2,15 @@
|
|
|
2
2
|
|
|
3
3
|
## Cíl
|
|
4
4
|
|
|
5
|
-
Jedna příběhová ukázka, ne seznam funkcí. Publikum má během 15 minut pochopit, jak vypadá dobrý workflow s
|
|
5
|
+
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.
|
|
6
6
|
|
|
7
7
|
## Příběh
|
|
8
8
|
|
|
9
|
-
„Jsem vývojář, dostal jsem malý úkol a
|
|
9
|
+
„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.“
|
|
10
10
|
|
|
11
11
|
## Flow
|
|
12
12
|
|
|
13
|
-
1. Otevři jednoduchý repozitář nebo
|
|
13
|
+
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.
|
|
14
14
|
2. Ukaž, že bez kontextu agent rychle tápe.
|
|
15
15
|
3. Vytvoř `AGENTS.md` se 4 prvky:
|
|
16
16
|
- Goal
|
|
@@ -18,12 +18,13 @@ Jedna příběhová ukázka, ne seznam funkcí. Publikum má během 15 minut poc
|
|
|
18
18
|
- Constraints
|
|
19
19
|
- Done When
|
|
20
20
|
4. Spusť `/plan`, aby agent rozpadl práci na kroky.
|
|
21
|
-
5.
|
|
22
|
-
6.
|
|
23
|
-
7.
|
|
24
|
-
|
|
25
|
-
-
|
|
26
|
-
|
|
21
|
+
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.
|
|
22
|
+
6. Nech agenta implementovat malý kus.
|
|
23
|
+
7. Spusť `/review` a ukaž, že kontrola je součást workflow, ne nouzová brzda na konci.
|
|
24
|
+
8. Krátce ukaž workshop skill:
|
|
25
|
+
- jak se instaluje přes `harness skill install`
|
|
26
|
+
- jak z něj plyne první použitelný krok v Codexu nebo v pi
|
|
27
|
+
9. Zavři to větou:
|
|
27
28
|
- „Nástroj sám nestačí. Rozhoduje pracovní systém kolem něj.“
|
|
28
29
|
|
|
29
30
|
## Fallbacky
|
|
@@ -37,7 +38,8 @@ Jedna příběhová ukázka, ne seznam funkcí. Publikum má během 15 minut poc
|
|
|
37
38
|
- pět různých režimů práce
|
|
38
39
|
- složitou přehlídku funkcí
|
|
39
40
|
- dlouhé čekání na generování
|
|
41
|
+
- demo odtržené od repa, ve kterém právě workshop běží
|
|
40
42
|
|
|
41
43
|
## Pointa pro místnost
|
|
42
44
|
|
|
43
|
-
Nejde o
|
|
45
|
+
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.
|
|
@@ -2,25 +2,25 @@
|
|
|
2
2
|
|
|
3
3
|
## Otevírací modul
|
|
4
4
|
|
|
5
|
-
Tenhle workshop skill i
|
|
5
|
+
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.
|
|
6
6
|
|
|
7
|
-
Rámec pro
|
|
7
|
+
Rámec pro otevření dne:
|
|
8
8
|
|
|
9
|
-
- dnes nezačínáme tool demo ani soutěž v
|
|
10
|
-
- budeme se učit, stavět, předávat i
|
|
11
|
-
- odpoledne se ukáže, co z
|
|
9
|
+
- dnes nezačínáme tool demo ani soutěž v promptování
|
|
10
|
+
- budeme se učit, stavět, předávat i přebírat
|
|
11
|
+
- odpoledne se ukáže, co z práce přežije bez nás
|
|
12
12
|
|
|
13
13
|
## Klíčová linka
|
|
14
14
|
|
|
15
|
-
Harness engineering je práce s
|
|
15
|
+
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.
|
|
16
16
|
|
|
17
17
|
Moje hlavní věta pro dnešek:
|
|
18
18
|
|
|
19
|
-
> Neučíme se
|
|
19
|
+
> 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.
|
|
20
20
|
|
|
21
21
|
## Analogický beat
|
|
22
22
|
|
|
23
|
-
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
|
|
23
|
+
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.
|
|
24
24
|
|
|
25
25
|
Pointa analogie:
|
|
26
26
|
|
|
@@ -30,9 +30,9 @@ Pointa analogie:
|
|
|
30
30
|
|
|
31
31
|
## Mikro-cvičení
|
|
32
32
|
|
|
33
|
-
Tohle je krátká facilitátorova ukázka, ne práce pro
|
|
33
|
+
Tohle je krátká facilitátorova ukázka, ne práce pro celou místnost.
|
|
34
34
|
|
|
35
|
-
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
|
|
35
|
+
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.
|
|
36
36
|
|
|
37
37
|
4 prvky pro druhou variantu:
|
|
38
38
|
|
|
@@ -44,34 +44,34 @@ Vezmeme stejný malý task ve dvou podmínkách. Jedna varianta bude prompt blob
|
|
|
44
44
|
## Hlavní teze
|
|
45
45
|
|
|
46
46
|
- Kontext je páka, ne kosmetika.
|
|
47
|
-
- `AGENTS.md`, skills a
|
|
47
|
+
- `AGENTS.md`, skills a runbooky jsou týmová infrastruktura.
|
|
48
48
|
- `AGENTS.md` nemá být encyklopedie. Má to být mapa, která ukáže, kam sáhnout dál.
|
|
49
|
-
- Co není v
|
|
49
|
+
- Co není v repu, neexistuje. Slack, ústní dovysvětlení a "to si pamatujeme" se při návaznosti rozpadají.
|
|
50
50
|
- 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.
|
|
51
|
-
- Jednoduché mantinely zrychlují práci. Agentovi pomáhá jasný build/test flow, viditelné hranice a
|
|
52
|
-
- U
|
|
53
|
-
- „Nech model jezdit v
|
|
54
|
-
-
|
|
55
|
-
- Úklid není bonus po workshopu. Když narazíte na opakující se chaos, je čas ho proměnit v
|
|
56
|
-
- Odpolední návaznost prověří, jestli váš kontext funguje i
|
|
51
|
+
- Jednoduché mantinely zrychlují práci. Agentovi pomáhá jasný build/test flow, viditelné hranice a předvídatelná struktura.
|
|
52
|
+
- U UI práce je výchozí pattern: agent exploration, potom repeatable browser test, potom lidské review.
|
|
53
|
+
- „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.
|
|
54
|
+
- 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.
|
|
55
|
+
- Ú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.
|
|
56
|
+
- Odpolední návaznost prověří, jestli váš kontext funguje i bez vás.
|
|
57
57
|
|
|
58
58
|
## Co chci, aby si adoptovali
|
|
59
59
|
|
|
60
|
-
- Než začnu generovat další funkci, udělám z
|
|
60
|
+
- Než začnu generovat další funkci, udělám z repa místo, kde se dá orientovat.
|
|
61
61
|
- Když řekneme nějaké pravidlo dvakrát nahlas, patří do repa.
|
|
62
62
|
- Když agent dělá víc, já musím lépe ověřovat.
|
|
63
63
|
- Handoff není závěr dne. Je to průběžná podmínka celé práce.
|
|
64
64
|
|
|
65
|
-
##
|
|
65
|
+
## Co si odnesete do build fáze
|
|
66
66
|
|
|
67
|
-
Po tomhle talku se tým nemá vracet k
|
|
67
|
+
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:
|
|
68
68
|
|
|
69
69
|
- pokud ještě nemá workshop skill, teď je chvíle na `harness skill install`, pak `Codex: $workshop setup` nebo `pi: /skill:workshop`
|
|
70
|
-
- nejdřív krátká mapa v
|
|
71
|
-
- potom
|
|
72
|
-
- potom první explicitní
|
|
70
|
+
- nejdřív krátká mapa v repu
|
|
71
|
+
- potom krátký plán kroků
|
|
72
|
+
- potom první explicitní ověření
|
|
73
73
|
- teprve potom další feature motion
|
|
74
74
|
|
|
75
75
|
## Závěr
|
|
76
76
|
|
|
77
|
-
Odpoledne nezažijete jen to, že „AI někdy funguje a
|
|
77
|
+
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.
|
|
@@ -43,6 +43,7 @@ Required commands:
|
|
|
43
43
|
- `harness workshop status`
|
|
44
44
|
- `harness workshop list-instances`
|
|
45
45
|
- `harness workshop show-instance <instance-id>`
|
|
46
|
+
- `harness workshop participant-access [<instance-id>]`
|
|
46
47
|
- `harness workshop create-instance`
|
|
47
48
|
- `harness workshop update-instance`
|
|
48
49
|
- `harness workshop reset-instance <instance-id>`
|
|
@@ -99,6 +100,7 @@ Current command posture:
|
|
|
99
100
|
- `harness workshop list-instances`
|
|
100
101
|
- explicit target preferred but selected-instance fallback allowed:
|
|
101
102
|
- `harness workshop show-instance [<instance-id>]`
|
|
103
|
+
- `harness workshop participant-access [<instance-id>]`
|
|
102
104
|
- `harness workshop update-instance [<instance-id>]`
|
|
103
105
|
- `harness workshop reset-instance [<instance-id>]`
|
|
104
106
|
- `harness workshop prepare [<instance-id>]`
|
|
@@ -1,27 +1,27 @@
|
|
|
1
1
|
# Learner Resource Kit
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
This page defines the participant learner kit for Harness Lab.
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
It is the small, portable subset of the repo that participants should take away, review, and reuse in their own projects.
|
|
6
6
|
|
|
7
|
-
##
|
|
7
|
+
## Ground Rule
|
|
8
8
|
|
|
9
|
-
|
|
9
|
+
The learner kit is not the full workshop backstage.
|
|
10
10
|
|
|
11
|
-
|
|
12
|
-
-
|
|
13
|
-
-
|
|
14
|
-
-
|
|
15
|
-
-
|
|
11
|
+
It should answer:
|
|
12
|
+
- what should I copy into a real repo?
|
|
13
|
+
- what should the agent or team do first?
|
|
14
|
+
- how do I make the work survive handoff?
|
|
15
|
+
- what do I need to verify before I trust the result?
|
|
16
16
|
|
|
17
|
-
|
|
17
|
+
Default participant rhythm the learner kit should reinforce:
|
|
18
18
|
- `workshop` pro orientaci
|
|
19
19
|
- `brainstorm` nebo `plan` před větším řezem
|
|
20
20
|
- `work` proti jednomu ověřitelnému cíli
|
|
21
21
|
- `review` před důvěrou
|
|
22
22
|
- `compound` a průběžný úklid pro věci, které mají přežít session
|
|
23
23
|
|
|
24
|
-
##
|
|
24
|
+
## Learner Kit Core
|
|
25
25
|
|
|
26
26
|
### 1. Workshop skill
|
|
27
27
|
|
|
@@ -31,34 +31,34 @@ Hlavní rozhraní pro účastníky:
|
|
|
31
31
|
- [`workshop-skill/reference.md`](../workshop-skill/reference.md)
|
|
32
32
|
- [`workshop-skill/recap.md`](../workshop-skill/recap.md)
|
|
33
33
|
|
|
34
|
-
|
|
35
|
-
-
|
|
36
|
-
-
|
|
34
|
+
Why it belongs here:
|
|
35
|
+
- it shows how a participant skill can guide setup, workflow, and verification
|
|
36
|
+
- it is a real repo-backed interface, not only a workshop slide artifact
|
|
37
37
|
|
|
38
|
-
### 2. `AGENTS.md`
|
|
38
|
+
### 2. `AGENTS.md` example
|
|
39
39
|
|
|
40
40
|
Výchozí starter:
|
|
41
41
|
- [`workshop-skill/template-agents.md`](../workshop-skill/template-agents.md)
|
|
42
42
|
|
|
43
|
-
|
|
44
|
-
-
|
|
45
|
-
-
|
|
43
|
+
Why it belongs here:
|
|
44
|
+
- it is the smallest reusable example of durable repo context
|
|
45
|
+
- participants can adapt it directly for a real project
|
|
46
46
|
|
|
47
|
-
### 3.
|
|
47
|
+
### 3. Verification and review example
|
|
48
48
|
|
|
49
49
|
Výchozí checklist:
|
|
50
50
|
- [`workshop-skill/analyze-checklist.md`](../workshop-skill/analyze-checklist.md)
|
|
51
51
|
|
|
52
|
-
|
|
53
|
-
-
|
|
54
|
-
-
|
|
52
|
+
Why it belongs here:
|
|
53
|
+
- it gives a concrete standard for “can another team continue from here?”
|
|
54
|
+
- it turns repo quality into a checklist people can actually run
|
|
55
55
|
|
|
56
56
|
### 4. Challenge cards
|
|
57
57
|
|
|
58
58
|
Doporučený subset:
|
|
59
59
|
- [`content/challenge-cards/deck.md`](../content/challenge-cards/deck.md)
|
|
60
60
|
|
|
61
|
-
|
|
61
|
+
Use:
|
|
62
62
|
- malé zásahy během workshopu
|
|
63
63
|
- nápověda, co zlepšit později v reálném repu
|
|
64
64
|
|
|
@@ -68,31 +68,31 @@ Posílení po workshopu:
|
|
|
68
68
|
- [`workshop-skill/follow-up-package.md`](../workshop-skill/follow-up-package.md)
|
|
69
69
|
- [`materials/participant-resource-kit.md`](../materials/participant-resource-kit.md)
|
|
70
70
|
|
|
71
|
-
|
|
72
|
-
-
|
|
73
|
-
-
|
|
71
|
+
Why it belongs here:
|
|
72
|
+
- it turns the workshop from a one-day event into a repeatable behaviour change
|
|
73
|
+
- it gives a literal handout that can be sent or printed without extra explanation
|
|
74
74
|
|
|
75
|
-
##
|
|
75
|
+
## When To Use Which Artifact
|
|
76
76
|
|
|
77
|
-
###
|
|
77
|
+
### During setup
|
|
78
78
|
|
|
79
79
|
Použijte:
|
|
80
80
|
- [`workshop-skill/setup.md`](../workshop-skill/setup.md)
|
|
81
81
|
- [`workshop-skill/reference.md`](../workshop-skill/reference.md)
|
|
82
82
|
|
|
83
|
-
###
|
|
83
|
+
### During Build Phase 1
|
|
84
84
|
|
|
85
85
|
Použijte:
|
|
86
86
|
- [`workshop-skill/template-agents.md`](../workshop-skill/template-agents.md)
|
|
87
|
-
- karty `
|
|
87
|
+
- karty `Před obědem: postavte pracovní systém` v [`content/challenge-cards/deck.md`](../content/challenge-cards/deck.md)
|
|
88
88
|
|
|
89
|
-
###
|
|
89
|
+
### During the afternoon takeover
|
|
90
90
|
|
|
91
91
|
Použijte:
|
|
92
92
|
- [`workshop-skill/analyze-checklist.md`](../workshop-skill/analyze-checklist.md)
|
|
93
|
-
- karty `
|
|
93
|
+
- karty `Po rotaci: opravte signál, ne jen feature` v [`content/challenge-cards/deck.md`](../content/challenge-cards/deck.md)
|
|
94
94
|
|
|
95
|
-
###
|
|
95
|
+
### After the workshop
|
|
96
96
|
|
|
97
97
|
Použijte:
|
|
98
98
|
- [`workshop-skill/recap.md`](../workshop-skill/recap.md)
|
|
@@ -100,9 +100,9 @@ Použijte:
|
|
|
100
100
|
- [`materials/participant-resource-kit.md`](../materials/participant-resource-kit.md)
|
|
101
101
|
- [`learner-reference-gallery.md`](learner-reference-gallery.md)
|
|
102
102
|
|
|
103
|
-
##
|
|
103
|
+
## What To Carry Into A Real Project
|
|
104
104
|
|
|
105
|
-
|
|
105
|
+
Participants should leave with these concrete moves:
|
|
106
106
|
|
|
107
107
|
1. Přidejte `AGENTS.md` s částmi:
|
|
108
108
|
- goal
|
|
@@ -117,9 +117,9 @@ Použijte:
|
|
|
117
117
|
7. Před větší implementací použijte plan a po větší změně review nebo check.
|
|
118
118
|
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í.
|
|
119
119
|
|
|
120
|
-
##
|
|
120
|
+
## What Does Not Belong Here
|
|
121
121
|
|
|
122
|
-
|
|
122
|
+
The learner kit should not include full backstage operational detail, for example:
|
|
123
123
|
- runbooky pro konkrétní workshop instance
|
|
124
124
|
- privátní runtime architekturu a operace
|
|
125
125
|
- monitoring nebo řídicí postupy jen pro facilitátory
|
|
@@ -0,0 +1,76 @@
|
|
|
1
|
+
# Coaching Codex — the pocket card
|
|
2
|
+
|
|
3
|
+
> One page. Steal the moves. Print it if you want.
|
|
4
|
+
|
|
5
|
+
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.
|
|
6
|
+
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
## Before you let the agent write code
|
|
10
|
+
|
|
11
|
+
Ask these, in this order. Do not skip ahead.
|
|
12
|
+
|
|
13
|
+
1. **"Before you implement, read [file X] and state the three patterns you're going to reuse."**
|
|
14
|
+
Catches misreading in 30 seconds. Costs nothing.
|
|
15
|
+
|
|
16
|
+
2. **"What's the smallest change that could prove this approach works?"**
|
|
17
|
+
Forces a tracer bullet instead of a spec rewrite. The answer is often "one function plus one test."
|
|
18
|
+
|
|
19
|
+
3. **"What's the done criteria — a command I can run or a file I can look at — that tells us this is finished?"**
|
|
20
|
+
If the agent can't name one, neither of you knows what "done" means. Stop.
|
|
21
|
+
|
|
22
|
+
4. **"What could go wrong? Name one failure mode I haven't told you about."**
|
|
23
|
+
This is the single best drift detector. If the agent says "nothing", treat that as a yellow flag and push back.
|
|
24
|
+
|
|
25
|
+
5. **"Show me the plan as three steps. Not the code. The plan."**
|
|
26
|
+
Cheap to redirect a plan. Expensive to redirect 300 lines of code.
|
|
27
|
+
|
|
28
|
+
---
|
|
29
|
+
|
|
30
|
+
## While the agent is working
|
|
31
|
+
|
|
32
|
+
- **If it starts implementing before answering the five questions above, stop it.** The session is drifting. Go back to the plan.
|
|
33
|
+
- **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.
|
|
34
|
+
- **If it adds a file you didn't ask for, ask "why this file?" before accepting.** Extra files are the first sign of improvisation.
|
|
35
|
+
- **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.
|
|
36
|
+
|
|
37
|
+
---
|
|
38
|
+
|
|
39
|
+
## When the agent says it's done
|
|
40
|
+
|
|
41
|
+
Run this short script, always:
|
|
42
|
+
|
|
43
|
+
1. **"Show me the diff."** Read it. If you don't want to read it, the agent isn't done — you are.
|
|
44
|
+
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.
|
|
45
|
+
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.
|
|
46
|
+
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.
|
|
47
|
+
|
|
48
|
+
---
|
|
49
|
+
|
|
50
|
+
## When you disagree with the agent
|
|
51
|
+
|
|
52
|
+
- **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.
|
|
53
|
+
- **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.
|
|
54
|
+
- **Ask: "Which file in the repo should have prevented this?"** The answer is usually a doc that doesn't exist yet. Create it.
|
|
55
|
+
|
|
56
|
+
---
|
|
57
|
+
|
|
58
|
+
## The three questions that reset a stuck session
|
|
59
|
+
|
|
60
|
+
When you feel the session going sideways, stop and ask these out loud, to yourself first:
|
|
61
|
+
|
|
62
|
+
1. **What are we trying to prove right now?**
|
|
63
|
+
2. **Which repo artifact is missing that would have prevented this?**
|
|
64
|
+
3. **What is the smallest check that returns this work from confidence back to reality?**
|
|
65
|
+
|
|
66
|
+
If you can't answer any of the three, the session is done. Close it. Come back when you can.
|
|
67
|
+
|
|
68
|
+
---
|
|
69
|
+
|
|
70
|
+
## The one rule to remember
|
|
71
|
+
|
|
72
|
+
**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.
|
|
73
|
+
|
|
74
|
+
---
|
|
75
|
+
|
|
76
|
+
*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).*
|
|
@@ -17,8 +17,7 @@ Default template:
|
|
|
17
17
|
|
|
18
18
|
Choose at least one:
|
|
19
19
|
- build/test commands
|
|
20
|
-
-
|
|
21
|
-
- a tracer bullet
|
|
20
|
+
- an executable check (unit test or tracer bullet)
|
|
22
21
|
- a review checklist
|
|
23
22
|
|
|
24
23
|
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
|
|
|
60
59
|
- [`workshop-skill/locales/en/reference.md`](../../../workshop-skill/locales/en/reference.md)
|
|
61
60
|
- [`workshop-skill/locales/en/recap.md`](../../../workshop-skill/locales/en/recap.md)
|
|
62
61
|
- [`docs/locales/en/learner-reference-gallery.md`](../../../docs/locales/en/learner-reference-gallery.md)
|
|
62
|
+
- [`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
|
|
63
|
+
- [`materials/coaching-codex.md`](../../coaching-codex.md) — the one-page pocket card of conversational moves for coaching an agent
|
|
63
64
|
|
|
64
65
|
Note:
|
|
65
66
|
- the `workshop` skill is the guaranteed workshop default
|
|
@@ -70,3 +71,14 @@ Note:
|
|
|
70
71
|
1. Add `AGENTS.md` to one real project.
|
|
71
72
|
2. Move one durable rule from a prompt into the repo.
|
|
72
73
|
3. Add one review or handoff checklist.
|
|
74
|
+
|
|
75
|
+
## What to read after the workshop to stay current
|
|
76
|
+
|
|
77
|
+
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.
|
|
78
|
+
|
|
79
|
+
- **Codex CLI release notes** — read them on every release. The approval-mode and sandboxing changes are the ones that matter most.
|
|
80
|
+
- **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.
|
|
81
|
+
- **OpenAI Harness Engineering articles** — see `docs/learner-reference-gallery.md` for links.
|
|
82
|
+
- **Anthropic engineering blog** — if you use Claude Code, follow the official posts.
|
|
83
|
+
- **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.
|
|
84
|
+
- **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.
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Participant Resource Kit
|
|
2
2
|
|
|
3
|
-
Krátká sada artefaktů, které si můžete odnést z
|
|
3
|
+
Krátká sada artefaktů, které si můžete odnést z Harness Lab do vlastního projektu.
|
|
4
4
|
|
|
5
5
|
## 1. Začněte `AGENTS.md`
|
|
6
6
|
|
|
@@ -17,8 +17,7 @@ Výchozí šablona:
|
|
|
17
17
|
|
|
18
18
|
Vyberte si alespoň jeden:
|
|
19
19
|
- build/test příkazy
|
|
20
|
-
-
|
|
21
|
-
- tracer bullet
|
|
20
|
+
- spustitelné ověření (unit test nebo tracer bullet)
|
|
22
21
|
- review checklist
|
|
23
22
|
|
|
24
23
|
Když agent dělá větší kus práce, nestačí „rychle jsem to projel očima“.
|
|
@@ -29,16 +28,16 @@ Checklist pro handoff:
|
|
|
29
28
|
## 3. Používejte malý workflow, ne chaos
|
|
30
29
|
|
|
31
30
|
Doporučený základ:
|
|
32
|
-
- `workshop` pro orientaci a
|
|
31
|
+
- `workshop` pro orientaci a další bezpečný krok
|
|
33
32
|
- `/brainstorm`, když ještě není jasný scope nebo první slice
|
|
34
33
|
- `/plan` před větší implementací
|
|
35
34
|
- `/work` nebo jiný úzký implementační loop, když už víte co stavíte
|
|
36
|
-
- test nebo
|
|
35
|
+
- test nebo jiné spustitelné ověření před důležitou změnou
|
|
37
36
|
- `/review` po větším kusu práce
|
|
38
|
-
- `/compound` nebo krátká poznámka zapsaná přímo v
|
|
39
|
-
- průběžný úklid: build/test příkazy, omezení a
|
|
37
|
+
- `/compound` nebo krátká poznámka zapsaná přímo v repu, když objev udělá další práci levnější
|
|
38
|
+
- průběžný úklid: build/test příkazy, omezení a handoff poznámky přesouvejte z chatu do repa
|
|
40
39
|
|
|
41
|
-
## 4. Přesuňte jedno pravidlo z
|
|
40
|
+
## 4. Přesuňte jedno pravidlo z chatu do repa
|
|
42
41
|
|
|
43
42
|
Typické kandidáty:
|
|
44
43
|
- build/test příkazy
|
|
@@ -53,20 +52,33 @@ Výchozí pattern:
|
|
|
53
52
|
- `Playwright regression`
|
|
54
53
|
- `human review`
|
|
55
54
|
|
|
56
|
-
Nenechávejte model jako výchozí volbu ovládat váš běžný přihlášený browser bez sandboxu a
|
|
55
|
+
Nenechávejte model jako výchozí volbu ovládat váš běžný přihlášený browser bez sandboxu a kontroly.
|
|
57
56
|
|
|
58
57
|
## 6. Co si projít po workshopu
|
|
59
58
|
|
|
60
59
|
- [`workshop-skill/reference.md`](../workshop-skill/reference.md)
|
|
61
60
|
- [`workshop-skill/recap.md`](../workshop-skill/recap.md)
|
|
62
61
|
- [`docs/learner-reference-gallery.md`](../docs/learner-reference-gallery.md)
|
|
62
|
+
- [`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)
|
|
63
|
+
- [`materials/coaching-codex.md`](coaching-codex.md) — jednostránkový pocket card konverzačních tahů pro coaching agenta
|
|
63
64
|
|
|
64
65
|
Poznámka:
|
|
65
66
|
- `workshop` skill je garantovaný výchozí nástroj workshopu
|
|
66
|
-
- další workflow skills a
|
|
67
|
+
- další workflow skills a veřejné toolkity berte jako volitelné akcelerátory, ne povinný setup
|
|
67
68
|
|
|
68
69
|
## Výzva na příští týden
|
|
69
70
|
|
|
70
71
|
1. Přidejte `AGENTS.md` do jednoho reálného projektu.
|
|
71
|
-
2. Přesuňte jedno trvalé pravidlo z
|
|
72
|
+
2. Přesuňte jedno trvalé pravidlo z promptu do repa.
|
|
72
73
|
3. Přidejte jeden review nebo handoff checklist.
|
|
74
|
+
|
|
75
|
+
## Co číst po workshopu, abyste zůstali aktuální
|
|
76
|
+
|
|
77
|
+
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.
|
|
78
|
+
|
|
79
|
+
- **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ší.
|
|
80
|
+
- **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.
|
|
81
|
+
- **OpenAI Harness Engineering articles** — viz `docs/learner-reference-gallery.md` pro odkazy.
|
|
82
|
+
- **Anthropic engineering blog** — když pracujete s Claude Code, sledujte oficiální posts.
|
|
83
|
+
- **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.
|
|
84
|
+
- **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.
|
|
@@ -18,8 +18,7 @@ Do not use this folder for live event state. Real dates, rooms, rosters, checkpo
|
|
|
18
18
|
2. [`teaching-spine.md`](teaching-spine.md)
|
|
19
19
|
3. [`operator-guide.md`](operator-guide.md)
|
|
20
20
|
4. [`control-surfaces.md`](control-surfaces.md)
|
|
21
|
-
5. [`
|
|
22
|
-
6. [`agenda.json`](agenda.json)
|
|
21
|
+
5. [`agenda.json`](agenda.json)
|
|
23
22
|
|
|
24
23
|
## Blueprint Contents
|
|
25
24
|
|
|
@@ -33,8 +32,6 @@ Do not use this folder for live event state. Real dates, rooms, rosters, checkpo
|
|
|
33
32
|
Explains how a facilitator prepares, runs, and closes a workshop.
|
|
34
33
|
- [`control-surfaces.md`](control-surfaces.md)
|
|
35
34
|
Defines participant surface, facilitator dashboard, facilitator skill, and the `harness` CLI as equal clients of one runtime model.
|
|
36
|
-
- [`edit-boundaries.md`](edit-boundaries.md)
|
|
37
|
-
Explains what changes in the public repo, what changes only in runtime, and how learnings are published back deliberately.
|
|
38
35
|
|
|
39
36
|
### Structured data
|
|
40
37
|
|
|
@@ -45,7 +42,7 @@ Do not use this folder for live event state. Real dates, rooms, rosters, checkpo
|
|
|
45
42
|
|
|
46
43
|
- [`harness-cli-foundation.md`](../docs/harness-cli-foundation.md)
|
|
47
44
|
|
|
48
|
-
The deeper runtime and maintainer docs such as blueprint import, publish-back flow,
|
|
45
|
+
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.
|
|
49
46
|
|
|
50
47
|
For maintainers working in the source repository, the runtime-facing structured agenda sources are:
|
|
51
48
|
|