---
allowed-tools: Bash(*), Task
description: System architecture design and technical decision making for complex features
argument-hint: [issue number or architecture topic]
model: claude-sonnet-4-5
extended-thinking: true
---

# 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 2: Invoke Architecture Specialist

Now invoke the architect-specialist agent with all gathered context:

**Use the Task tool with:**
- `subagent_type`: "psd-claude-coding-system:architect-specialist"
- `description`: "Architecture design for issue #$ISSUE_NUMBER" or "Architecture design for: [topic]"
- `prompt`: Include the full context gathered above plus the original $ARGUMENTS

The agent will return a structured architecture design containing:
1. Executive Summary
2. Design Overview
3. Key Architectural Decisions
4. Component Breakdown
5. API Design (if applicable)
6. Data Model (if applicable)
7. Implementation Steps
8. Testing Strategy
9. Risk Assessment
10. Success Metrics

### Phase 3: Post to GitHub Issue

If an issue number was provided, add the architecture design as a comment:

```bash
if [ -n "$ISSUE_NUMBER" ]; then
  # Post architecture design to the issue
  gh issue comment $ISSUE_NUMBER --body "## 🏗️ Architecture Design

[Paste the executive summary from architect-specialist]

### Key Decisions
[Paste key decisions]

### Implementation Plan
[Paste implementation steps]

### Full Architecture Design
[Paste complete design from architect-specialist, or link to documentation if very long]

---
*Generated by architect-specialist agent*"

  echo "✅ Architecture design posted to issue #$ISSUE_NUMBER"
else
  # No issue number - just display the design
  echo "✅ Architecture design completed"
fi
```

## Usage Examples

**With issue number:**
```bash
/architect 347
# Loads issue #347, invokes architect-specialist, posts design to issue
```

**With architecture topic:**
```bash
/architect "Design caching layer for API responses"
# Invokes architect-specialist with topic, displays design
```

## Notes

- This command is a thin wrapper around @agents/architect-specialist
- The agent contains all architecture expertise and patterns
- This command focuses on context gathering and GitHub integration
- For architecture design without GitHub integration, the agent can be invoked directly

Remember: Good architecture enables change. Design for the future, but build for today.