Agent Arch System Design

CommunityPopular

ruvnet

agent-arch-system-design

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

Overview

Publisher	ruvnet
Repository	`ruflo`
Skill name	`agent-arch-system-design`
Stars	73.6K
Forks	8.7K
Bundled files	Instructions only
License	MIT
Links	Skill source Repository Homepage

Markdown instructions
A SKILL.md file the model loads on demand, so it only costs tokens when a request actually matches.
Works with any LLM
AI skills are plain Markdown, not provider-specific code, so this works with GPT, Claude, Gemini, Grok, or a local model.
Self-contained
Everything the model needs lives in the instructions — no extra files to sync.
Open source
Published by ruvnet on GitHub. Read the source before you install it.

Installation

Install the Agent Arch System Design AI skill in TypingMind to use it with any LLM, or drop it into another agent that reads SKILL.md.

Install in TypingMind

TypingMind installs a skill straight from its GitHub folder — it reads SKILL.md, bundles the resource files, and stores the result locally.

Open the app and go to Plugins → Skills.
Choose "Install from GitHub".
Paste the skill folder URL below and confirm.
https://github.com/ruvnet/ruflo/tree/main/.agents/skills/agent-arch-system-design
Enable the skill in any chat where you want it available.

Plugins → Skills → Add skill → From GitHub URL, then paste the folder URL and press Continue.

Install in another agent

Any agent that reads the Agent Skills format can use this skill — copy the folder into that agent's skills directory.

Claude Code — .claude/skills

git clone --depth 1 https://github.com/ruvnet/ruflo.git /tmp/ruflo
mkdir -p .claude/skills
cp -r /tmp/ruflo/.agents/skills/agent-arch-system-design .claude/skills/agent-arch-system-design

Restart Claude Code after copying so it picks up the new skill.

Use it in TypingMind

Enable Agent Arch System Design in any TypingMind chat and the model takes it from there. Its name and description sit in the system prompt, and the moment a request matches, the model loads the full instructions itself — you never invoke it by hand, and it costs no tokens until it is actually used.

The model loads Agent Arch System Design on its own as soon as a request matches it.

Works with any AI model

AI skills are plain Markdown instructions rather than provider-specific code, so Agent Arch System Design is not tied to the model it was written for. Install it once in TypingMind and use it with GPT-5, Claude, Gemini, Grok, DeepSeek, Mistral, Llama, or a local model you run yourself — all on your own API keys.

Loaded only when it is needed
The system prompt carries just the name and description. The instructions are fetched on the first matching request, so an idle skill costs nothing.
Switch models mid-chat
Because the skill is instructions rather than code, changing model does not break it — the next model reads the same SKILL.md.

Skill instructions

This is the SKILL.md content the model loads. Read it before installing — a skill is instructions your model will follow.

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"

behavior: error_handling: "lenient" confirmation_required: - "major architectural changes" - "technology stack decisions" - "breaking changes" - "security architecture" auto_rollback: false logging_level: "verbose"

communication: style: "technical" update_frequency: "summary" include_code_snippets: false # Focus on diagrams and concepts emoji_usage: "minimal"

integration: can_spawn: [] can_delegate_to: - "docs-technical" - "analyze-security" requires_approval_from: - "human" # Major decisions need human approval shares_context_with: - "arch-database" - "arch-cloud" - "arch-security"

optimization: parallel_operations: false # Sequential thinking for architecture batch_size: 1 cache_results: true memory_limit: "1GB"

hooks: pre_execution: | echo "🏗️ System Architecture Designer initializing..." echo "📊 Analyzing existing architecture..." echo "Current project structure:" find . -type f -name ".md" | grep -E "(architecture|design|README)" | head -10 post_execution: | echo "✅ Architecture design completed" echo "📄 Architecture documents created:" find docs$architecture -name ".md" -newer $tmp$arch_timestamp 2>$dev$null || echo "See above for details" on_error: | echo "⚠️ Architecture design consideration: {{error_message}}" echo "💡 Consider reviewing requirements and constraints"

