You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: workshop/side-quest-07-01-compile-workflow.md
+15-5Lines changed: 15 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,7 +4,7 @@
4
4
5
5
## 🎯 What You'll Do
6
6
7
-
You'll use `gh aw compile` as a fast feedback loop while you edit workflow files. By the end, you'll know when to run `--validate`, when to keep `--watch` running, and how to fix the most common compile errors.
7
+
You'll use `gh aw compile` as a fast feedback loop while you edit workflow files. By the end, you'll know when to use `--no-emit` for dry-run checks, when to use `--validate` for deeper validation, when to keep `--watch` running, and how to fix the most common compile errors.
8
8
9
9
## What `gh aw compile` does
10
10
@@ -21,15 +21,25 @@ If it succeeds, you should see a green success message and an updated `.lock.yml
21
21
> [!NOTE]
22
22
> `gh aw compile` checks file structure, not whether the agent's reasoning or final output is good. You still test the workflow separately after it compiles cleanly.
23
23
24
-
## Use `--validate` for quick checkpoints
24
+
## Use `--no-emit` for quick structure checks
25
25
26
-
When you only want a yes/no answer while building a file in small sections, use `--validate`:
26
+
When you only want a yes/no answer without generating a lock file, use `--no-emit`:
27
+
28
+
```bash
29
+
gh aw compile --no-emit
30
+
```
31
+
32
+
This is useful after each small edit because it confirms the file structure without writing or overwriting the generated lock file every time.
33
+
34
+
## Use `--validate` for deeper validation
35
+
36
+
When you want stricter checks on top of normal compilation, add `--validate`:
27
37
28
38
```bash
29
39
gh aw compile --validate
30
40
```
31
41
32
-
This is useful after each small edit because it confirms the file structure without making you stop and inspect the generated lock file every time.
42
+
This enables GitHub Actions workflow schema validation, container image validation, and action SHA validation. It is more thorough than a plain compile but also slower, so it is best reserved for a pre-commit or CI check rather than every small edit.
33
43
34
44
## Use `--watch` while you iterate
35
45
@@ -90,7 +100,7 @@ on:
90
100
## ✅ Checkpoint
91
101
92
102
- [ ] I know what `gh aw compile` checks before a workflow runs
93
-
- [ ] I can use `--validate` for quick structure checks
103
+
- [ ] I can use `--no-emit` for quick structure checks without generating a lock file
94
104
- [ ] I can use `--watch` for live feedback while I edit
95
105
- [ ] I can spot indentation mistakes in a compile error example
96
106
- [ ] I know the first places to check when compilation fails
0 commit comments