Architecture Agents
Relevant source files
The following files were used as context for generating this wiki page:
Architecture Agents within the SuperGemini Framework are specialized AI domain experts designed to handle high-level system design, server-side infrastructure, and modern web application architecture. These agents operate through a system of "Persona Mode," where the Gemini CLI embodies specific roles to provide deep, accurate technical solutions rather than acting as a generalist assistant.
The primary goal of these agents is to provide structured development workflows including service boundary definition, API reliability, and user experience optimization. They are triggered automatically based on specific keywords, file types, and task complexity, often coordinating with other specialists like the security-engineer or devops-architect to ensure comprehensive system design.
Sources: Docs/User-Guide/agents.md:21-45, CLAUDE.md:126-130
Core Architecture Agents
The framework utilizes three primary architecture-focused agents to cover the full stack of software design.
System Architect (system-architect)
The System Architect focuses on large-scale distributed system design, microservices decomposition, and scalability. It is responsible for defining service boundaries and selecting appropriate technology stacks for complex integrations.
- Auto-Activation Triggers: Triggered by keywords such as "microservices," "scalability," "distributed," and "system design." It also activates when tasks involve more than five components.
- Key Capabilities: Service boundary definition, event-driven architecture design, and data flow modeling.
Sources: Docs/User-Guide/agents.md:85-115
Backend Architect (backend-architect)
This agent emphasizes server-side reliability, API design, and data integrity. It specializes in RESTful and GraphQL patterns, database schema optimization, and server-side logic.
- Auto-Activation Triggers: Triggered by keywords like "API," "database," "REST," "GraphQL," and "endpoint." It also monitors file types such as API specs and database schemas.
- Key Capabilities: Database schema design, query optimization, authentication implementation, and caching strategies.
Sources: Docs/User-Guide/agents.md:117-145
Frontend Architect (frontend-architect)
The Frontend Architect centers on modern web application structure, accessibility (WCAG 2.1), and user experience. It handles state management patterns and component architecture.
- Auto-Activation Triggers: Triggered by "UI," "React," "Vue," "Angular," and "responsive." It activates for file extensions like
.jsx,.ts(frontend), and.css. - Key Capabilities: Design system implementation, state management (Redux, Zustand), and performance bundle analysis.
Sources: Docs/User-Guide/agents.md:147-175
Agent Activation and Coordination
Architecture agents do not operate in isolation. They follow a priority hierarchy for selection and a coordination pattern for complex tasks.
Selection Logic
The framework uses a decision tree to determine which architecture specialist to engage based on the input context.
The decision tree ensures that single-domain tasks go to specialists while multi-domain tasks receive oversight from the system-architect.
Sources: Docs/User-Guide/agents.md:47-75
Coordination Patterns
Architecture agents frequently collaborate with quality and infrastructure agents to fulfill complex commands like /sg:implement or /sg:design.
| Workflow | Lead Agent | Collaborating Agents |
|---|---|---|
| System Design | system-architect | devops-architect, performance-engineer, security-engineer |
| Full-Stack Dev | system-architect | frontend-architect, backend-architect, quality-engineer |
| API Development | backend-architect | security-engineer, technical-writer, quality-engineer |
Sources: Docs/User-Guide/agents.md:387-410
Specialized Architectural Review: Spec Panel
The /sg:spec-panel command leverages architecture agents to perform multi-expert specification reviews. This system uses a sequential flow to analyze, assemble, and review technical documentation.
This diagram shows how architecture agents collaborate with documentation and quality specialists during a specification review.
Sources: SuperGemini/Commands/spec-panel.toml:13-35
Spec Panel Configuration
The spec-panel command explicitly utilizes architecture experts for its "Architecture Focus" (--focus architecture).
- Lead Expert: Martin Fowler (for API design and patterns).
- Supporting Experts: Sam Newman (microservices), Gregor Hohpe (integration patterns), and Michael Nygard (reliability).
- Analysis Areas: Interface design quality, service decomposition, and scalability characteristics.
Sources: SuperGemini/Commands/spec-panel.toml:135-145
Technical Specifications Summary
The following table summarizes the data types and file associations for the primary architecture agents.
| Agent | File Types | Key Patterns |
|---|---|---|
system-architect | Distributed configs, infra maps | Microservices, Event-driven, Distributed |
backend-architect | .sql, .yaml (API), server configs | REST, GraphQL, Caching, Auth |
frontend-architect | .jsx, .tsx, .scss, .vue | Components, State Management, Accessibility |
Sources: Docs/User-Guide/agents.md:85-175, CLAUDE.md:143-165
Architecture agents in the SuperGemini Framework provide a structured, multi-perspective approach to software design. By combining the high-level oversight of the system-architect with the implementation-focused expertise of the backend-architect and frontend-architect, the system ensures that generated designs are scalable, reliable, and user-centric. These agents represent a core pillar of the framework's meta-programming capabilities, enabling systematic software development through intelligent persona-based orchestration.