workflows-run

Run SDLC Workflow

Execute a named SDLC workflow via the Archon CLI.

Arguments

• First argument: workflow name (e.g., sdlc-parallel-review)
• Remaining arguments: passed through to Archon as workflow arguments

Steps

1. Verify Archon is installed and on PATH

The upstream installer places archon at ~/.bun/bin/archon, which is not on the default macOS PATH. Distinguish between truly missing and "installed but not discoverable":

if command -v archon >/dev/null 2>&1; then
    :  # on PATH — proceed
elif [ -x "$HOME/.bun/bin/archon" ]; then
    echo "Archon is installed at ~/.bun/bin/archon but that directory"
    echo "is not on your PATH. For this session, run:"
    echo ""
    echo "    export PATH=\"\$HOME/.bun/bin:\$PATH\""
    echo ""
    echo "For a permanent fix (recommended):"
    echo "    echo 'export PATH=\"\$HOME/.bun/bin:\$PATH\"' >> ~/.zshrc"
    echo "    # then open a new terminal"
    echo ""
    echo "Or re-run /sdlc-workflows:workflows-setup --health-check to"
    echo "diagnose."
    exit 1
else
    echo "Archon is not installed. Run /sdlc-workflows:workflows-setup first."
    exit 1
fi

Do NOT silently fall back to $HOME/.bun/bin/archon — that hides the real problem (PATH misconfiguration) and the user will hit it again the next time they open a shell. Fix the environment, not the symptom.

2. Verify workflow exists

Run archon workflow list 2>/dev/null and check if the requested workflow name appears.

If not found:

Workflow '{name}' not found. Available workflows:
{list from archon workflow list}

To install SDLC workflows, run /sdlc-workflows:workflows-setup

2b. Preprocess for containerised execution (if workflow has team images)

Check if any node in the workflow has an image: field:

python3 -c "
import yaml
from pathlib import Path
wf = yaml.safe_load(Path('.archon/workflows/<workflow-name>.yaml').read_text())
has_images = any('image' in n for n in wf.get('nodes', []))
print('NEEDS_PREPROCESSING' if has_images else 'NATIVE')
"