asc-workflow

asc workflow

Use this skill when you need lane-style automation inside the CLI using:

• asc workflow validate
• asc workflow list
• asc workflow run

Workflows are repo-local automation files. They run trusted shell commands, stream step output to stderr, and keep stdout as machine-readable JSON.

Command discovery

Always verify flags with:

asc workflow --help
asc workflow validate --help
asc workflow list --help
asc workflow run --help

End-to-end flow

1. Author .asc/workflow.json.
2. Validate structure and references:

asc workflow validate

1. Discover public workflows:

asc workflow list
asc workflow list --all

1. Preview execution:

asc workflow run --dry-run beta BUILD_ID:123456789 GROUP_ID:abcdef

1. Execute:

asc workflow run beta BUILD_ID:123456789 GROUP_ID:abcdef

1. If a recoverable run fails, resume with the run ID from the JSON result:

asc workflow run release --resume "release-20260312T120000Z-deadbeef"

Do not pass extra KEY:VALUE params with --resume; the saved workflow file, params, and persisted outputs are reused.

File location and format

• Default path: .asc/workflow.json
• Override path: asc workflow run --file ./path/to/workflow.json <name>
• JSONC comments are supported.
• Top-level hooks: before_all, after_all, error
• Workflow keys: description, private, env, steps
• Step forms:
  • string shorthand: "echo hello"
  • run shell command
  • workflow sub-workflow call
  • name label
  • if conditional var name
  • with env overrides for workflow-call steps
  • outputs map for JSON stdout extraction from named run steps

Outputs

Run steps can declare outputs. The command must emit JSON on stdout, so pass --output json for asc commands that produce outputs.

Output references use:

${steps.step_name.OUTPUT_NAME}

Rules:

• A step that declares outputs must have a reference-safe name.
• Outputs are allowed on run steps, not workflow-call steps.
• Output-producing names must be unique across workflows that can execute together in the same run graph.
• Persisted outputs are stored in workflow run state, so do not map secrets into outputs.