# aws-samples/sample-genai-aws-solutions-architect-agent architecture

> Architecture diagram of the GitHub repository aws-samples/sample-genai-aws-solutions-architect-agent, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/aws-samples/sample-genai-aws-solutions-architect-agent
- Repository: https://github.com/aws-samples/sample-genai-aws-solutions-architect-agent

## Overview

This prototype is a Streamlit assistant that turns a user's business requirements into AWS architecture guidance and deliverables. The main workflow runs from chat through agent reasoning and the documented Discovery, Architecture, Cost, and Well-Architected stages; generated files are saved for download. The agent also connects to AWS knowledge, pricing, and diagram MCP servers. Major workflow stages and integrations are documented, but the excerpts do not show every stage's implementation or all UI-to-agent details.

Main entry points: [`src/agent/aws_architect.py`](https://github.com/aws-samples/sample-genai-aws-solutions-architect-agent/blob/main/src/agent/aws_architect.py) (Architect Agent), [`app.py`](https://github.com/aws-samples/sample-genai-aws-solutions-architect-agent/blob/main/app.py) (Streamlit App), [`src/utils/file_writer.py`](https://github.com/aws-samples/sample-genai-aws-solutions-architect-agent/blob/main/src/utils/file_writer.py) (File Writer), [`src/ui/sample-prompts.json`](https://github.com/aws-samples/sample-genai-aws-solutions-architect-agent/blob/main/src/ui/sample-prompts.json) (Sample Prompts)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["User Interface"]
  node_app["Streamlit App<br/>[app.py]"]
  node_sampleprompts["Sample Prompts"]
  node_downloads["Generated Assets<br/>[app.py]"]
end

subgraph group_workflow["Architecture Workflow"]
  node_discovery["Discovery<br/>[prompts.py]"]
  node_architecture["AWS Architecture<br/>[prompts.py]"]
  node_cost["Cost Analysis<br/>[prompts.py]"]
  node_war["Well-Architected Review<br/>[prompts.py]"]
  node_agent["Architect Agent<br/>[aws_architect.py]"]
end

subgraph group_agentcore["Agent Internals"]
  node_configuration["Agent Configuration<br/>[agent_config.py]"]
  node_instructions["System Instructions<br/>[prompts.py]"]
  node_limiter["Rate Limiter<br/>[rate_limiter.py]"]
  node_writer["File Writer<br/>[file_writer.py]"]
  node_output["Generated Files"]
end

subgraph group_integrations["AWS Integrations"]
  node_knowledge{{"AWS Knowledge MCP"}}
  node_pricing{{"AWS Pricing MCP"}}
  node_diagrams{{"AWS Diagram MCP"}}
end

node_user(("User"))

node_user -->|"submits requirements"| node_app
node_app -->|"initializes"| node_agent
node_app -->|"loads prompts"| node_sampleprompts
node_app -->|"shows downloads"| node_downloads
node_agent -->|"guides"| node_discovery
node_agent -->|"designs"| node_architecture
node_agent -->|"analyzes costs"| node_cost
node_agent -->|"reviews"| node_war
node_agent -->|"uses settings"| node_configuration
node_agent -->|"loads instructions"| node_instructions
node_agent -->|"uses limiter"| node_limiter
node_agent -->|"registers tool"| node_writer
node_writer -->|"writes files"| node_output
node_agent -->|"queries knowledge"| node_knowledge
node_agent -->|"requests pricing"| node_pricing
node_agent -->|"generates diagrams"| node_diagrams

click node_app "https://github.com/aws-samples/sample-genai-aws-solutions-architect-agent/blob/main/app.py"
click node_sampleprompts "https://github.com/aws-samples/sample-genai-aws-solutions-architect-agent/blob/main/src/ui/sample-prompts.json"
click node_downloads "https://github.com/aws-samples/sample-genai-aws-solutions-architect-agent/blob/main/app.py"
click node_discovery "https://github.com/aws-samples/sample-genai-aws-solutions-architect-agent/blob/main/src/agent/config/prompts.py"
click node_architecture "https://github.com/aws-samples/sample-genai-aws-solutions-architect-agent/blob/main/src/agent/config/prompts.py"
click node_cost "https://github.com/aws-samples/sample-genai-aws-solutions-architect-agent/blob/main/src/agent/config/prompts.py"
click node_war "https://github.com/aws-samples/sample-genai-aws-solutions-architect-agent/blob/main/src/agent/config/prompts.py"
click node_agent "https://github.com/aws-samples/sample-genai-aws-solutions-architect-agent/blob/main/src/agent/aws_architect.py"
click node_configuration "https://github.com/aws-samples/sample-genai-aws-solutions-architect-agent/blob/main/src/agent/config/agent_config.py"
click node_instructions "https://github.com/aws-samples/sample-genai-aws-solutions-architect-agent/blob/main/src/agent/config/prompts.py"
click node_limiter "https://github.com/aws-samples/sample-genai-aws-solutions-architect-agent/blob/main/src/agent/rate_limiter.py"
click node_writer "https://github.com/aws-samples/sample-genai-aws-solutions-architect-agent/blob/main/src/utils/file_writer.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_sampleprompts,node_downloads,node_user toneBlue
class node_discovery,node_architecture,node_cost,node_war,node_agent toneAmber
class node_configuration,node_instructions,node_limiter,node_writer,node_output toneMint
class node_knowledge,node_pricing,node_diagrams toneRose
```

## Components

### User Interface

- [Streamlit App](https://github.com/aws-samples/sample-genai-aws-solutions-architect-agent/blob/main/app.py): `app.py`
- [Sample Prompts](https://github.com/aws-samples/sample-genai-aws-solutions-architect-agent/blob/main/src/ui/sample-prompts.json): `src/ui/sample-prompts.json`
- [Generated Assets](https://github.com/aws-samples/sample-genai-aws-solutions-architect-agent/blob/main/app.py): `app.py`

### Architecture Workflow

- [Discovery](https://github.com/aws-samples/sample-genai-aws-solutions-architect-agent/blob/main/src/agent/config/prompts.py): `src/agent/config/prompts.py`
- [AWS Architecture](https://github.com/aws-samples/sample-genai-aws-solutions-architect-agent/blob/main/src/agent/config/prompts.py): `src/agent/config/prompts.py`
- [Cost Analysis](https://github.com/aws-samples/sample-genai-aws-solutions-architect-agent/blob/main/src/agent/config/prompts.py): `src/agent/config/prompts.py`
- [Well-Architected Review](https://github.com/aws-samples/sample-genai-aws-solutions-architect-agent/blob/main/src/agent/config/prompts.py): `src/agent/config/prompts.py`
- [Architect Agent](https://github.com/aws-samples/sample-genai-aws-solutions-architect-agent/blob/main/src/agent/aws_architect.py): `src/agent/aws_architect.py`

### Agent Internals

- [Agent Configuration](https://github.com/aws-samples/sample-genai-aws-solutions-architect-agent/blob/main/src/agent/config/agent_config.py): `src/agent/config/agent_config.py`
- [System Instructions](https://github.com/aws-samples/sample-genai-aws-solutions-architect-agent/blob/main/src/agent/config/prompts.py): `src/agent/config/prompts.py`
- [Rate Limiter](https://github.com/aws-samples/sample-genai-aws-solutions-architect-agent/blob/main/src/agent/rate_limiter.py): `src/agent/rate_limiter.py`
- [File Writer](https://github.com/aws-samples/sample-genai-aws-solutions-architect-agent/blob/main/src/utils/file_writer.py): `src/utils/file_writer.py`
- **Generated Files**

### AWS Integrations

- **AWS Knowledge MCP**
- **AWS Pricing MCP**
- **AWS Diagram MCP**

### Other components

- **User**

## Connections

- User → Streamlit App: submits requirements (evidence: `README.md`)
- Streamlit App → Architect Agent: initializes (evidence: `app.py`)
- Streamlit App → Sample Prompts: loads prompts (evidence: `app.py`)
- Streamlit App → Generated Assets: shows downloads (evidence: `app.py`)
- Architect Agent → Discovery: guides (evidence: `README.md`)
- Architect Agent → AWS Architecture: designs (evidence: `README.md`)
- Architect Agent → Cost Analysis: analyzes costs (evidence: `README.md`)
- Architect Agent → Well-Architected Review: reviews (evidence: `README.md`)
- Architect Agent → Agent Configuration: uses settings (evidence: `src/agent/aws_architect.py`)
- Architect Agent → System Instructions: loads instructions (evidence: `src/agent/aws_architect.py`)
- Architect Agent → Rate Limiter: uses limiter (evidence: `src/agent/aws_architect.py`)
- Architect Agent → File Writer: registers tool (evidence: `src/agent/aws_architect.py`)
- File Writer → Generated Files: writes files (evidence: `src/utils/file_writer.py`)
- Architect Agent → AWS Knowledge MCP: queries knowledge (evidence: `README.md`)
- Architect Agent → AWS Pricing MCP: requests pricing (evidence: `README.md`)
- Architect Agent → AWS Diagram MCP: generates diagrams (evidence: `README.md`)
