@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.
- package/README.md +11 -1
- package/assets/workshop-bundle/SKILL.md +6 -146
- package/assets/workshop-bundle/bundle-manifest.json +40 -20
- package/assets/workshop-bundle/content/challenge-cards/deck.md +43 -23
- package/assets/workshop-bundle/content/challenge-cards/locales/en/deck.md +40 -20
- package/assets/workshop-bundle/content/facilitation/locales/en/codex-setup-verification.md +7 -0
- package/assets/workshop-bundle/content/facilitation/locales/en/master-guide.md +7 -0
- package/assets/workshop-bundle/content/talks/context-is-king.md +32 -36
- package/assets/workshop-bundle/content/talks/locales/en/codex-demo-script.md +7 -0
- package/assets/workshop-bundle/content/talks/locales/en/context-is-king.md +7 -0
- package/assets/workshop-bundle/materials/coaching-codex.md +15 -12
- package/assets/workshop-bundle/materials/participant-resource-kit.md +24 -0
- package/assets/workshop-bundle/workshop-blueprint/README.md +4 -5
- package/assets/workshop-bundle/workshop-blueprint/agenda.json +20 -20
- package/assets/workshop-bundle/workshop-blueprint/day-structure.md +4 -2
- package/assets/workshop-bundle/workshop-blueprint/operator-guide.md +18 -0
- package/assets/workshop-bundle/workshop-blueprint/teaching-spine.md +31 -0
- package/assets/workshop-bundle/workshop-skill/SKILL-facilitator.md +191 -0
- package/assets/workshop-bundle/workshop-skill/analyze-checklist.md +1 -0
- package/assets/workshop-bundle/workshop-skill/commands.md +0 -4
- package/assets/workshop-bundle/workshop-skill/follow-up-package.md +29 -36
- package/assets/workshop-bundle/workshop-skill/locales/en/commands.md +0 -4
- package/assets/workshop-bundle/workshop-skill/locales/en/follow-up-package.md +29 -36
- package/assets/workshop-bundle/workshop-skill/locales/en/reference.md +1 -0
- package/assets/workshop-bundle/workshop-skill/reference.md +1 -0
- package/package.json +1 -1
- package/src/run-cli.js +23 -0
|
@@ -1,26 +1,31 @@
|
|
|
1
1
|
# Context is King
|
|
2
2
|
|
|
3
|
-
##
|
|
3
|
+
## Mikro-cvičení
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
Tohle je krátká facilitátorova ukázka, ne práce pro celou místnost.
|
|
6
6
|
|
|
7
|
-
|
|
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
|
-
|
|
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
|
-
|
|
11
|
+
- Goal
|
|
12
|
+
- Context
|
|
13
|
+
- Constraints
|
|
14
|
+
- Done When
|
|
15
|
+
|
|
16
|
+
## Co jste právě viděli
|
|
14
17
|
|
|
15
|
-
|
|
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
|
-
|
|
20
|
+
Rámec pro dnešek:
|
|
18
21
|
|
|
19
|
-
|
|
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
|
|
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
|
-
|
|
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
|
|
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
|
|
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
|
|
57
|
-
- U
|
|
58
|
-
- „Nech model jezdit v
|
|
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
|
|
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
|
|
64
|
-
- Odpolední návaznost prověří, jestli váš kontext funguje i
|
|
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
|
|
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
|
|
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
|
|
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
|
-
##
|
|
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
|
|
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.
|
|
@@ -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
|
|
47
|
+
For maintainers working in the source repository, the canonical bilingual content source is:
|
|
48
48
|
|
|
49
|
-
- `
|
|
50
|
-
- `
|
|
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
|
-
|
|
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": "
|
|
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
|
|
17
|
+
"label": "Opening and orientation",
|
|
18
18
|
"startTime": "09:10",
|
|
19
19
|
"kind": "shared",
|
|
20
|
-
"goal": "
|
|
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
|
|
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": "
|
|
33
|
+
"label": "Codex demo",
|
|
34
34
|
"startTime": "10:05",
|
|
35
35
|
"kind": "shared",
|
|
36
|
-
"goal": "
|
|
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
|
|
41
|
+
"label": "Build fáze 1",
|
|
42
42
|
"startTime": "10:30",
|
|
43
43
|
"kind": "team",
|
|
44
|
-
"goal": "
|
|
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:
|
|
50
|
+
"startTime": "11:35",
|
|
51
51
|
"kind": "shared",
|
|
52
|
-
"goal": "
|
|
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
|
|
57
|
+
"label": "Lunch and handoff prep",
|
|
58
58
|
"startTime": "12:15",
|
|
59
59
|
"kind": "shared",
|
|
60
|
-
"goal": "
|
|
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": "
|
|
65
|
+
"label": "Team rotation",
|
|
66
66
|
"startTime": "13:30",
|
|
67
67
|
"kind": "team",
|
|
68
|
-
"goal": "Force
|
|
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
|
|
74
|
-
"startTime": "
|
|
73
|
+
"label": "Build fáze 2",
|
|
74
|
+
"startTime": "13:45",
|
|
75
75
|
"kind": "team",
|
|
76
|
-
"goal": "
|
|
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": "
|
|
82
|
+
"startTime": "14:45",
|
|
83
83
|
"kind": "shared",
|
|
84
|
-
"goal": "
|
|
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": "
|
|
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
|