oh-my-ag 1.2.0

package/.agent/skills/orchestrator/scripts/parallel-run.sh

@@ -0,0 +1,330 @@
+#!/bin/bash
+# parallel-run.sh - Run multiple sub-agents in parallel
+# Usage: ./parallel-run.sh <tasks-file.yaml> [--vendor <vendor>]
+#        ./parallel-run.sh --inline "backend:task1" "frontend:task2" ...
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+SPAWN_SCRIPT="${SCRIPT_DIR}/spawn-agent.sh"
+RESULTS_DIR=".agent/results"
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+CYAN='\033[0;36m'
+NC='\033[0m'
+
+# Parse arguments
+TASKS_FILE=""
+VENDOR=""
+INLINE_MODE=false
+INLINE_TASKS=()
+WAIT_MODE=true
+
+show_help() {
+    echo "Usage: parallel-run.sh [options] <tasks-file.yaml>"
+    echo "       parallel-run.sh --inline \"agent:task\" \"agent:task\" ..."
+    echo ""
+    echo "Options:"
+    echo "  --vendor, -v     CLI vendor (gemini, claude, codex, qwen)"
+    echo "  --inline, -i     Inline mode: specify tasks as arguments"
+    echo "  --no-wait        Don't wait for completion (background mode)"
+    echo "  --help, -h       Show this help message"
+    echo ""
+    echo "Tasks file format (YAML):"
+    echo "  tasks:"
+    echo "    - agent: backend"
+    echo "      task: \"Implement auth API\""
+    echo "      workspace: ./backend"
+    echo "    - agent: frontend"
+    echo "      task: \"Create login UI\""
+    echo "      workspace: ./frontend"
+    echo ""
+    echo "Inline format:"
+    echo "  parallel-run.sh --inline \"backend:Implement auth\" \"frontend:Create login\""
+}
+
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        --vendor|-v)
+            VENDOR="$2"
+            shift 2
+            ;;
+        --inline|-i)
+            INLINE_MODE=true
+            shift
+            ;;
+        --no-wait)
+            WAIT_MODE=false
+            shift
+            ;;
+        --help|-h)
+            show_help
+            exit 0
+            ;;
+        *)
+            if [[ "$INLINE_MODE" == true ]]; then
+                INLINE_TASKS+=("$1")
+            else
+                TASKS_FILE="$1"
+            fi
+            shift
+            ;;
+    esac
+done
+
+# Create results directory
+mkdir -p "$RESULTS_DIR"
+TIMESTAMP=$(date +%Y%m%d-%H%M%S)
+RUN_DIR="${RESULTS_DIR}/parallel-${TIMESTAMP}"
+mkdir -p "$RUN_DIR"
+
+# PID list file for cleanup (especially useful for --no-wait mode)
+PID_LIST_FILE="${RUN_DIR}/pids.txt"
+
+# Track PIDs and results
+declare -A PIDS
+declare -A AGENT_NAMES
+
+# Cleanup: kill all child processes on exit
+cleanup() {
+  echo -e "\n${YELLOW}[Parallel]${NC} Cleaning up child processes..."
+  for pid in "${!PIDS[@]}"; do
+    if kill -0 "$pid" 2>/dev/null; then
+      kill "$pid" 2>/dev/null
+      echo -e "${YELLOW}[Parallel]${NC} Killed PID $pid (${AGENT_NAMES[$pid]:-unknown})"
+    fi
+  done
+  wait 2>/dev/null
+  # Remove PID list file if all processes are done
+  rm -f "$PID_LIST_FILE"
+}
+
+trap cleanup EXIT SIGINT SIGTERM
+
+echo -e "${CYAN}======================================${NC}"
+echo -e "${CYAN}  Parallel SubAgent Execution${NC}"
+echo -e "${CYAN}======================================${NC}"
+echo ""
+
+# Parse inline tasks
+parse_inline_tasks() {
+    local idx=0
+    for task_spec in "${INLINE_TASKS[@]}"; do
+        # Format: "agent:task" or "agent:task:workspace"
+        IFS=':' read -r agent task workspace <<< "$task_spec"
+        workspace="${workspace:-.}"
+
+        echo -e "${BLUE}[${idx}]${NC} Spawning ${YELLOW}${agent}${NC} agent..."
+
+        # Build vendor flag
+        VENDOR_FLAG=""
+        [[ -n "$VENDOR" ]] && VENDOR_FLAG="--vendor $VENDOR"
+
+        # Spawn in background
+        (
+            "$SPAWN_SCRIPT" "$agent" "$task" "$workspace" $VENDOR_FLAG \
+                > "${RUN_DIR}/${agent}-${idx}.log" 2>&1
+        ) &
+
+        PIDS[$!]=$idx
+        AGENT_NAMES[$!]=$agent
+        echo "$!:$agent" >> "$PID_LIST_FILE"
+        ((idx++))
+    done
+}
+
+# Parse YAML tasks file
+parse_yaml_tasks() {
+    if [[ ! -f "$TASKS_FILE" ]]; then
+        echo -e "${RED}Error: Tasks file not found: ${TASKS_FILE}${NC}"
+        exit 1
+    fi
+
+    local idx=0
+    local current_agent=""
+    local current_task=""
+    local current_workspace="."
+
+    while IFS= read -r line; do
+        # Skip empty lines and comments
+        [[ -z "$line" ]] && continue
+        [[ "$line" =~ ^[[:space:]]*# ]] && continue
+
+        # Parse agent
+        if [[ "$line" =~ agent:[[:space:]]*(.+) ]]; then
+            current_agent="${BASH_REMATCH[1]}"
+            current_agent=$(echo "$current_agent" | tr -d '"' | xargs)
+        fi
+
+        # Parse task
+        if [[ "$line" =~ task:[[:space:]]*(.+) ]]; then
+            current_task="${BASH_REMATCH[1]}"
+            current_task=$(echo "$current_task" | tr -d '"' | xargs)
+        fi
+
+        # Parse workspace
+        if [[ "$line" =~ workspace:[[:space:]]*(.+) ]]; then
+            current_workspace="${BASH_REMATCH[1]}"
+            current_workspace=$(echo "$current_workspace" | tr -d '"' | xargs)
+        fi
+
+        # Start of new task block (next - agent:)
+        if [[ "$line" =~ ^[[:space:]]*-[[:space:]]*agent: ]] && [[ -n "$current_task" ]] && [[ $idx -gt 0 ]]; then
+            # Spawn previous task
+            spawn_task "$idx" "$current_agent" "$current_task" "$current_workspace"
+            current_workspace="."
+            current_task=""
+        fi
+
+        # Check if we have a complete task
+        if [[ -n "$current_agent" ]] && [[ -n "$current_task" ]]; then
+            if [[ "$line" =~ ^[[:space:]]*-[[:space:]]*agent: ]]; then
+                ((idx++))
+            fi
+        fi
+    done < "$TASKS_FILE"
+
+    # Spawn last task
+    if [[ -n "$current_agent" ]] && [[ -n "$current_task" ]]; then
+        spawn_task "$idx" "$current_agent" "$current_task" "$current_workspace"
+    fi
+}
+
+spawn_task() {
+    local idx=$1
+    local agent=$2
+    local task=$3
+    local workspace=$4
+
+    echo -e "${BLUE}[${idx}]${NC} Spawning ${YELLOW}${agent}${NC} agent..."
+    echo -e "    Task: ${task:0:60}..."
+    echo -e "    Workspace: ${workspace}"
+
+    VENDOR_FLAG=""
+    [[ -n "$VENDOR" ]] && VENDOR_FLAG="--vendor $VENDOR"
+
+    (
+        "$SPAWN_SCRIPT" "$agent" "$task" "$workspace" $VENDOR_FLAG \
+            > "${RUN_DIR}/${agent}-${idx}.log" 2>&1
+    ) &
+
+    PIDS[$!]=$idx
+    AGENT_NAMES[$!]=$agent
+    echo "$!:$agent" >> "$PID_LIST_FILE"
+}
+
+# Alternative simpler YAML parsing for common format
+parse_yaml_simple() {
+    if [[ ! -f "$TASKS_FILE" ]]; then
+        echo -e "${RED}Error: Tasks file not found: ${TASKS_FILE}${NC}"
+        exit 1
+    fi
+
+    local idx=0
+
+    # Use grep to find task blocks
+    while IFS= read -r block; do
+        local agent=$(echo "$block" | grep -oP 'agent:\s*\K[^\s]+' | tr -d '"')
+        local task=$(echo "$block" | grep -oP 'task:\s*"\K[^"]+')
+        local workspace=$(echo "$block" | grep -oP 'workspace:\s*\K[^\s]+' | tr -d '"')
+
+        [[ -z "$workspace" ]] && workspace="."
+
+        if [[ -n "$agent" ]] && [[ -n "$task" ]]; then
+            echo -e "${BLUE}[${idx}]${NC} Spawning ${YELLOW}${agent}${NC} agent..."
+            echo -e "    Task: ${task:0:60}..."
+
+            VENDOR_FLAG=""
+            [[ -n "$VENDOR" ]] && VENDOR_FLAG="--vendor $VENDOR"
+
+            (
+                "$SPAWN_SCRIPT" "$agent" "$task" "$workspace" $VENDOR_FLAG \
+                    > "${RUN_DIR}/${agent}-${idx}.log" 2>&1
+            ) &
+
+            PIDS[$!]=$idx
+            AGENT_NAMES[$!]=$agent
+            echo "$!:$agent" >> "$PID_LIST_FILE"
+            ((idx++))
+        fi
+    done < <(awk '/^[[:space:]]*-[[:space:]]*agent:/{if(block)print block; block=$0; next} {block=block" "$0} END{print block}' "$TASKS_FILE")
+}
+
+# Execute tasks
+echo -e "${BLUE}Starting parallel execution...${NC}"
+echo ""
+
+if [[ "$INLINE_MODE" == true ]]; then
+    if [[ ${#INLINE_TASKS[@]} -eq 0 ]]; then
+        echo -e "${RED}Error: No tasks specified${NC}"
+        show_help
+        exit 1
+    fi
+    parse_inline_tasks
+else
+    if [[ -z "$TASKS_FILE" ]]; then
+        echo -e "${RED}Error: No tasks file specified${NC}"
+        show_help
+        exit 1
+    fi
+    parse_yaml_simple
+fi
+
+TOTAL_TASKS=${#PIDS[@]}
+echo ""
+echo -e "${BLUE}[Parallel]${NC} Started ${YELLOW}${TOTAL_TASKS}${NC} agents"
+
+if [[ "$WAIT_MODE" == false ]]; then
+    echo -e "${BLUE}[Parallel]${NC} Running in background mode"
+    echo -e "${BLUE}[Parallel]${NC} Results will be in: ${RUN_DIR}"
+    echo -e "${BLUE}[Parallel]${NC} PID list: ${PID_LIST_FILE}"
+    # Disable the cleanup trap so background processes keep running
+    trap - EXIT SIGINT SIGTERM
+    exit 0
+fi
+
+# Wait for all tasks and collect results
+echo -e "${BLUE}[Parallel]${NC} Waiting for completion..."
+echo ""
+
+COMPLETED=0
+FAILED=0
+
+for pid in "${!PIDS[@]}"; do
+    idx=${PIDS[$pid]}
+    agent=${AGENT_NAMES[$pid]}
+
+    if wait $pid; then
+        echo -e "${GREEN}[DONE]${NC} ${agent} agent (${idx}) completed"
+        ((COMPLETED++))
+    else
+        echo -e "${RED}[FAIL]${NC} ${agent} agent (${idx}) failed"
+        ((FAILED++))
+    fi
+done
+
+# Summary
+echo ""
+echo -e "${CYAN}======================================${NC}"
+echo -e "${CYAN}  Execution Summary${NC}"
+echo -e "${CYAN}======================================${NC}"
+echo -e "Total:     ${TOTAL_TASKS}"
+echo -e "Completed: ${GREEN}${COMPLETED}${NC}"
+echo -e "Failed:    ${RED}${FAILED}${NC}"
+echo -e "Results:   ${RUN_DIR}"
+echo -e "${CYAN}======================================${NC}"
+
+# List result files
+echo ""
+echo -e "${BLUE}Result files:${NC}"
+for f in "${RUN_DIR}"/*.log; do
+    [[ -f "$f" ]] && echo "  - $f"
+done
+
+# Exit with error if any failed
+[[ $FAILED -gt 0 ]] && exit 1
+exit 0

package/.agent/skills/orchestrator/scripts/spawn-agent.sh

@@ -0,0 +1,263 @@
+#!/bin/bash
+# spawn-agent.sh - Spawn a sub-agent using configured CLI vendor
+# Usage: ./spawn-agent.sh <agent-type> <task-description> [workspace] [--vendor <vendor>]
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+CONFIG_FILE="${SCRIPT_DIR}/../config/cli-config.yaml"
+RESULTS_DIR=".agent/results"
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# Parse arguments
+AGENT_TYPE=""
+TASK=""
+WORKSPACE="."
+VENDOR=""
+
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        --vendor|-v)
+            VENDOR="$2"
+            shift 2
+            ;;
+        --help|-h)
+            echo "Usage: spawn-agent.sh <agent-type> <task> [workspace] [--vendor <vendor>]"
+            echo ""
+            echo "Arguments:"
+            echo "  agent-type    Type of agent (backend, frontend, mobile, qa, debug)"
+            echo "  task          Task description or path to task file"
+            echo "  workspace     Working directory for the agent (default: current)"
+            echo ""
+            echo "Options:"
+            echo "  --vendor, -v  CLI vendor (gemini, claude, codex, qwen)"
+            echo "  --help, -h    Show this help message"
+            exit 0
+            ;;
+        *)
+            if [[ -z "$AGENT_TYPE" ]]; then
+                AGENT_TYPE="$1"
+            elif [[ -z "$TASK" ]]; then
+                TASK="$1"
+            else
+                WORKSPACE="$1"
+            fi
+            shift
+            ;;
+    esac
+done
+
+# Validate arguments
+if [[ -z "$AGENT_TYPE" ]] || [[ -z "$TASK" ]]; then
+    echo -e "${RED}Error: agent-type and task are required${NC}"
+    echo "Usage: spawn-agent.sh <agent-type> <task> [workspace] [--vendor <vendor>]"
+    exit 1
+fi
+
+# Read config using grep/sed (no yq dependency)
+get_config() {
+    local key="$1"
+    grep -E "^${key}:" "$CONFIG_FILE" 2>/dev/null | sed 's/^[^:]*: *//' | tr -d '"'
+}
+
+get_vendor_config() {
+    local vendor="$1"
+    local key="$2"
+    # Simple YAML parsing for nested values
+    awk -v vendor="$vendor" -v key="$key" '
+        /^  [a-z]+:$/ { current_vendor = $1; gsub(/:/, "", current_vendor) }
+        current_vendor == vendor && $1 == key":" { gsub(/^[^:]*: */, ""); gsub(/"/, ""); print }
+    ' "$CONFIG_FILE"
+}
+
+# Get CLI for specific agent type from user-preferences.yaml
+get_agent_cli() {
+    local agent_type="$1"
+    local prefs="${SCRIPT_DIR}/../../config/user-preferences.yaml"
+    if [[ -f "$prefs" ]]; then
+        grep -A10 "^agent_cli_mapping:" "$prefs" 2>/dev/null | \
+            grep "^  ${agent_type}:" | \
+            sed 's/^[^:]*: *//' | tr -d '"' | xargs
+    fi
+}
+
+# Get default CLI from user-preferences.yaml
+get_default_cli() {
+    local prefs="${SCRIPT_DIR}/../../config/user-preferences.yaml"
+    if [[ -f "$prefs" ]]; then
+        grep "^default_cli:" "$prefs" 2>/dev/null | sed 's/^[^:]*: *//' | tr -d '"' | xargs
+    fi
+}
+
+# Get vendor from (in priority order):
+# 1) command line arg (--vendor)
+# 2) agent_cli_mapping from user-preferences.yaml
+# 3) default_cli from user-preferences.yaml
+# 4) active_vendor from cli-config.yaml (legacy/fallback)
+# 5) hardcoded "gemini"
+if [[ -z "$VENDOR" ]]; then
+    VENDOR=$(get_agent_cli "$AGENT_TYPE")
+fi
+
+if [[ -z "$VENDOR" ]]; then
+    VENDOR=$(get_default_cli)
+fi
+
+if [[ -z "$VENDOR" ]]; then
+    VENDOR=$(get_config "active_vendor")
+fi
+
+if [[ -z "$VENDOR" ]]; then
+    VENDOR="gemini"
+fi
+
+echo -e "${BLUE}[SubAgent]${NC} Spawning ${YELLOW}${AGENT_TYPE}${NC} agent with ${GREEN}${VENDOR}${NC} CLI"
+
+# Get vendor-specific configuration
+CLI_CMD=$(get_vendor_config "$VENDOR" "command")
+PROMPT_FLAG=$(get_vendor_config "$VENDOR" "prompt_flag")
+OUTPUT_FLAG=$(get_vendor_config "$VENDOR" "output_format_flag")
+OUTPUT_FORMAT=$(get_vendor_config "$VENDOR" "output_format")
+AUTO_FLAG=$(get_vendor_config "$VENDOR" "auto_approve_flag")
+RESPONSE_JQ=$(get_vendor_config "$VENDOR" "response_jq")
+
+# Fallback defaults
+CLI_CMD="${CLI_CMD:-$VENDOR}"
+PROMPT_FLAG="${PROMPT_FLAG:--p}"
+OUTPUT_FORMAT="${OUTPUT_FORMAT:-json}"
+RESPONSE_JQ="${RESPONSE_JQ:-.response}"
+
+# Check if CLI is available
+if ! command -v "$CLI_CMD" &> /dev/null; then
+    echo -e "${RED}Error: ${CLI_CMD} CLI not found in PATH${NC}"
+    echo "Please install ${VENDOR} CLI and ensure it's authenticated"
+    exit 1
+fi
+
+# Create results directory
+mkdir -p "$RESULTS_DIR"
+
+# Generate unique result filename
+TIMESTAMP=$(date +%Y%m%d-%H%M%S)
+RESULT_FILE="${RESULTS_DIR}/${AGENT_TYPE}-${TIMESTAMP}.json"
+OUTPUT_FILE="${RESULTS_DIR}/${AGENT_TYPE}-${TIMESTAMP}.md"
+
+# If task is a file path, read its contents
+if [[ -f "$TASK" ]]; then
+    TASK_CONTENT=$(cat "$TASK")
+else
+    TASK_CONTENT="$TASK"
+fi
+
+# Load agent-specific template if exists
+TEMPLATE_FILE="${SCRIPT_DIR}/../templates/${AGENT_TYPE}-task.md"
+if [[ -f "$TEMPLATE_FILE" ]]; then
+    TEMPLATE=$(cat "$TEMPLATE_FILE")
+    TASK_CONTENT="${TEMPLATE}
+
+## Current Task
+${TASK_CONTENT}"
+fi
+
+# Build command based on vendor
+build_command() {
+    local cmd="$CLI_CMD"
+
+    case "$VENDOR" in
+        gemini)
+            cmd="$cmd $PROMPT_FLAG \"$TASK_CONTENT\""
+            [[ -n "$OUTPUT_FLAG" ]] && cmd="$cmd $OUTPUT_FLAG $OUTPUT_FORMAT"
+            [[ -n "$AUTO_FLAG" ]] && cmd="$cmd $AUTO_FLAG"
+            ;;
+        claude)
+            cmd="$cmd $PROMPT_FLAG \"$TASK_CONTENT\""
+            [[ -n "$OUTPUT_FLAG" ]] && cmd="$cmd $OUTPUT_FLAG $OUTPUT_FORMAT"
+            [[ -n "$AUTO_FLAG" ]] && cmd="$cmd $AUTO_FLAG"
+            # Isolation flags
+            cmd="$cmd --setting-sources \"\""
+            ;;
+        codex)
+            # Set isolation environment
+            export CODEX_HOME="/tmp/codex-subagent-$$"
+            mkdir -p "$CODEX_HOME"
+            cmd="$cmd $PROMPT_FLAG \"$TASK_CONTENT\""
+            [[ -n "$AUTO_FLAG" ]] && cmd="$cmd $AUTO_FLAG"
+            ;;
+        qwen)
+            cmd="$cmd $PROMPT_FLAG \"$TASK_CONTENT\""
+            [[ -n "$OUTPUT_FLAG" ]] && cmd="$cmd $OUTPUT_FLAG $OUTPUT_FORMAT"
+            [[ -n "$AUTO_FLAG" ]] && cmd="$cmd $AUTO_FLAG"
+            ;;
+        *)
+            # Generic fallback
+            cmd="$cmd $PROMPT_FLAG \"$TASK_CONTENT\""
+            ;;
+    esac
+
+    echo "$cmd"
+}
+
+# Execute in workspace
+echo -e "${BLUE}[SubAgent]${NC} Working directory: ${WORKSPACE}"
+echo -e "${BLUE}[SubAgent]${NC} Task: ${TASK_CONTENT:0:100}..."
+
+cd "$WORKSPACE"
+
+# Build and execute command
+CMD=$(build_command)
+echo -e "${BLUE}[SubAgent]${NC} Executing: ${CLI_CMD} ..."
+
+# Execute and capture output
+set +e
+if [[ "$OUTPUT_FORMAT" == "json" ]]; then
+    eval "$CMD" > "$RESULT_FILE" 2>&1
+    EXIT_CODE=$?
+
+    if [[ $EXIT_CODE -eq 0 ]] && [[ -s "$RESULT_FILE" ]]; then
+        # Extract response from JSON
+        if command -v jq &> /dev/null; then
+            jq -r "$RESPONSE_JQ" "$RESULT_FILE" > "$OUTPUT_FILE" 2>/dev/null || \
+                cat "$RESULT_FILE" > "$OUTPUT_FILE"
+        else
+            cat "$RESULT_FILE" > "$OUTPUT_FILE"
+        fi
+        echo -e "${GREEN}[SubAgent]${NC} Completed successfully"
+        echo -e "${GREEN}[SubAgent]${NC} Result: ${OUTPUT_FILE}"
+    else
+        echo -e "${RED}[SubAgent]${NC} Failed with exit code: ${EXIT_CODE}"
+        cat "$RESULT_FILE"
+        exit $EXIT_CODE
+    fi
+else
+    eval "$CMD" > "$OUTPUT_FILE" 2>&1
+    EXIT_CODE=$?
+
+    if [[ $EXIT_CODE -eq 0 ]]; then
+        echo -e "${GREEN}[SubAgent]${NC} Completed successfully"
+        echo -e "${GREEN}[SubAgent]${NC} Result: ${OUTPUT_FILE}"
+    else
+        echo -e "${RED}[SubAgent]${NC} Failed with exit code: ${EXIT_CODE}"
+        exit $EXIT_CODE
+    fi
+fi
+set -e
+
+# Output summary
+echo ""
+echo -e "${BLUE}========================================${NC}"
+echo -e "${GREEN}SubAgent Execution Summary${NC}"
+echo -e "${BLUE}========================================${NC}"
+echo -e "Agent Type: ${YELLOW}${AGENT_TYPE}${NC}"
+echo -e "Vendor:     ${GREEN}${VENDOR}${NC}"
+echo -e "Workspace:  ${WORKSPACE}"
+echo -e "Result:     ${OUTPUT_FILE}"
+echo -e "${BLUE}========================================${NC}"
+
+# Return the output file path
+echo "$OUTPUT_FILE"

package/.agent/skills/orchestrator/templates/backend-task.md

@@ -0,0 +1,18 @@
+# Backend SubAgent Task
+
+You are a Backend specialist. Focus only on the task below.
+
+## Guidelines
+- Use FastAPI with async/await
+- SQLAlchemy for database operations
+- Pydantic for validation
+- JWT for authentication
+- Follow REST conventions
+- Include error handling
+- Write tests for new code
+
+## Output Requirements
+- Implement the requested functionality
+- Create/modify necessary files
+- Add appropriate tests
+- Document API endpoints if created

package/.agent/skills/orchestrator/templates/debug-task.md

@@ -0,0 +1,16 @@
+# Debug SubAgent Task
+
+You are a Debug specialist. Focus only on fixing the bug below.
+
+## Approach
+1. Reproduce the issue
+2. Identify root cause
+3. Implement fix
+4. Add regression test
+5. Document the fix
+
+## Output Requirements
+- Explain the root cause
+- Show before/after code
+- Include regression test
+- List related patterns to check

package/.agent/skills/orchestrator/templates/frontend-task.md

@@ -0,0 +1,17 @@
+# Frontend SubAgent Task
+
+You are a Frontend specialist. Focus only on the task below.
+
+## Guidelines
+- React with TypeScript
+- TailwindCSS for styling
+- React Query for data fetching
+- Proper loading/error states
+- Accessible components (WCAG 2.1 AA)
+- Mobile-responsive design
+
+## Output Requirements
+- Implement the requested UI/feature
+- Create/modify necessary components
+- Add component tests if appropriate
+- Ensure responsive behavior

package/.agent/skills/orchestrator/templates/mobile-task.md

@@ -0,0 +1,17 @@
+# Mobile SubAgent Task
+
+You are a Mobile specialist. Focus only on the task below.
+
+## Guidelines
+- Flutter with Dart
+- Clean Architecture (presentation/domain/data)
+- Riverpod for state management
+- Platform-aware UI components
+- Proper navigation handling
+- Offline-first when applicable
+
+## Output Requirements
+- Implement the requested screen/feature
+- Create/modify necessary files
+- Handle both iOS and Android
+- Test on multiple screen sizes

package/.agent/skills/orchestrator/templates/qa-task.md

@@ -0,0 +1,16 @@
+# QA SubAgent Task
+
+You are a QA specialist. Focus only on the review below.
+
+## Review Checklist
+- Security (OWASP Top 10)
+- Performance (bundle size, API latency)
+- Accessibility (WCAG 2.1 AA)
+- Code quality (complexity, duplication)
+- Test coverage
+
+## Output Requirements
+- List issues found with severity (CRITICAL/HIGH/MEDIUM/LOW)
+- Provide specific file:line references
+- Suggest fixes for each issue
+- Prioritize actionable feedback

package/.agent/skills/orchestrator/templates/tasks-example.yaml

@@ -0,0 +1,15 @@
+# Example parallel tasks file
+# Usage: ./parallel-run.sh tasks-example.yaml
+
+tasks:
+  - agent: backend
+    task: "Implement JWT authentication with register and login endpoints"
+    workspace: ./backend
+
+  - agent: frontend
+    task: "Create login and registration forms with validation"
+    workspace: ./frontend
+
+  - agent: mobile
+    task: "Build authentication screens for iOS and Android"
+    workspace: ./mobile