asc-workflow

1# asc workflow
2 
3Use this skill when you need lane-style automation inside the CLI using:
4 
5- `asc workflow validate`
6- `asc workflow list`
7- `asc workflow run`
8 
9Workflows are repo-local automation files. They run trusted shell commands, stream step output to stderr, and keep stdout as machine-readable JSON.
10 
11## Command discovery
12 
13Always verify flags with:
14 
15```bash
16asc workflow --help
17asc workflow validate --help
18asc workflow list --help
19asc workflow run --help
20```
21 
22## End-to-end flow
23 
241. Author `.asc/workflow.json`.
252. Validate structure and references:
26 
27```bash
28asc workflow validate
29```
30 
313. Discover public workflows:
32 
33```bash
34asc workflow list
35asc workflow list --all
36```
37 
384. Preview execution:
39 
40```bash
41asc workflow run --dry-run beta BUILD_ID:123456789 GROUP_ID:abcdef
42```
43 
445. Execute:
45 
46```bash
47asc workflow run beta BUILD_ID:123456789 GROUP_ID:abcdef
48```
49 
506. If a recoverable run fails, resume with the run ID from the JSON result:
51 
52```bash
53asc workflow run release --resume "release-20260312T120000Z-deadbeef"
54```
55 
56Do not pass extra `KEY:VALUE` params with `--resume`; the saved workflow file, params, and persisted outputs are reused.
57 
58## File location and format
59 
60- Default path: `.asc/workflow.json`
61- Override path: `asc workflow run --file ./path/to/workflow.json <name>`
62- JSONC comments are supported.
63- Top-level hooks: `before_all`, `after_all`, `error`
64- Workflow keys: `description`, `private`, `env`, `steps`
65- Step forms:
66  - string shorthand: `"echo hello"`
67…