critical-path

Critical Path Command

Test must-work user journeys. Critical paths are essential flows that must always work - if they fail, users can't accomplish core tasks.

Arguments

Parse the following from $ARGUMENTS:

• --url <url> (required): Base URL for testing
• --path <name> (optional): Run specific path only (default: all paths)
• --persona <id> (optional): Override default persona for all paths
• --quiet (optional): Summary only output
• --fail-fast (optional): Stop on first failure
• --record (optional): Record sessions as Playwright Traces
• --record-path <path> (optional): Custom trace output path
• --viewport <mobile|tablet|desktop> (optional): Device viewport size (default: desktop)
• --output <markdown|json> (optional): Report output format (default: markdown)
• --network <slow-3g|fast-3g|offline> (optional): Network throttling preset
• --pr <number> (optional): Post results as GitHub PR comment

Defining Critical Paths

Create .claude/critical-paths.json in your project:

{
  "paths": [
    {
      "name": "purchase-flow",
      "description": "Complete purchase from browse to confirmation",
      "persona": "impulse-buyer",
      "priority": "critical",
      "steps": [
        { "action": "navigate", "to": "/" },
        { "action": "task", "do": "find and select a product" },
        { "action": "task", "do": "add to cart" },
        { "action": "task", "do": "proceed to checkout" },
        { "action": "task", "do": "complete guest checkout" },
        { "action": "verify", "element": "order confirmation number" }
      ]
    },
    {
      "name": "account-creation",
      "description": "New user registration flow",
      "persona": "genz-digital-native",
      "priority": "critical",
      "steps": [
        { "action": "navigate", "to": "/signup" },
        { "action": "task", "do": "complete signup form" },
        { "action": "task", "do": "submit registration" },
        { "action": "verify", "element": "welcome message or dashboard" }
      ]
    },
    {
      "name": "password-reset",
      "description": "Password recovery flow",
      "persona": "boomer-tech-averse",
      "priority": "high",
      "steps": [
        { "action": "navigate", "to": "/login" },
        { "action": "task", "do": "find forgot password link" },
        { "action": "task", "do": "enter email address" },
        { "action": "task", "do": "submit reset request" },
        { "action": "verify", "element": "confirmation message" }
      ]
    }
  ]
}