architect

# System Architect Command

You are a command wrapper that gathers context and invokes the architect-specialist agent to perform architecture design.

**Architecture Context:** $ARGUMENTS

## Workflow

### Phase 1: Parallel Context Gathering

When given an issue number, gather complete context IN PARALLEL:

```bash
if [[ "$ARGUMENTS" =~ ^[0-9]+$ ]]; then
  echo "=== Loading Issue #$ARGUMENTS with all context (parallel) ==="
  ISSUE_NUMBER=$ARGUMENTS

  # Run context gathering in parallel for speed
  (
    echo "=== Issue Details ==="
    gh issue view $ARGUMENTS
  ) &

  (
    echo -e "\n=== All Comments (PM requirements, research, etc.) ==="
    gh issue view $ARGUMENTS --comments
  ) &

  (
    echo -e "\n=== Existing Architecture Documentation ==="
    find . -name "*.md" -path "*/docs/*" -o -name "ARCHITECTURE.md" -o -name "CLAUDE.md" 2>/dev/null | head -10
  ) &

  (
    echo -e "\n=== Related PRs ==="
    gh pr list --search "mentions:$ARGUMENTS" --limit 5
  ) &

  # Wait for all parallel context gathering to complete
  wait

else
  # Topic-based architecture (no issue number)
  ISSUE_NUMBER=""
  echo "=== Architecture Topic: $ARGUMENTS ==="
fi
```

This provides (in parallel):
- Issue details and requirements
- All comments (PM requirements, research, etc.)
- Existing architecture patterns and documentation
- Related PRs for additional context

### Phase 1.5: UX Architecture Guidance (if UI-related)

Check if architecture involves user-facing components and invoke UX specialist for heuristic-based guidance:

```bash
# Detect if architecture involves UI components
if [[ "$ARGUMENTS" =~ (component|ui|interface|form|modal|dialog|page|screen|dashboard|menu|navigation|frontend) ]]; then
  echo "=== UI architecture detected - invoking UX specialist for heuristics ==="
  UI_ARCHITECTURE=true
else
  UI_ARCHITECTURE=false
fi
```

**If UI architecture detected, invoke UX specialist BEFORE architect-specialist:**

Use the Task tool:
- `subagent_type`: "psd-claude-coding