load

Spec Load Command (/workflow:spec:load)

Overview

Interactive entry point for loading and browsing project specs. Asks the user what they need, then routes to the appropriate spec content based on keywords, type filters, or tag filters.

Design: Menu-driven → keyword match → load & display. No file modifications.

Note: This command may be called by other workflow commands. Upon completion, return immediately to continue the calling workflow.

Usage

/workflow:spec:load                    # Interactive menu
/workflow:spec:load "api routing"      # Direct keyword search
/workflow:spec:load --type bug         # Filter by knowledge type
/workflow:spec:load --tag security     # Filter by domain tag
/workflow:spec:load --all              # Load all specs

Execution Process

Input Parsing:
   ├─ Parse --all flag → loadAll = true | false
   ├─ Parse --type (bug|pattern|decision|rule)
   ├─ Parse --tag (domain tag)
   └─ Parse keyword query (positional text)

Decision:
   ├─ --all → Load all specs (Path C)
   ├─ --type or --tag or keyword → Direct filter (Path B)
   └─ No args → Interactive menu (Path A)

Path A: Interactive Menu
   ├─ Step A1: Ask user intent
   ├─ Step A2: Route to action
   └─ Step A3: Display results

Path B: Direct Filter
   ├─ Step B1: Build filter from args
   ├─ Step B2: Search specs
   └─ Step B3: Display results

Path C: Load All
   └─ Display all spec contents

Output:
   └─ Formatted spec entries matching user query

Implementation

Step 1: Parse Input

const args = $ARGUMENTS
const argsLower = args.toLowerCase()

const loadAll = argsLower.includes('--all')
const hasType = argsLower.includes('--type')
const hasTag = argsLower.includes('--tag')

let type = hasType ? args.match(/--type\s+(\w+)/i)?.[1]?.toLowerCase() : null
let tag = hasTag ? args.match(/--tag\s+([\w-]+)/i)?.[1]?.toLowerCase() : null

// Extract keyword query (everything that's not a flag)
let keyword = args
  .replace(/--type\s+\w+/gi, '')
  .replace(/--tag\s+[\w-]+/gi, '')
  .replace(/--all/gi, '')
  .replace(/^["']|["']$/g, '')
  .trim()

// Validate type
if (type && !['bug', 'pattern', 'decision', 'rule'].includes(type)) {
  console.log("Invalid type. Use 'bug', 'pattern', 'decision', or 'rule'.")
  return
}