@harness-lab/cli 0.3.2 → 0.4.0

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.
Files changed (27) hide show
  1. package/README.md +11 -1
  2. package/assets/workshop-bundle/SKILL.md +6 -146
  3. package/assets/workshop-bundle/bundle-manifest.json +40 -20
  4. package/assets/workshop-bundle/content/challenge-cards/deck.md +43 -23
  5. package/assets/workshop-bundle/content/challenge-cards/locales/en/deck.md +40 -20
  6. package/assets/workshop-bundle/content/facilitation/locales/en/codex-setup-verification.md +7 -0
  7. package/assets/workshop-bundle/content/facilitation/locales/en/master-guide.md +7 -0
  8. package/assets/workshop-bundle/content/talks/context-is-king.md +32 -36
  9. package/assets/workshop-bundle/content/talks/locales/en/codex-demo-script.md +7 -0
  10. package/assets/workshop-bundle/content/talks/locales/en/context-is-king.md +7 -0
  11. package/assets/workshop-bundle/materials/coaching-codex.md +15 -12
  12. package/assets/workshop-bundle/materials/participant-resource-kit.md +24 -0
  13. package/assets/workshop-bundle/workshop-blueprint/README.md +4 -5
  14. package/assets/workshop-bundle/workshop-blueprint/agenda.json +20 -20
  15. package/assets/workshop-bundle/workshop-blueprint/day-structure.md +4 -2
  16. package/assets/workshop-bundle/workshop-blueprint/operator-guide.md +18 -0
  17. package/assets/workshop-bundle/workshop-blueprint/teaching-spine.md +31 -0
  18. package/assets/workshop-bundle/workshop-skill/SKILL-facilitator.md +191 -0
  19. package/assets/workshop-bundle/workshop-skill/analyze-checklist.md +1 -0
  20. package/assets/workshop-bundle/workshop-skill/commands.md +0 -4
  21. package/assets/workshop-bundle/workshop-skill/follow-up-package.md +29 -36
  22. package/assets/workshop-bundle/workshop-skill/locales/en/commands.md +0 -4
  23. package/assets/workshop-bundle/workshop-skill/locales/en/follow-up-package.md +29 -36
  24. package/assets/workshop-bundle/workshop-skill/locales/en/reference.md +1 -0
  25. package/assets/workshop-bundle/workshop-skill/reference.md +1 -0
  26. package/package.json +1 -1
  27. package/src/run-cli.js +23 -0
@@ -1,26 +1,31 @@
1
1
  # Context is King
2
2
 
3
- ## Otevírací modul
3
+ ## Mikro-cvičení
4
4
 
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.
5
+ Tohle je krátká facilitátorova ukázka, ne práce pro celou místnost.
6
6
 
7
- Rámec pro otevření dne:
7
+ 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.
8
8
 
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
9
+ 4 prvky pro druhou variantu:
12
10
 
13
- ## Klíčová linka
11
+ - Goal
12
+ - Context
13
+ - Constraints
14
+ - Done When
15
+
16
+ ## Co jste právě viděli
14
17
 
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.
18
+ 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.
16
19
 
17
- Moje hlavní věta pro dnešek:
20
+ Rámec pro dnešek:
18
21
 
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.
22
+ - dnes nezačínáme tool demo ani soutěž v promptování
23
+ - budeme se učit, stavět, předávat i přebírat
24
+ - odpoledne se ukáže, co z práce přežije bez nás
20
25
 
21
26
  ## Analogický beat
22
27
 
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.
28
+ 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
29
 
25
30
  Pointa analogie:
26
31
 
@@ -28,58 +33,49 @@ Pointa analogie:
28
33
  - kvalitu neurčuje samotný model
29
34
  - pracovní systém kolem agenta je součást výsledku
30
35
 
31
- ## Mikro-cvičení
32
-
33
- Tohle je krátká facilitátorova ukázka, ne práce pro celou místnost.
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 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
-
37
- 4 prvky pro druhou variantu:
38
-
39
- - Goal
40
- - Context
41
- - Constraints
42
- - Done When
36
+ 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.
43
37
 
44
38
  ## Hlavní teze
45
39
 
46
40
  ### Kontext je páka
47
41
 
48
42
  - Kontext je páka, ne kosmetika.