examples:

trigger: "design microservices architecture for e-commerce platform" response: "I'll design a comprehensive microservices architecture for your e-commerce platform, including service boundaries, communication patterns, and deployment strategy..."
trigger: "create system architecture for real-time data processing" response: "I'll create a scalable system architecture for real-time data processing, considering throughput requirements, fault tolerance, and data consistency..."

System Architecture Designer

You are a System Architecture Designer responsible for high-level technical decisions and system design.

Key responsibilities:

Design scalable, maintainable system architectures
Document architectural decisions with clear rationale
Create system diagrams and component interactions
Evaluate technology choices and trade-offs
Define architectural patterns and principles

Best practices:

Consider non-functional requirements (performance, security, scalability)
Document ADRs (Architecture Decision Records) for major decisions
Use standard diagramming notations (C4, UML)
Think about future extensibility
Consider operational aspects (deployment, monitoring)

Deliverables:

Architecture diagrams (C4 model preferred)
Component interaction diagrams
Data flow diagrams
Architecture Decision Records
Technology evaluation matrix

Decision framework:

What are the quality attributes required?
What are the constraints and assumptions?
What are the trade-offs of each option?
How does this align with business goals?
What are the risks and mitigation strategies?

Frequently asked questions

What does the Agent Arch System Design AI skill do?

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

Why use Agent Arch System Design on TypingMind?

Because you install it once and use it with any model. Agent Arch System Design is plain Markdown rather than provider-specific code, so the same skill runs on GPT-5, Claude, Gemini, Grok, or a local model — and you can switch model mid-chat without it breaking. TypingMind runs on your own API keys, so you pay providers directly instead of a per-seat subscription, and your skills and chats stay in your own storage.

How do I install Agent Arch System Design in TypingMind?

Open Plugins → Skills → Install from GitHub in TypingMind and paste https://github.com/ruvnet/ruflo/tree/main/.agents/skills/agent-arch-system-design. TypingMind reads its SKILL.md and installs it as a skill you can enable per chat.

Which AI models can use Agent Arch System Design?

Any model you connect in TypingMind. AI skills are plain Markdown instructions rather than provider-specific code, so GPT, Claude, Gemini, Grok, and local models can all load this skill when a request matches it.

How many AI models can I use with Agent Arch System Design?

As many as you like. As long as a model supports skills, you can use Agent Arch System Design with it — GPT, Claude, Gemini, Grok, DeepSeek, Mistral, Llama and more — all on TypingMind with your own API keys.

Is the Agent Arch System Design AI skill free?

Yes. It is published on GitHub by ruvnet under the MIT license. You only pay your own AI provider for the tokens you use.

What are AI skills?

An AI skill is a reusable instruction bundle that teaches an AI model how to do one specific task. It follows the open Agent Skills format: a SKILL.md file with a name and description, plus any scripts, templates or reference files the model may need. The model reads the instructions only when your request matches the skill, so an installed skill costs nothing until it is used.

How are AI skills different from plugins or MCP servers?

A plugin or MCP server gives a model new tools to call — code that runs somewhere and returns a result. An AI skill gives the model knowledge and process instead: how to approach a task, which steps to follow, what good output looks like. Skills are plain Markdown, so they need no server, no API key and no runtime, and they work with any model.

View all

Hyperframes

NousResearch

OrganizationPopular

Render MP4/WebM videos from HTML compositions.

Ip As Logo

Design minimal cute IP mascot marks readable at 32px.

Mono Color

Generate one- or two-ink editorial print poster images.

Pretext

Build creative browser demos with DOM-free text layout.

Overview

Installation

Install in TypingMind

Install in another agent

Use it in TypingMind

Works with any AI model

Skill instructions

System Architecture Designer

Key responsibilities:

Best practices:

Deliverables:

Decision framework:

Frequently asked questions

Related AI Skills

Set up your own AI workspace now