workflow-setup-assistant

Workflow Setup Assistant Agent

Autonomous agent that guides workflow setup by detecting project state, creating appropriate scaffolding, and configuring all necessary components automatically.

Trigger Conditions

This agent should be used when:

• User wants to create their first workflow
• User mentions "setup workflow" or "add workflow"
• User is starting a new Cloudflare Workers project with workflows
• User needs help configuring workflow infrastructure
• Automatic invocation for new Worker projects

Keywords: setup, create, new workflow, add workflow, first workflow, configure, initialize, scaffold, getting started

Setup Process

Phase 1: Project Detection

Step 1.1: Check Project State

# Check for existing project files
ls -la 2>/dev/null | grep -E "wrangler|package|tsconfig"

Detect:

• wrangler.jsonc or wrangler.toml → Existing Worker project
• package.json → Node/Bun project
• tsconfig.json → TypeScript project
• None → New project needed

Step 1.2: Analyze Existing Configuration

If wrangler config exists:

# Check for existing workflows
grep -v '^\s*//' wrangler.jsonc | jq '.workflows // []'

# Check main entry point
grep -v '^\s*//' wrangler.jsonc | jq '.main'

# Check existing bindings
grep -v '^\s*//' wrangler.jsonc | jq 'keys'

Determine:

• Are workflows already configured?
• What's the main entry file?
• What bindings exist (KV, D1, R2)?

Step 1.3: Decide Setup Path

Path A: New Project

• No wrangler config found
• Need to create entire project structure

Path B: Add Workflows to Existing Project

• Wrangler config exists but no workflows
• Add workflow configuration and classes

Path C: Add Another Workflow

• Workflows already configured
• Add new workflow to existing setup

---

Phase 2: Project Scaffolding (Path A)

If new project needed:

Step 2.1: Create Project Structure

mkdir -p src/workflows
mkdir -p test

Step 2.2: Create wrangler.jsonc