49
- - `AGENTS.md`, skills a runbooky jsou týmová infrastruktura.
43
+ - `AGENTS.md`, skills a runbooky jsou týmová infrastruktura.
50
44
  - `AGENTS.md` nemá být encyklopedie. Má to být mapa, která ukáže, kam sáhnout dál.
51
- - Co není v repu, neexistuje. Slack, ústní dovysvětlení a „to si pamatujeme" se rozpadne, jakmile práci někdo převezme.
45
+ - Co není v repu, neexistuje. Slack, ústní dovysvětlení a „to si pamatujeme" se rozpadne, jakmile práci někdo převezme.
52
46
 
53
47
  ### Ověření je hranice důvěry
54
48
 
55
49
  - 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.
56
- - Jednoduché mantinely zrychlují práci. Agentovi pomáhá jasný build/test flow, viditelné hranice a předvídatelná struktura.
57
- - U UI práce je výchozí pattern: agent exploration, potom repeatable browser test, potom lidské review.
58
- - „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.
59
- - Ověření napsané dřív, než pustíte agenta do většího kusu práce, není test-first dogma. Znamená to zapsat done criteria v takové formě, aby je agent i další tým uměl zkontrolovat. Iteraci to zrychluje, protože agent dostane přesné mantinely, ne další prompt.
50
+ - Jednoduché mantinely zrychlují práci. Agentovi pomáhá jasný build/test flow, viditelné hranice a předvídatelná struktura.
51
+ - U UI práce je výchozí pattern: agent exploration, potom repeatable browser test, potom lidské review.
52
+ - „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.
53
+ - Ověření napsané dřív, než pustíte agenta do většího kusu práce, není test-first dogma. Znamená to zapsat done criteria v takové formě, aby je agent i další tým uměl zkontrolovat. Iteraci to zrychluje, protože agent dostane přesné mantinely, ne další prompt.
60
54
 
61
55
  ### Repo se udržuje, ne jen plní
62
56
 
63
- - Ú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.
64
- - Odpolední návaznost prověří, jestli váš kontext funguje i bez vás.
57
+ - Ú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.
58
+ - Odpolední návaznost prověří, jestli váš kontext funguje i bez vás.
65
59
 
66
60
  ## Co chci, aby si adoptovali
67
61
 
68
- - Než začnu generovat další funkci, udělám z repa místo, kde se dá orientovat.
62
+ - Než začnu generovat další funkci, udělám z repa místo, kde se dá orientovat.
69
63
  - Když řekneme nějaké pravidlo dvakrát nahlas, patří do repa.
70
64
  - Když agent dělá víc, já musím lépe ověřovat.
71
65
  - Handoff není závěr dne. Je to průběžná podmínka celé práce.
72
66
 
73
67
  ## Co si odnesete do build fáze
74
68
 
75
- 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:
69
+ 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:
76
70
 
77
71
  - pokud ještě nemá workshop skill, teď je chvíle na `harness skill install`, pak `Codex: $workshop setup` nebo `pi: /skill:workshop`
78
- - nejdřív krátká mapa v repu
72
+ - nejdřív krátká mapa v repu
79
73
  - potom krátký plán kroků
80
74
  - potom první explicitní ověření, že agent dělá, co jste čekali
81
75
  - teprve potom další feature motion
82
76
 
83
- ## Závěr
77
+ ## Klíčová linka
78
+
79
+ > 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.
84
80
 
85
- 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.
81
+ 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.
@@ -0,0 +1,7 @@
1
+ ---
2
+ cs_reviewed: true
3
+ ---
4
+
5
+ # Codex Demo Script
6
+
7
+ > English stub. Full translation pending. See the Czech source at `content/talks/codex-demo-script.md`.
@@ -0,0 +1,7 @@
1
+ ---
2
+ cs_reviewed: true
3
+ ---
4
+
5
+ # Context is King
6
+
7
+ > English stub. Full translation pending. See the Czech source at `content/talks/context-is-king.md`.
@@ -6,6 +6,20 @@ The workshop teaches that context, not prompts, is what makes agent work survive
6
6
 
7
7
  ---
8
8
 
