@harness-lab/cli 0.2.8 → 0.3.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 +34 -3
- package/assets/workshop-bundle/SKILL.md +28 -0
- package/assets/workshop-bundle/bundle-manifest.json +44 -52
- 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/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 +137 -67
- 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 +26 -23
- package/assets/workshop-bundle/docs/harness-cli-foundation.md +23 -11
- 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 +5 -5
- package/assets/workshop-bundle/workshop-skill/commands.md +13 -13
- package/assets/workshop-bundle/workshop-skill/facilitator.md +95 -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/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 +19 -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 +45 -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 +18 -0
- package/src/io.js +11 -2
- package/src/run-cli.js +266 -8
- package/src/session-store.js +1 -0
- package/src/skill-install.js +108 -7
- package/src/workshop-bundle.js +48 -3
- 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
package/README.md
CHANGED
|
@@ -9,9 +9,15 @@ Current shipped scope:
|
|
|
9
9
|
- `harness auth login`
|
|
10
10
|
- `harness auth logout`
|
|
11
11
|
- `harness auth status`
|
|
12
|
+
- `harness workshop current-instance`
|
|
13
|
+
- `harness workshop select-instance`
|
|
12
14
|
- `harness workshop status`
|
|
15
|
+
- `harness workshop list-instances`
|
|
16
|
+
- `harness workshop show-instance`
|
|
17
|
+
- `harness workshop participant-access`
|
|
13
18
|
- `harness workshop create-instance`
|
|
14
19
|
- `harness workshop update-instance`
|
|
20
|
+
- `harness workshop reset-instance`
|
|
15
21
|
- `harness workshop prepare`
|
|
16
22
|
- `harness workshop remove-instance`
|
|
17
23
|
- `harness workshop archive`
|
|
@@ -120,16 +126,41 @@ Workshop commands:
|
|
|
120
126
|
```bash
|
|
121
127
|
harness auth status
|
|
122
128
|
harness skill install
|
|
129
|
+
harness workshop list-instances
|
|
130
|
+
harness workshop select-instance sample-workshop-demo-orbit
|
|
131
|
+
harness workshop current-instance
|
|
123
132
|
harness workshop status
|
|
133
|
+
harness workshop show-instance sample-workshop-demo-orbit
|
|
134
|
+
harness workshop participant-access
|
|
135
|
+
harness workshop participant-access --rotate
|
|
136
|
+
harness workshop participant-access --rotate --code orbit7-bridge4-shift2
|
|
124
137
|
harness workshop create-instance sample-workshop-demo-orbit --event-title "Sample Workshop Demo"
|
|
125
|
-
harness workshop update-instance
|
|
126
|
-
harness workshop
|
|
127
|
-
harness workshop
|
|
138
|
+
harness workshop update-instance --room-name Orbit
|
|
139
|
+
harness workshop reset-instance --template-id blueprint-default
|
|
140
|
+
harness workshop prepare
|
|
141
|
+
harness workshop remove-instance
|
|
128
142
|
harness workshop phase set rotation
|
|
129
143
|
harness workshop archive --notes "Manual archive"
|
|
144
|
+
harness workshop select-instance --clear
|
|
130
145
|
harness auth logout
|
|
131
146
|
```
|
|
132
147
|
|
|
148
|
+
Targeting model:
|
|
149
|
+
|
|
150
|
+
- `harness workshop list-instances` is the discovery entrypoint for facilitator-visible workshops
|
|
151
|
+
- `harness workshop select-instance <instance-id>` stores a local current target for later workshop commands
|
|
152
|
+
- `harness workshop current-instance` reports the stored target and resolves its current server state
|
|
153
|
+
- `harness workshop status` and `harness workshop phase set <phase-id>` use the selected instance when present, otherwise they fall back to deployment default behavior
|
|
154
|
+
- `harness workshop show-instance`, `update-instance`, `reset-instance`, `prepare`, and `remove-instance` accept an explicit `<instance-id>` but may also use the stored selection as a fallback
|
|
155
|
+
- `harness workshop participant-access` accepts an explicit `<instance-id>` but may also use the stored selection as a fallback
|
|
156
|
+
- `harness workshop select-instance --clear` removes the stored selection
|
|
157
|
+
- `HARNESS_WORKSHOP_INSTANCE_ID` remains an environment fallback when no local selection is stored
|
|
158
|
+
|
|
159
|
+
Machine-readable output:
|
|
160
|
+
|
|
161
|
+
- `harness --json ...` prints strict JSON output without headings
|
|
162
|
+
- prefer this for agent or script consumption instead of parsing human-oriented terminal copy
|
|
163
|
+
|
|
133
164
|
Facilitator lifecycle commands are intentionally CLI-first:
|
|
134
165
|
|
|
135
166
|
- skill invokes `harness`
|
|
@@ -214,18 +214,40 @@ This is a facilitator-only command — do not surface to participants.
|
|
|
214
214
|
|
|
215
215
|
Show the current instance state, agenda phase, facilitator list, and team count.
|
|
216
216
|
Requires active facilitator session.
|
|
217
|
+
If a local current instance is selected, prefer that target over deployment-default status.
|
|
218
|
+
When an agent needs machine-readable output, prefer `harness --json workshop status`.
|
|
219
|
+
|
|
220
|
+
### `workshop facilitator current-instance`
|
|
221
|
+
|
|
222
|
+
Show the locally selected facilitator target, where it came from, and the resolved instance record.
|
|
223
|
+
Prefer invoking `harness workshop current-instance`.
|
|
224
|
+
Use this to confirm the CLI target before update, reset, prepare, remove, or phase operations.
|
|
225
|
+
|
|
226
|
+
### `workshop facilitator select-instance <instance-id>`
|
|
227
|
+
|
|
228
|
+
Persist a facilitator-local current target for later workshop commands.
|
|
229
|
+
Prefer invoking `harness workshop select-instance <instance-id>`.
|
|
230
|
+
Use `harness workshop select-instance --clear` to remove the stored selection.
|
|
217
231
|
|
|
218
232
|
### `workshop facilitator list-instances`
|
|
219
233
|
|
|
220
234
|
List the facilitator-visible workshop instance registry.
|
|
221
235
|
Prefer invoking `harness workshop list-instances` over raw API scripts or local session-file inspection.
|
|
222
236
|
Use this when the facilitator needs to discover what currently exists on a shared dashboard before choosing an explicit instance for reset, update, or agenda work.
|
|
237
|
+
When an agent needs strict parsing, prefer `harness --json workshop list-instances`.
|
|
223
238
|
|
|
224
239
|
### `workshop facilitator show-instance <instance-id>`
|
|
225
240
|
|
|
226
241
|
Inspect one explicit workshop instance.
|
|
227
242
|
Prefer invoking `harness workshop show-instance <instance-id>` over raw API scripts.
|
|
228
243
|
Use this when the facilitator needs the full record for one instance rather than the deployment-default runtime status returned by `workshop facilitator status`.
|
|
244
|
+
If a current instance is already selected, the CLI may omit `<instance-id>` and use the stored target.
|
|
245
|
+
|
|
246
|
+
### `workshop facilitator participant-access`
|
|
247
|
+
|
|
248
|
+
Inspect or rotate the shared participant event code for the current workshop instance.
|
|
249
|
+
Prefer invoking `harness --json workshop participant-access` for inspection and `harness --json workshop participant-access --rotate` to issue a fresh code.
|
|
250
|
+
If the current raw code is no longer recoverable from the hash-only runtime store, issue a new code instead of guessing.
|
|
229
251
|
|
|
230
252
|
### `workshop facilitator grant <email> <role>`
|
|
231
253
|
|
|
@@ -263,6 +285,7 @@ Support `contentLang` changes explicitly so facilitators can choose workshop del
|
|
|
263
285
|
|
|
264
286
|
Facilitator discovery rule:
|
|
265
287
|
- for routine discovery, use `harness workshop list-instances` and `harness workshop show-instance`
|
|
288
|
+
- for repeated work on one live workshop, use `harness workshop select-instance <instance-id>` and `harness workshop current-instance`
|
|
266
289
|
- do not read local CLI session files or improvise authenticated `node -e` fetch scripts unless you are diagnosing the CLI itself
|
|
267
290
|
|
|
268
291
|
### `workshop facilitator reset-instance <instance-id>`
|
|
@@ -270,16 +293,19 @@ Facilitator discovery rule:
|
|
|
270
293
|
Reset one existing workshop instance from the selected blueprint template. Requires facilitator session.
|
|
271
294
|
Prefer invoking `harness workshop reset-instance` over raw API scripts.
|
|
272
295
|
Use this when the facilitator wants fresh canonical agenda, runner, and presenter content for a live instance and accepts that local runtime state will be reinitialized.
|
|
296
|
+
If a current instance is already selected, the CLI may omit `<instance-id>` and use the stored target.
|
|
273
297
|
|
|
274
298
|
### `workshop facilitator remove-instance`
|
|
275
299
|
|
|
276
300
|
Remove a workshop instance from the active list without deleting its archive history. Requires facilitator session.
|
|
277
301
|
Prefer invoking `harness workshop remove-instance`.
|
|
302
|
+
If a current instance is already selected, the CLI may omit `<instance-id>` and use the stored target.
|
|
278
303
|
|
|
279
304
|
### `workshop facilitator prepare`
|
|
280
305
|
|
|
281
306
|
Set the current instance to `prepared` state. Verify event code is ready.
|
|
282
307
|
Prefer invoking `harness workshop prepare`.
|
|
308
|
+
If a current instance is already selected, the CLI may omit `<instance-id>` and use the stored target.
|
|
283
309
|
|
|
284
310
|
### `workshop facilitator agenda`
|
|
285
311
|
|
|
@@ -329,10 +355,12 @@ Relevant local files:
|
|
|
329
355
|
- `workshop-skill/follow-up-package.md`
|
|
330
356
|
- `workshop-skill/facilitator.md`
|
|
331
357
|
- `materials/participant-resource-kit.md`
|
|
358
|
+
- `materials/coaching-codex.md`
|
|
332
359
|
- `docs/learner-resource-kit.md`
|
|
333
360
|
- `docs/learner-reference-gallery.md`
|
|
334
361
|
- `content/project-briefs/*.md`
|
|
335
362
|
- `content/challenge-cards/deck.md`
|
|
363
|
+
- `content/codex-craft.md`
|
|
336
364
|
- `workshop-blueprint/*`
|
|
337
365
|
- `docs/workshop-event-context-contract.md`
|
|
338
366
|
- `docs/harness-cli-foundation.md`
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
{
|
|
2
2
|
"manifestVersion": 1,
|
|
3
3
|
"bundleName": "harness-lab-workshop",
|
|
4
|
-
"bundleVersion": "0.
|
|
5
|
-
"contentHash": "
|
|
4
|
+
"bundleVersion": "0.3.0",
|
|
5
|
+
"contentHash": "b0fd5ae303c75a44d04b923e25f7a28584c8fc63940b142fdfbba4f2f8ff255c",
|
|
6
6
|
"files": [
|
|
7
7
|
{
|
|
8
8
|
"path": "content/challenge-cards/.gitkeep",
|
|
@@ -10,19 +10,19 @@
|
|
|
10
10
|
},
|
|
11
11
|
{
|
|
12
12
|
"path": "content/challenge-cards/deck.md",
|
|
13
|
-
"sha256": "
|
|
13
|
+
"sha256": "1c8b4e3a6ab987dc2e9e5418a32a84b8dd3485b8ee0d7d5dc9dc01394f57e3cc"
|
|
14
14
|
},
|
|
15
15
|
{
|
|
16
16
|
"path": "content/challenge-cards/locales/en/deck.md",
|
|
17
|
-
"sha256": "
|
|
17
|
+
"sha256": "f519c2dfa66801a90e1dbf8833e73bd03fbb001de9766286f9627750456a0b9b"
|
|
18
18
|
},
|
|
19
19
|
{
|
|
20
20
|
"path": "content/challenge-cards/print-spec.md",
|
|
21
21
|
"sha256": "be7ecfdae9ada4145272f12e2d6018ccde7cfaeb9f48feb58aca7da7236815c0"
|
|
22
22
|
},
|
|
23
23
|
{
|
|
24
|
-
"path": "content/
|
|
25
|
-
"sha256": "
|
|
24
|
+
"path": "content/codex-craft.md",
|
|
25
|
+
"sha256": "d75b15cf97c4ab7f4918e09fff0efbe204d141f7127ca09d9a446a128c8efaaf"
|
|
26
26
|
},
|
|
27
27
|
{
|
|
28
28
|
"path": "content/facilitation/.gitkeep",
|
|
@@ -30,11 +30,11 @@
|
|
|
30
30
|
},
|
|
31
31
|
{
|
|
32
32
|
"path": "content/facilitation/codex-setup-verification.md",
|
|
33
|
-
"sha256": "
|
|
33
|
+
"sha256": "d137a5e729a1d443713a9e8431bffe169a1058d3e64c298688a6b7924fbdf3a8"
|
|
34
34
|
},
|
|
35
35
|
{
|
|
36
36
|
"path": "content/facilitation/master-guide.md",
|
|
37
|
-
"sha256": "
|
|
37
|
+
"sha256": "2c8033a43459dad42a88c1c842e5e915e6bb7d6dbdea38412d4a9c06b93544d7"
|
|
38
38
|
},
|
|
39
39
|
{
|
|
40
40
|
"path": "content/project-briefs/.gitkeep",
|
|
@@ -42,15 +42,15 @@
|
|
|
42
42
|
},
|
|
43
43
|
{
|
|
44
44
|
"path": "content/project-briefs/code-review-helper.md",
|
|
45
|
-
"sha256": "
|
|
45
|
+
"sha256": "96bbbef60ab0ff93ad4aa3858852886329139a25ce9f375bc4cc57ad706b7c98"
|
|
46
46
|
},
|
|
47
47
|
{
|
|
48
48
|
"path": "content/project-briefs/devtoolbox-cli.md",
|
|
49
|
-
"sha256": "
|
|
49
|
+
"sha256": "ce0b09a5e77be19f8ddb2ba6a43137c3cc2a415512d247971186e846dd018888"
|
|
50
50
|
},
|
|
51
51
|
{
|
|
52
52
|
"path": "content/project-briefs/doc-generator.md",
|
|
53
|
-
"sha256": "
|
|
53
|
+
"sha256": "48b8298be1e14e962055ac6d157be2728aa96fc71109e7ee833a6c56dab64731"
|
|
54
54
|
},
|
|
55
55
|
{
|
|
56
56
|
"path": "content/project-briefs/locales/en/code-review-helper.md",
|
|
@@ -58,35 +58,27 @@
|
|
|
58
58
|
},
|
|
59
59
|
{
|
|
60
60
|
"path": "content/project-briefs/locales/en/devtoolbox-cli.md",
|
|
61
|
-
"sha256": "
|
|
61
|
+
"sha256": "3dd5e35524170feda7fa5e73d6b331d1bed88dd8c5966525d361fd1152802cb0"
|
|
62
62
|
},
|
|
63
63
|
{
|
|
64
64
|
"path": "content/project-briefs/locales/en/doc-generator.md",
|
|
65
|
-
"sha256": "
|
|
65
|
+
"sha256": "b9f5b61dd21d867dc231bc5cf29ef1f493a9a208f55fc0f840b22302cd6890de"
|
|
66
66
|
},
|
|
67
67
|
{
|
|
68
68
|
"path": "content/project-briefs/locales/en/metrics-dashboard.md",
|
|
69
|
-
"sha256": "
|
|
69
|
+
"sha256": "6ae0a048ba0692f9a4b88f4fce90be7ea9cf8a28f551b59870f4862d6e5785a5"
|
|
70
70
|
},
|
|
71
71
|
{
|
|
72
72
|
"path": "content/project-briefs/locales/en/standup-bot.md",
|
|
73
|
-
"sha256": "
|
|
73
|
+
"sha256": "bd9aff3ac09e4866b10e90685e348e041dfe8cdbd8a65c17871f5d3b5f2240d0"
|
|
74
74
|
},
|
|
75
75
|
{
|
|
76
76
|
"path": "content/project-briefs/metrics-dashboard.md",
|
|
77
|
-
"sha256": "
|
|
77
|
+
"sha256": "40c0d09c02fb20c97c0f99088641de20fa966b17089f6f7701a7808814b31c55"
|
|
78
78
|
},
|
|
79
79
|
{
|
|
80
80
|
"path": "content/project-briefs/standup-bot.md",
|
|
81
|
-
"sha256": "
|
|
82
|
-
},
|
|
83
|
-
{
|
|
84
|
-
"path": "content/style-examples.md",
|
|
85
|
-
"sha256": "c8e62493e119995fca1c738584b864506bc838203b1adad008c37b6f6ec57c50"
|
|
86
|
-
},
|
|
87
|
-
{
|
|
88
|
-
"path": "content/style-guide.md",
|
|
89
|
-
"sha256": "ec9a49e040efbc6c365eb264bd3452fdf1906f141f358ff28d2e0e3360648d28"
|
|
81
|
+
"sha256": "df9abc9d7bc8283d30d1c09fb412f9e072a980782c0b622747b13744b2a81c84"
|
|
90
82
|
},
|
|
91
83
|
{
|
|
92
84
|
"path": "content/talks/.gitkeep",
|
|
@@ -94,15 +86,15 @@
|
|
|
94
86
|
},
|
|
95
87
|
{
|
|
96
88
|
"path": "content/talks/codex-demo-script.md",
|
|
97
|
-
"sha256": "
|
|
89
|
+
"sha256": "d5ff639fde21e47606a81aeae6e2b135d2063c073a8dd5717a0386546b9b77cc"
|
|
98
90
|
},
|
|
99
91
|
{
|
|
100
92
|
"path": "content/talks/context-is-king.md",
|
|
101
|
-
"sha256": "
|
|
93
|
+
"sha256": "33583f7982dd8f2d4d1bcbb637c0408562d6e0e20825eea06f897b34fe5efe16"
|
|
102
94
|
},
|
|
103
95
|
{
|
|
104
96
|
"path": "docs/harness-cli-foundation.md",
|
|
105
|
-
"sha256": "
|
|
97
|
+
"sha256": "10311d3caf8cec304d5d1694eac66623f06c100990d6f5c4d1dd1f4ba8a24bd8"
|
|
106
98
|
},
|
|
107
99
|
{
|
|
108
100
|
"path": "docs/learner-reference-gallery.md",
|
|
@@ -110,7 +102,7 @@
|
|
|
110
102
|
},
|
|
111
103
|
{
|
|
112
104
|
"path": "docs/learner-resource-kit.md",
|
|
113
|
-
"sha256": "
|
|
105
|
+
"sha256": "1bfad4ee7514b76f9ad6943157224b345359588748ffffb7b93f2f8b70c8af06"
|
|
114
106
|
},
|
|
115
107
|
{
|
|
116
108
|
"path": "docs/locales/en/learner-reference-gallery.md",
|
|
@@ -124,17 +116,21 @@
|
|
|
124
116
|
"path": "docs/workshop-event-context-contract.md",
|
|
125
117
|
"sha256": "a7706a398ea5250537fb34323c4371ea2a7db15e477aec3a7893e6089fcd281f"
|
|
126
118
|
},
|
|
119
|
+
{
|
|
120
|
+
"path": "materials/coaching-codex.md",
|
|
121
|
+
"sha256": "2390be079acde89b16380cdd0904fac2cbefcb9aa11c1fe256330b2dc2362ba9"
|
|
122
|
+
},
|
|
127
123
|
{
|
|
128
124
|
"path": "materials/locales/en/participant-resource-kit.md",
|
|
129
|
-
"sha256": "
|
|
125
|
+
"sha256": "02c7d6bde0c0662fdfdd0a8baed8c93f2a3c722c1a59336e4862f0d8f8490fbe"
|
|
130
126
|
},
|
|
131
127
|
{
|
|
132
128
|
"path": "materials/participant-resource-kit.md",
|
|
133
|
-
"sha256": "
|
|
129
|
+
"sha256": "d7cd7db05429faf7af570e33401cb5788d663e06c984f193596c14d2d8a12a5b"
|
|
134
130
|
},
|
|
135
131
|
{
|
|
136
132
|
"path": "SKILL.md",
|
|
137
|
-
"sha256": "
|
|
133
|
+
"sha256": "a8b8f76f8eeef2a7e7cd0d2906f33a7ab7a146a14383f5f679fddc6b3bdf8242"
|
|
138
134
|
},
|
|
139
135
|
{
|
|
140
136
|
"path": "workshop-blueprint/agenda.json",
|
|
@@ -146,11 +142,7 @@
|
|
|
146
142
|
},
|
|
147
143
|
{
|
|
148
144
|
"path": "workshop-blueprint/day-structure.md",
|
|
149
|
-
"sha256": "
|
|
150
|
-
},
|
|
151
|
-
{
|
|
152
|
-
"path": "workshop-blueprint/edit-boundaries.md",
|
|
153
|
-
"sha256": "d5a2b6039ff9d3acc5b3a58698289817a29d52af4058034f00bc188db6f5d84d"
|
|
145
|
+
"sha256": "22d6fec0422751439bd10049028ee12d140599707dbc6df248b4ff8517ee0c15"
|
|
154
146
|
},
|
|
155
147
|
{
|
|
156
148
|
"path": "workshop-blueprint/operator-guide.md",
|
|
@@ -158,7 +150,7 @@
|
|
|
158
150
|
},
|
|
159
151
|
{
|
|
160
152
|
"path": "workshop-blueprint/README.md",
|
|
161
|
-
"sha256": "
|
|
153
|
+
"sha256": "e5cc8a87576988ce724b7ffacd86a4276aa6733bd4b9037d1f560a58da048308"
|
|
162
154
|
},
|
|
163
155
|
{
|
|
164
156
|
"path": "workshop-blueprint/teaching-spine.md",
|
|
@@ -170,27 +162,27 @@
|
|
|
170
162
|
},
|
|
171
163
|
{
|
|
172
164
|
"path": "workshop-skill/analyze-checklist.md",
|
|
173
|
-
"sha256": "
|
|
165
|
+
"sha256": "b1b5af58fc18f8400677a964eb3c1970015284d63101683fc8232bbea6cf8871"
|
|
174
166
|
},
|
|
175
167
|
{
|
|
176
168
|
"path": "workshop-skill/closing-skill.md",
|
|
177
|
-
"sha256": "
|
|
169
|
+
"sha256": "7019aa2afe4ac68869f0ec0c4bf9509f35695d171b66292d874e41355da178e0"
|
|
178
170
|
},
|
|
179
171
|
{
|
|
180
172
|
"path": "workshop-skill/commands.md",
|
|
181
|
-
"sha256": "
|
|
173
|
+
"sha256": "837c795baf133f220d3badf329c2484028f87209fb4e39cc729df54754b9a0a3"
|
|
182
174
|
},
|
|
183
175
|
{
|
|
184
176
|
"path": "workshop-skill/facilitator.md",
|
|
185
|
-
"sha256": "
|
|
177
|
+
"sha256": "b8c9e1c01ddb314e45d8d2c3a7460bac53a48ba2321eaf6518e4b08436d88895"
|
|
186
178
|
},
|
|
187
179
|
{
|
|
188
180
|
"path": "workshop-skill/follow-up-package.md",
|
|
189
|
-
"sha256": "
|
|
181
|
+
"sha256": "74b8232f54b663d8ba9a97485c898ef0e8cffd5b5423831627ee7fe94d1cca44"
|
|
190
182
|
},
|
|
191
183
|
{
|
|
192
184
|
"path": "workshop-skill/install.md",
|
|
193
|
-
"sha256": "
|
|
185
|
+
"sha256": "4e356194b0dbe114f71ec3661e1b4a4c323cdaa5efedac977f28629b4db66772"
|
|
194
186
|
},
|
|
195
187
|
{
|
|
196
188
|
"path": "workshop-skill/locales/en/commands.md",
|
|
@@ -198,35 +190,35 @@
|
|
|
198
190
|
},
|
|
199
191
|
{
|
|
200
192
|
"path": "workshop-skill/locales/en/follow-up-package.md",
|
|
201
|
-
"sha256": "
|
|
193
|
+
"sha256": "f941c29394f143b9e78d2d54ffb3e0643e421c310329ead784a13e788c8d8caf"
|
|
202
194
|
},
|
|
203
195
|
{
|
|
204
196
|
"path": "workshop-skill/locales/en/recap.md",
|
|
205
|
-
"sha256": "
|
|
197
|
+
"sha256": "58329809e3400599a3b187f89dcae4aac939737b786389ed6c893540aa8e8249"
|
|
206
198
|
},
|
|
207
199
|
{
|
|
208
200
|
"path": "workshop-skill/locales/en/reference.md",
|
|
209
|
-
"sha256": "
|
|
201
|
+
"sha256": "f5931048a100e7da07b2b0cbfcf40d3f7744014cb0658df51e34930d23692903"
|
|
210
202
|
},
|
|
211
203
|
{
|
|
212
204
|
"path": "workshop-skill/locales/en/setup.md",
|
|
213
|
-
"sha256": "
|
|
205
|
+
"sha256": "3b77f4ca8d7eedf6d2ad01635c6727fd50fe658520b93f0bb1ae9c605ad62c31"
|
|
214
206
|
},
|
|
215
207
|
{
|
|
216
208
|
"path": "workshop-skill/recap.md",
|
|
217
|
-
"sha256": "
|
|
209
|
+
"sha256": "fa242bbb17d5305fda2b3c08a8da14744f60f6895985bbbbb1604c4c1ad4c8b4"
|
|
218
210
|
},
|
|
219
211
|
{
|
|
220
212
|
"path": "workshop-skill/reference.md",
|
|
221
|
-
"sha256": "
|
|
213
|
+
"sha256": "89ef69ce4380468557a2f43576286937baf891bb0dc19035f0f06da69a3d0e38"
|
|
222
214
|
},
|
|
223
215
|
{
|
|
224
216
|
"path": "workshop-skill/setup.md",
|
|
225
|
-
"sha256": "
|
|
217
|
+
"sha256": "8a9a66372b49d504b5df45e0df3eac2835ef02ce79b7db1078fc85a928a36d5d"
|
|
226
218
|
},
|
|
227
219
|
{
|
|
228
220
|
"path": "workshop-skill/template-agents.md",
|
|
229
|
-
"sha256": "
|
|
221
|
+
"sha256": "a8647455ac66b79107d120258591e5e96cef394ed1b2acdb8a2ec4669469c5fe"
|
|
230
222
|
}
|
|
231
223
|
]
|
|
232
224
|
}
|
|
@@ -1,38 +1,40 @@
|
|
|
1
1
|
# Challenge Cards
|
|
2
2
|
|
|
3
|
-
Karty nejsou body navíc. Jsou to malé zásahy, které zlepšují způsob práce s
|
|
3
|
+
Karty nejsou body navíc. Jsou to malé zásahy, které zlepšují způsob práce s agentem i kvalitu handoffu.
|
|
4
4
|
|
|
5
|
-
##
|
|
5
|
+
## Před obědem: postavte pracovní systém
|
|
6
6
|
|
|
7
|
-
- `Vytvořte AGENTS.md jako mapu` — sepište cíl, build/test příkazy, trvalá pravidla a
|
|
7
|
+
- `Vytvořte AGENTS.md jako mapu` — sepište cíl, build/test příkazy, trvalá pravidla a kam má další tým sáhnout jako první.
|
|
8
8
|
- `Přidejte build/test příkazy` — agent musí umět ověřit výsledek bez ručního dovysvětlování.
|
|
9
|
-
- `Napište skill pro code review` — formalizujte jednu review rutinu, kterou by uměl použít i
|
|
9
|
+
- `Napište skill pro code review` — formalizujte jednu review rutinu, kterou by uměl použít i cizí tým.
|
|
10
10
|
- `Přesuňte pravidlo z hovoru do repa` — vše, co už tým řekl dvakrát nahlas, převeďte do `AGENTS.md`, README, runbooku nebo testu.
|
|
11
11
|
|
|
12
|
-
##
|
|
12
|
+
## Po rotaci: opravte signál, ne jen feature
|
|
13
13
|
|
|
14
|
-
- `Použijte /plan před kódováním` — ukažte, z
|
|
15
|
-
- `Rozdělte práci do více vláken` — zkuste dvě nezávislé linie práce a
|
|
14
|
+
- `Použijte /plan před kódováním` — ukažte, z jakého plánu kroků tým vycházel, co z něj opravdu plní a jaký je další bezpečný krok.
|
|
15
|
+
- `Rozdělte práci do více vláken` — zkuste dvě nezávislé linie práce a jednoho člověka na integraci.
|
|
16
16
|
- `Delegujte úkol a vraťte se ke kontrole za 10 minut` — neskákejte agentovi do každého kroku, kontrolujte až výsledek.
|
|
17
|
-
- `Přidejte nejmenší užitečné ověření` —
|
|
17
|
+
- `Přidejte nejmenší užitečné ověření` — zapište done criteria jako spustitelný check (unit test, tracer bullet nebo jednoduchý browser check) dřív, než agent dostane víc autonomie.
|
|
18
|
+
- `Napište diagnózu po handoffu` — pojmenujte, co pomohlo, co chybělo a jaký je další safe move.
|
|
19
|
+
- `Opravte jeden slabý signál v repu` — README, AGENTS.md, plán, runbook nebo check.
|
|
18
20
|
|
|
19
21
|
## Advanced
|
|
20
22
|
|
|
21
|
-
- `Spusťte 2 paralelní Codex sessions` — rozdělte problém na dvě nezávislé části a
|
|
22
|
-
- `Vytvořte runbook pro deployment` — i
|
|
23
|
-
- `Napište AGENTS.md pro podsložku` — ukažte, že kontext může být globální i
|
|
24
|
-
- `Zaveďte garbage collection` — najděte jednu opakující se formu chaosu a
|
|
23
|
+
- `Spusťte 2 paralelní Codex sessions` — rozdělte problém na dvě nezávislé části a porovnejte výstupy.
|
|
24
|
+
- `Vytvořte runbook pro deployment` — i kdyby deploy zůstal jen simulovaný.
|
|
25
|
+
- `Napište AGENTS.md pro podsložku` — ukažte, že kontext může být globální i lokální.
|
|
26
|
+
- `Zaveďte garbage collection` — najděte jednu opakující se formu chaosu a proměňte ji v check, template nebo pravidlo.
|
|
25
27
|
|
|
26
28
|
## Meta
|
|
27
29
|
|
|
28
30
|
- `Přesuňte trvalé pravidlo z promptu do AGENTS.md`.
|
|
29
31
|
- `Přidejte sekci Done When ke každému tasku`.
|
|
30
32
|
- `Napište README pro tým po rotaci, ne pro sebe`.
|
|
31
|
-
- `Zapište, co je skutečně ověřené` — odlište hotové, rozpracované a
|
|
33
|
+
- `Zapište, co je skutečně ověřené` — odlište hotové, rozpracované a jen předpokládané.
|
|
32
34
|
|
|
33
|
-
## Jak s
|
|
35
|
+
## Jak s kartami pracovat
|
|
34
36
|
|
|
35
|
-
- Před obědem má každý tým splnit aspoň jednu kartu z
|
|
36
|
-
- Před rotací má být v
|
|
37
|
-
- Po rotaci má každý tým splnit aspoň jednu kartu z `
|
|
37
|
+
- Před obědem má každý tým splnit aspoň jednu kartu z části `Před obědem: postavte pracovní systém`.
|
|
38
|
+
- Před rotací má být v repu dohledatelné, co bylo opravdu ověřeno a jaký je další bezpečný krok.
|
|
39
|
+
- Po rotaci má každý tým splnit aspoň jednu kartu z `Po rotaci: opravte signál, ne jen feature`.
|
|
38
40
|
- Ostatní karty jsou dobrovolné. Berte je jako stretch cíle nebo inspiraci, když nevíte, co zlepšit dál.
|
|
@@ -2,19 +2,21 @@
|
|
|
2
2
|
|
|
3
3
|
These cards are not bonus points. They are small interventions that improve both the way of working with the agent and the quality of the handoff.
|
|
4
4
|
|
|
5
|
-
##
|
|
5
|
+
## Before lunch: build the working system
|
|
6
6
|
|
|
7
7
|
- `Create AGENTS.md as a map` - write down the goal, build and test commands, durable rules, and where the next team should look first.
|
|
8
8
|
- `Add build/test commands` - the agent must be able to verify the result without manual backfilling.
|
|
9
9
|
- `Write a code review skill` - formalize one review routine that another team could use too.
|
|
10
10
|
- `Move one rule from conversation into the repo` - anything the team has said out loud twice should be turned into `AGENTS.md`, README, a runbook, or a test.
|
|
11
11
|
|
|
12
|
-
##
|
|
12
|
+
## After rotation: fix the signal, not only the feature
|
|
13
13
|
|
|
14
14
|
- `Use /plan before coding` - show which plan the team is working from, what is actually being executed, and what the next safe move is.
|
|
15
15
|
- `Split the work into multiple threads` - try two independent work streams and one person on integration.
|
|
16
16
|
- `Delegate a task and come back to check it in 10 minutes` - do not jump into every agent step; inspect the outcome instead.
|
|
17
|
-
- `Add the smallest useful verification` -
|
|
17
|
+
- `Add the smallest useful verification` - write the done criteria as an executable check (unit test, tracer bullet, or simple browser check) before the agent gets more autonomy.
|
|
18
|
+
- `Write the post-handoff diagnosis` - name what helped, what was missing, and what the next safe move is.
|
|
19
|
+
- `Fix one weak repo signal` - README, AGENTS.md, plan, runbook, or check.
|
|
18
20
|
|
|
19
21
|
## Advanced
|
|
20
22
|
|
|
@@ -32,7 +34,7 @@ These cards are not bonus points. They are small interventions that improve both
|
|
|
32
34
|
|
|
33
35
|
## How to use the cards
|
|
34
36
|
|
|
35
|
-
- Before lunch, every team should complete at least one `
|
|
37
|
+
- Before lunch, every team should complete at least one `Before lunch: build the working system` card.
|
|
36
38
|
- Before rotation, the repo should clearly show what was actually verified and what the next safe move is.
|
|
37
|
-
- After rotation, every team should complete at least one `
|
|
39
|
+
- After rotation, every team should complete at least one `After rotation: fix the signal, not only the feature` card.
|
|
38
40
|
- The other cards are optional. Treat them as stretch goals or prompts for what to improve next.
|