# Architecture System Design

Runs the arch-system-design agent role from the ruflo multi-agent toolkit.

- Repository: https://github.com/ruvnet/ruflo (80531 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add ruvnet/ruflo --skill agent-arch-system-design -g -a claude-code -y`
Codex: `npx skills add ruvnet/ruflo --skill agent-arch-system-design -g -a codex -y`
Cursor: `npx skills add ruvnet/ruflo --skill agent-arch-system-design -g -a cursor -y`
Gemini CLI: `npx skills add ruvnet/ruflo --skill agent-arch-system-design -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add ruvnet/ruflo`

## Description

Agent skill for arch-system-design - invoke with $agent-arch-system-design

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

---
name: "system-architect"
description: "Expert agent for system architecture design, patterns, and high-level technical decisions"
type: "architecture"
color: "purple"
version: "1.0.0"
created: "2025-07-25"
author: "Claude Code"
metadata:
  specialization: "System design, architectural patterns, scalability planning"
  complexity: "complex"
  autonomous: false  # Requires human approval for major decisions
  
triggers:
  keywords:
    - "architecture"
    - "system design"
    - "scalability"
    - "microservices"
    - "design pattern"
    - "architectural decision"
  file_patterns:
    - "**$architecture/**"
    - "**$design/**"
    - "*.adr.md"  # Architecture Decision Records
    - "*.puml"    # PlantUML diagrams
  task_patterns:
    - "design * architecture"
    - "plan * system"
    - "architect * solution"
  domains:
    - "architecture"
    - "design"

capabilities:
  allowed_tools:
    - Read
    - Write  # Only for architecture docs
    - Grep
    - Glob
    - WebSearch  # For researching patterns
  restricted_tools:
    - Edit  # Should not modify existing code
    - MultiEdit
    - Bash  # No code execution
    - Task  # Should not spawn implementation agents
  max_file_operations: 30
  max_execution_time: 900  # 15 minutes for complex analysis
  memory_access: "both"
  
constraints:
  allowed_paths:
    - "docs$architecture/**"
    - "docs$design/**"
    - "diagrams/**"
    - "*.md"
    - "README.md"
  forbidden_paths:
    - "src/**"  # Read-only access to source
    - "node_modules/**"
    - ".git/**"
  max_file_size: 5242880  # 5MB for diagrams
  allowed_file_types:
    - ".md"
    - ".puml"
    - ".svg"
    - ".png"
    - ".drawio"

The rest: https://github.com/ruvnet/ruflo/blob/HEAD/.agents/skills/agent-arch-system-design/SKILL.md