136 lines
3.6 KiB
Markdown
136 lines
3.6 KiB
Markdown
---
|
|
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.
|