System Architect

Generate complete system architecture designs from functional and non-functional requirements.

472|75|Updated Oct 25, 2025
One-click install
npx skills add https://github.com/aj-geddes/claude-code-bmad-skills --skill system-architect
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: System Architect
Source: https://github.com/aj-geddes/claude-code-bmad-skills/tree/main/bmad-v6/skills/bmm/architect
Command: npx skills add https://github.com/aj-geddes/claude-code-bmad-skills --skill system-architect

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the design of system architecture, ensuring that all functional and non-functional requirements are met with a robust, scalable, and maintainable solution. It prevents costly rework by establishing a solid technical blueprint.

Core Features & Use Cases

  • Architecture Design: Creates comprehensive system architecture designs, including components, data models, and APIs.
  • Technology Selection: Justifies technology choices based on NFRs (performance, security, scalability).
  • Design Validation: Performs gate checks to validate architecture quality and coverage against requirements.
  • Use Case: After the PRD is complete, use this Skill to design the system architecture, selecting the tech stack, defining components, and ensuring all requirements are addressed before development begins.

Quick Start

Design the system architecture for my project based on the existing PRD. /architecture

Frequently Asked Questions about System Architect

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I design a complete system architecture from requirements?

System architecture design translates functional and non-functional requirements into a complete technical blueprint, including component boundaries, data models, APIs, and technology stack justification. Start with your PRD and use architecture design to define these elements before development begins, preventing costly rework.

What should I consider when selecting a technology stack?

Technology stack selection balances non-functional requirements like performance, security, and scalability against project constraints. Architecture design validates each choice against specific NFRs, documenting trade-offs and ensuring the stack supports both functional needs and long-term maintainability.

How do I ensure my architecture covers all requirements?

Architecture validation performs gate checks against both functional and non-functional requirements, mapping each to design decisions and architectural patterns. This ensures traceability between requirements and architecture components, catching gaps before implementation.

When should I redesign an existing system architecture?

Significant redesigns warrant architecture review when non-functional requirements shift—scalability, security, or performance demands increase—or when component boundaries no longer align with business needs. Architecture design guides the redesign process end-to-end with documented trade-off analysis.

Can architecture design handle security and scalability requirements?

Yes. Architecture design explicitly addresses security and scalability as non-functional requirements, selecting patterns and technologies that satisfy them. Each architectural decision includes justification tied to these NFRs.

What output do I get from architecture design?

Architecture design produces comprehensive architecture documents including component definitions, data models, API specifications, technology justifications, and traceability matrices linking all decisions back to functional and non-functional requirements.