workflow-health

/workflow-health — Workflow Health Dashboard

Purpose: Aggregate metrics across all completed epics to show workflow system health, velocity trends, and continuous improvement effectiveness.

Command: /workflow-health [--detailed | --trends | --compare]

When to use:

• Check workflow system health across all epics
• Identify velocity trends over time
• Measure ROI of workflow improvements
• Compare epic performance

---

Workflow Health Analysis

Step 1: Discover Completed Epics

Scan for all epic workspaces:

EPIC_DIRS=$(find epics -maxdepth 1 -type d -name '[0-9]*' | sort)
EPIC_COUNT=$(echo "$EPIC_DIRS" | wc -l)

Filter for completed epics:

COMPLETED_EPICS=()
for dir in $EPIC_DIRS; do
  if grep -q "status: completed" "$dir/state.yaml"; then
    COMPLETED_EPICS+=("$dir")
  fi
done

COMPLETED_COUNT=${#COMPLETED_EPICS[@]}

Step 2: Aggregate Core Metrics

For each completed epic, extract:

const epicMetrics = [];

for (const epicDir of completedEpics) {
  const state = readYAML(`${epicDir}/state.yaml`);
  const audit = readXML(`${epicDir}/audit-report.xml`); // if exists
  const walkthrough = readXML(`${epicDir}/walkthrough.md`); // if exists

  epicMetrics.push({
    number: extractNumber(epicDir),
    slug: extractSlug(epicDir),
    start_date: state.created_at,
    end_date: state.completed_at,
    duration_hours: calculateDuration(state),
    velocity_multiplier: audit?.velocity_impact?.actual_multiplier || "N/A",
    sprint_count: state.sprints?.length || 0,
    tasks_completed: state.tasks_completed || 0,
    quality_score: audit?.overall_score || "N/A",
    improvements_applied: countHealingReports(epicDir),
  });
}

Step 3: Calculate Aggregate Statistics

Velocity trends:

const velocityStats = {
  average: calculateAverage(epicMetrics.map((e) => e.velocity_multiplier)),
  trend: calculateTrend(epicMetrics.map((e) => e.velocity_multiplier)),
  best: Math.max(...epicMetrics.map((e) => e.velocity_multiplier)),
  worst: Math.min(...epicMetrics.map((e) => e.velocity_multiplier)),
};

// Trend calculation
// Positive = improving over time
// Negative = degrading over time
const trend = linearRegression(
  epicMetrics.map((e, i) => ({ x: i, y: e.velocity_multiplier }))
).slope;