9
+ ## The meta-skill: three questions that reset anything
10
+
11
+ These three questions work in any situation — before code, during work, when stuck, when you disagree. The protocols below are specific applications.
12
+
13
+ When you feel the session going sideways, stop and ask these out loud, to yourself first:
14
+
15
+ 1. **What are we trying to prove right now?**
16
+ 2. **Which repo artifact is missing that would have prevented this?**
17
+ 3. **What is the smallest check that returns this work from confidence back to reality?**
18
+
19
+ If you can't answer any of the three, the session is done. Close it. Come back when you can.
20
+
21
+ ---
22
+
9
23
  ## Before you let the agent write code
10
24
 
11
25
  Ask these, in this order. Do not skip ahead.
@@ -44,6 +58,7 @@ Run this short script, always:
44
58
  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
59
  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
60
  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.
61
+ 5. **Write a session-state note.** What was proved, what's in progress, what's the next safe action. This is not AGENTS.md (that's the map). This is the progress log.
47
62
 
48
63
  ---
49
64
 
@@ -55,18 +70,6 @@ Run this short script, always:
55
70
 
56
71
  ---
57
72
 
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
73
  ## The one rule to remember
71
74
 
72
75
  **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.
@@ -66,12 +66,36 @@ Poznámka:
66
66
  - `workshop` skill je garantovaný výchozí nástroj workshopu
67
67
  - další workflow skills a veřejné toolkity berte jako volitelné akcelerátory, ne povinný setup
68
68
 
69
+ ## Kdy se návyky spustí
70
+
71
+ Každý z pěti pracovních návyků má svůj spouštěč — moment ve vašem běžném pracovním týdnu, kdy se návyk aktivuje:
72
+
73
+ - Když **otevíráte nový repo, nový úkol nebo novou agent session** → Map before motion (udělám z repa mapu, než začnu generovat)
74
+ - Když **zavíráte chat, končíte hovor nebo pairing kde padlo rozhodnutí** → If it is not in the repo, it does not exist (zapíšu rozhodnutí do repa)
75
+ - Když **cítím dost jistoty na to, abych šel dál** → Verification is the trust boundary (ta jistota je spouštěč k ověření, ne k přeskočení)
76
+ - Když **chystám úkol pro agenta** → Boundaries create speed (napíšu omezení dřív než prompt)
77
+ - Když **se stejná připomínka, třecí plocha nebo ruční krok objeví podruhé** → Cleanup is part of build (proměním to v check, template nebo pravidlo)
78
+ - Když **se stejný problém opakuje** → Fix the system, not just the symptom (neopravím výstup — opravím systém)
79
+
69
80
  ## Výzva na příští týden
70
81
 
71
82
  1. Přidejte `AGENTS.md` do jednoho reálného projektu.
72
83
  2. Přesuňte jedno trvalé pravidlo z promptu do repa.
73
84
  3. Přidejte jeden review nebo handoff checklist.
74
85
 
86
+ ## Minimum viable harness pro váš tým
87
+
88
+ Nemusíte tým přesvědčovat o „harness engineeringu." Stačí ukázat užitečný `AGENTS.md`, který ušetřil 20 minut onboardingu.
89
+
90
+ Nejmenší verze, která přežije skeptické code review:
91
+
92
+ 1. **Jeden `AGENTS.md`** — goal, build/test příkazy, jedno explicitní omezení. Nic víc.
93
+ 2. **Jeden spustitelný check** — unit test, tracer bullet, nebo jednoduchý smoke test.
94
+
95
+ Když se někdo zeptá „proč to děláme?", odpověď je: „Aby se další člověk nemusel ptát tebe."
96
+
97
+ Měsíční rytmus: každý měsíc si přečtěte svůj `AGENTS.md` skeptickým okem. Smažte, co už není nosné. Přidejte, co tým říká nahlas podruhé.
98
+
75
99
  ## Co číst po workshopu, abyste zůstali aktuální
76
100
 
77
101
  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.
@@ -44,10 +44,9 @@ Do not use this folder for live event state. Real dates, rooms, rosters, checkpo
44
44
 
45
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.
46
46
 
47
- For maintainers working in the source repository, the runtime-facing structured agenda sources are:
47
+ For maintainers working in the source repository, the canonical bilingual content source is:
48
48
 
49
- - `docs/workshop-content-language-architecture.md`
50
- - `dashboard/lib/workshop-blueprint-agenda.json`
51
- - `dashboard/lib/workshop-blueprint-localized-content.ts`
49
+ - `workshop-content/agenda.json` — single bilingual source (en/cs per node)
50
+ - `docs/workshop-content-language-architecture.md` — architecture doc
52
51
 
53
- Treat those as maintainer/source-repo references, not as portable participant-bundle docs. The public `agenda.json` file should stay aligned with the same phase structure, but it is not the runtime import source.
52
+ The public `agenda.json` in this directory and the dashboard runtime views (`dashboard/lib/generated/agenda-cs.json`, `agenda-en.json`) are generated from the bilingual source. Do not edit them by hand run `npm run generate:content` instead.
@@ -4,7 +4,7 @@
4
4
  "title": "Harness Lab",
5
5
  "subtitle": "Public-readable 10-phase mirror of the Harness Lab workshop day",
6
6
  "presentationMode": "public-readable-mirror",
7
- "sourceNote": "Runtime imports come from dashboard/lib/workshop-blueprint-agenda.json plus dashboard/lib/workshop-blueprint-localized-content.ts.",
7
+ "sourceNote": "Generated from workshop-content/agenda.json. Do not edit by hand.",
8
8
  "principles": [
9
9
  "Context before generation",
10
10
  "Verification is the trust boundary",
@@ -14,10 +14,10 @@
14
14
  {
15
15
  "id": "opening",
16
16
  "order": 1,
17
- "label": "Opening and framing",
17
+ "label": "Opening and orientation",
18
18
  "startTime": "09:10",
19
19
  "kind": "shared",
20
- "goal": "Shift the room from prompt-hackathon expectations to continuation-quality discipline."
20
+ "goal": "Open the day as a shared start: why harness engineering matters right now, what the room will do from the first beat to the reveal, and how we will know the work can stand without improvised rescue."
21
21
  },
22
22
  {
23
23
  "id": "talk",
@@ -25,63 +25,63 @@
25
25
  "label": "Context is King",
26
26
  "startTime": "09:40",
27
27
  "kind": "shared",
28
- "goal": "Turn context into a precise thesis: AGENTS.md, plans, and checks are working infrastructure, not polish."
28
+ "goal": "Turn the opening energy into a precise thesis: harness engineering is team infrastructure for working with agents, and the first build move must begin with map, boundaries, and proof rather than another prompt."
29
29
  },
30
30
  {
31
31
  "id": "demo",
32
32
  "order": 3,
33
- "label": "Demo",
33
+ "label": "Codex demo",
34
34
  "startTime": "10:05",
35
35
  "kind": "shared",
36
- "goal": "Show one compact workflow story: context, planning, implementation, review, and safe fallback moves."
36
+ "goal": "Use one compact story to show a real working line: context, bounded next steps, implementation, change control, and explicit fallback moves when something goes wrong."
37
37
  },
38
38
  {
39
39
  "id": "build-1",
40
40
  "order": 4,
41
- "label": "Build Phase 1",
41
+ "label": "Build fáze 1",
42
42
  "startTime": "10:30",
43
43
  "kind": "team",
44
- "goal": "Before lunch, get every team to a navigable repo, AGENTS.md, a plan, one explicit check, and a first reviewed slice."
44
+ "goal": "Get every table to a real before-lunch baseline: a navigable repo, AGENTS.md, a plan, one explicit check, and a first reviewed slice of work."
45
45
  },
46
46
  {
47
47
  "id": "intermezzo-1",
48
48
  "order": 5,
49
49
  "label": "Intermezzo 1",
50
- "startTime": "11:40",
50
+ "startTime": "11:35",
51
51
  "kind": "shared",
52
- "goal": "Surface one change, one proof, and one next move from the room before lunch momentum slips."
52
+ "goal": "Make the first round of learning visible across the room and reconnect teams to the discipline behind the output, not only to the output itself."
53
53
  },
54
54
  {
55
55
  "id": "lunch-reset",
56
56
  "order": 6,
57
- "label": "Lunch Reset",
57
+ "label": "Lunch and handoff prep",
58
58
  "startTime": "12:15",
59
59
  "kind": "shared",
60
- "goal": "Frame lunch as a handoff preparation point, not as a pause between unrelated workshop blocks."
60
+ "goal": "Interrupt the momentum before the afternoon shift and force teams to leave behind a repo another group can actually read."
61
61
  },
62
62
  {
63
63
  "id": "rotation",
64
64
  "order": 7,
65
- "label": "Continuation Shift",
65
+ "label": "Team rotation",
66
66
  "startTime": "13:30",
67
67
  "kind": "team",
68
- "goal": "Force silent repo reading, diagnosis, and explicit continuation before anyone edits code."
68
+ "goal": "Force a quiet start after rotation and let repo quality reveal what is genuinely legible."
69
69
  },
70
70
  {
71
71
  "id": "build-2",
72
72
  "order": 8,
73
- "label": "Build Phase 2",
74
- "startTime": "14:05",
73
+ "label": "Build fáze 2",
74
+ "startTime": "13:45",
75
75
  "kind": "team",
76
- "goal": "Turn continuation friction into better repo guidance, stronger checks, and clearer next moves."
76
+ "goal": "Continue from repo-native signals only, then turn the friction of the handoff into stronger maps, stronger checks, and stronger continuation guidance."
77
77
  },
78
78
  {
79
79
  "id": "intermezzo-2",
80
80
  "order": 9,
81
81
  "label": "Intermezzo 2",
82
- "startTime": "15:05",
82
+ "startTime": "14:45",
83
83
  "kind": "shared",
84
- "goal": "Name which repo signals actually saved time during continuation and which failures repeated."
84
+ "goal": "Capture what truly helped after rotation and what is emerging as a weak point in the room’s current way of working."
85
85
  },
86
86
  {
87
87
  "id": "reveal",
@@ -89,7 +89,7 @@
89
89
  "label": "Reveal and reflection",
90
90
  "startTime": "15:45",
91
91
  "kind": "shared",
92
- "goal": "Turn the day into reusable practice: what helped continuation, what failed, and what should change next week."
92
+ "goal": "Close the day by naming the signals that helped work survive handoff and by turning them into next practice, not just a pleasant ending."
93
93
  }
94
94
  ],
95
95
  "runtimeImport": {
@@ -130,15 +130,17 @@ The day should not feel like separate agenda cards. Each phase should change wha
130
130
  - `build-1`:
131
131
  Shift teams from listening to evidence. Before lunch, the repo needs to show map, plan, one executable check, and one verified step.
132
132
  - `intermezzo-1`:
133
- Shift from isolated table work to shared learning. The room should hear concrete repo signals, not generic progress reporting.
133
+ Shift from isolated table work to shared learning. The room should hear concrete repo signals, not generic progress reporting. Open with a 3-minute silent written exercise using the retrieval prompt before any team reports aloud.
134
134
  - `lunch-reset`:
135
135
  Shift from local progress to handoff readiness. Going to lunch without a readable next safe step should feel unfinished.
136
+ - `pre-rotation handoff gate`:
137
+ Before rotation begins, the facilitator checks that each team's repo meets the minimum: (1) a readable AGENTS.md with goal + build/test commands + one explicit constraint, (2) one executable verification step with a passing result, (3) a written "next safe step" in the repo. If a team does not meet these, the facilitator intervenes directly — not to punish, but to help them write the minimum before the handoff. The gate ensures that every receiving team gets a signal worth diagnosing rather than chaos to decode.
136
138
  - `rotation`:
137
139
  Shift from authorship to inheritance. The receiving team must read first, diagnose second, and edit only after it can explain the state.
138
140
  - `build-2`:
139
141
  Shift from frustration to codification. Weak continuation signals should turn into clearer repo guidance, stronger checks, and better runbooks.
140
142
  - `intermezzo-2`:
141
- Shift from anecdotes about the afternoon to concrete continuation evidence. The room should identify which repo signals actually saved time.
143
+ Shift from anecdotes about the afternoon to concrete continuation evidence. The room should identify which repo signals actually saved time. Open with a 3-minute silent written exercise using the retrieval prompt before any team reports aloud.
142
144
  - `reveal`:
143
145
  Shift from reflection to adoption. The close should turn signals from the day into next-week practice and into improvements to the reusable workshop blueprint.
144
146
 
@@ -52,6 +52,24 @@ Typical runtime-only actions:
52
52
 
53
53
  These actions affect only the active workshop instance unless a facilitator deliberately makes a repo edit afterward.
54
54
 
55
+ ## During Rotation
56
+
57
+ The continuation shift is the pedagogical centerpiece of the day. Its learning value depends on what was handed off.
58
+
59
+ **Before rotation begins:**
60
+ - Check the pre-rotation handoff gate (see `day-structure.md`): each team needs a readable AGENTS.md, one executable verification step, and a written next safe step.
61
+ - If a team does not meet the gate, intervene to help them write the minimum. This is not punishment — it ensures the receiving team gets a signal worth diagnosing.
62
+
63
+ **During rotation:**
64
+ - Watch for teams that jump to editing before reading. Redirect them to the "required first move" (write what helped, what's missing, what's risky, next safe step).
65
+ - Let productive friction stand. The receiving team's frustration at missing context is the lesson — do not resolve it for them.
66
+ - Intervene when frustration becomes unproductive — when teams are stuck on setup, permissions, or broken tooling rather than on repo quality. That friction does not teach anything.
67
+
68
+ **Capturing signals:**
69
+ - Use the `HandoffMomentCard` capture panel on the facilitator dashboard during or immediately after the rotation phase.
70
+ - Use the suggested seed tags (`missing_runbook`, `no_test_evidence`, `next_step_not_obvious`, `constraint_only_in_chat`, `drift_not_caught`) or add your own.
71
+ - These signals feed the cross-cohort learnings log. Even one captured signal per team is valuable.
72
+
55
73
  ## After The Day
56
74
 
57
75
  1. Archive the workshop instance.
@@ -29,6 +29,9 @@ What to say:
29
29
  Adoption signal:
30
30
  - the team has a short `AGENTS.md`, clear entry points, and an explicit next safe step
31
31
 
32
+ Anchor moment:
33
+ - The first time you open a new repo, a new task, or a new agent session.
34
+
32
35
  ### 2. If it is not in the repo, it does not exist
33
36
 
34
37
  Teach:
@@ -41,6 +44,9 @@ What to say:
41
44
  Adoption signal:
42
45
  - new assumptions become docs, plan updates, runbooks, or tests instead of staying in chat
43
46
 
47
+ Anchor moment:
48
+ - The moment you close a chat window, finish a call, or end a pairing session where a decision was made.
49
+
44
50
  ### 3. Verification is the trust boundary
45
51
 
46
52
  Teach:
@@ -53,6 +59,9 @@ What to say:
53
59
  Adoption signal:
54
60
  - meaningful work has executable evidence attached to it
55
61
 
62
+ Anchor moment:
63
+ - The moment you feel confident enough to move on — that confidence is the trigger to verify, not skip verification.
64
+
56
65
  ### 4. Boundaries create speed
57
66
 
58
67
  Teach:
@@ -65,6 +74,9 @@ What to say:
65
74
  Adoption signal:
66
75
  - the repo names boundaries, commands, and done criteria clearly enough that a new team can act without guessing
67
76
 
77
+ Anchor moment:
78
+ - The moment before you delegate a task to the agent — write the constraint before the prompt.
79
+
68
80
  ### 5. Cleanup is part of build
69
81
 
70
82
  Teach:
@@ -77,6 +89,25 @@ What to say:
77
89
  Adoption signal:
78
90
  - teams stop to simplify, document, or encode a recurring rule before moving on
79
91
 
92
+ Anchor moment:
93
+ - The second time the same review comment, friction point, or manual step appears.
94
+
95
+ ### 6. Fix the system, not just the symptom
96
+
97
+ Teach:
98
+ - when the same review comment, friction, or manual step appears a second time, the response is not to fix the output — it is to improve the harness
99
+ - write a template, add a check, encode the rule
100
+ - the harness is part of the product, not support material around it
101
+
102
+ What to say:
103
+ - "Když se stejná věc opakuje, neopravujte výstup — opravte systém."
104
+
105
+ Adoption signal:
106
+ - a repeated friction point becomes a new template, check, or documented rule instead of staying in conversation
107
+
108
+ Anchor moment:
109
+ - The second time you encounter the same friction — the repetition is the trigger.
110
+
80
111
  ## Phase-By-Phase Teaching Moves
81
112
 
82
113
  ### Opening and framing