workflow-detection

Workflow Detection Skill

Provides centralized workflow type detection for all phase and deployment commands.

Purpose

Eliminates 50+ lines of duplicated detection code across 44 commands by providing a single source of truth for workflow type detection.

Quick Reference

# Bash (Linux/Mac/Git Bash)
WORKFLOW_INFO=$(bash .spec-flow/scripts/utils/detect-workflow-paths.sh)

# PowerShell (Windows)
$workflowInfo = pwsh -File .spec-flow/scripts/utils/detect-workflow-paths.ps1

Output Format

Returns JSON with workflow information:

{
  "type": "epic",
  "base_dir": "epics",
  "slug": "001-auth-system",
  "branch": "epic/001-auth-system",
  "source": "files",
  "is_worktree": false
}

Fields

Field	Values	Description
type	epic, feature, unknown	Workflow type
base_dir	epics, specs, unknown	Base directory for artifacts
slug	string	Feature/epic identifier (e.g., 001-auth-system)
branch	string	Current git branch
source	files, branch, state, none	How type was detected
is_worktree	boolean	Whether in a git worktree

Worktree Fields (when is_worktree: true)

Field	Description
worktree_path	Absolute path to worktree
worktree_type	epic, feature, or unknown
worktree_slug	Extracted slug from worktree path

Detection Priority

1. Workspace Files (highest priority)

   • Checks for epics/*/epic-spec.md → Epic workflow
   • Checks for specs/*/spec.md → Feature workflow

2. Git Branch Pattern

   • Branch matches epic/* → Epic workflow
   • Branch matches feature/* → Feature workflow

3. Workflow State

   • Reads workflow_type from state.yaml

4. User Prompt (detection failed)

   • Returns type: unknown with exit code 1
   • Command should use AskUserQuestion as fallback

Usage in Commands

Standard Pattern (Recommended)

# In command's <process> section:

### Step 0: Workflow Type Detection

**Detect workflow type using centralized utility:**

<bash>
# Cross-platform detection
if command -v bash >/dev/null 2>&1; then
    WORKFLOW_INFO=$(bash .spec-flow/scripts/utils/detect-workflow-paths.sh 2>/dev/null)
elif command -v pwsh >/dev/null 2>&1; then
    WORKFLOW_INFO=$(pwsh -File .spec-flow/scripts/utils/detect-workflow-paths.ps1 2>/dev/null)
fi

if [ -n "$WORKFLOW_INFO" ]; then
    WORKFLOW_TYPE=$(echo "$WORKFLOW_INFO" | grep -o '"type":"[^"]*"' | cut -d'"' -f4)
    BASE_DIR=$(echo "$WORKFLOW_INFO" | grep -o '"base_dir":"[^"]*"' | cut -d'"' -f4)
    SLUG=$(echo "$WORKFLOW_INFO" | grep -o '"slug":"[^"]*"' | cut -d'"' -f4)
fi
</bash>

**If detection fails, prompt user:**

Use AskUserQuestion with options: "Epic workflow", "Feature workflow"