cloud-architecture

name	cloud-architecture
description	Design cloud-native architectures with service selection and cost optimization
version	2.0.0
sasmp_version	1.3.0
bonded_agent	04-cloud-architecture
bond_type	PRIMARY_BOND
last_updated	2025-01

Cloud Architecture Skill

Purpose

Design cloud infrastructure architectures with appropriate service selection, cost optimization, and deployment strategies across AWS, Azure, and GCP.

---

Parameters

Parameter	Type	Required	Validation	Default
workload	string	✅	min: 30 chars	-
provider	enum	⚪	aws|azure|gcp|multi	aws
requirements	object	⚪	valid JSON	{}
budget_tier	enum	⚪	startup|growth|enterprise	growth
architecture_type	enum	⚪	serverless|containers|vms|hybrid	containers

Requirements Schema:

{
  "availability": "99.9%",
  "latency_ms": 100,
  "monthly_budget_usd": 5000
}

---

Execution Flow

┌──────────────────────────────────────────────────────────┐
│ 1. VALIDATE: Check workload and requirements              │
│ 2. ANALYZE: Workload characteristics                      │
│ 3. SELECT: Cloud services for each component              │
│ 4. DESIGN: Architecture diagram                           │
│ 5. ESTIMATE: Cost projection                              │
│ 6. OPTIMIZE: Apply cost/performance optimizations         │
│ 7. DOCUMENT: Return architecture with IaC snippets        │
└──────────────────────────────────────────────────────────┘

---

Retry Logic

Error	Retry	Backoff	Max Attempts
PROVIDER_ERROR	Yes	2s, 4s	3
COST_CALC_ERROR	Yes	1s	2
VALIDATION_ERROR	No	-	1

---

Logging & Observability

log_points:
  - event: design_started
    level: info
    data: [provider, architecture_type]
  - event: cost_estimate_complete
    level: info
    data: [monthly_estimate_usd, services_count]
  - event: optimization_applied
    level: info
    data: [optimization_type, savings_percent]

metrics:
  - name: architectures_designed
    type: counter
    labels: [provider]
  - name: design_time_ms
    type: histogram
  - name: estimated_monthly_cost
    type: gauge

---

Error Handling

Error Code	Description	Recovery
E201	Invalid provider	Show supported providers
E202	Budget exceeded	Suggest lower-cost alternatives
E203	Conflicting requirements	Highlight trade-offs
E204	Service not available in region	Suggest alternatives

---

Unit Test Template

test_cases:
  - name: "Web app on AWS"
    input:
      workload: "E-commerce web application with 10K daily users"
      provider: "aws"
      architecture_type: "containers"
    expected:
      has_services: true
      has_diagram: true
      has_cost_estimate: true
      services_include: ["ECS", "RDS", "CloudFront"]

  - name: "Serverless API"
    input:
      workload: "RESTful API with variable traffic"
      provider: "aws"
      architecture_type: "serverless"
    expected:
      services_include: ["Lambda", "API Gateway", "DynamoDB"]

  - name: "Budget exceeded"
    input:
      workload: "Enterprise data warehouse"
      requirements: { "monthly_budget_usd": 100 }
    expected:
      warning: "budget_exceeded"
      has_alternatives: true

---

Troubleshooting

Common Issues

Symptom	Root Cause	Resolution
High cost estimate	Wrong service tier	Right-size, use reserved
Single point of failure	Missing HA design	Add multi-AZ, redundancy
Vendor lock-in warning	Proprietary services	Use portable alternatives

Debug Checklist

□ Is provider selection appropriate?
□ Are availability requirements met?
□ Is cost within budget?
□ Are all components connected?
□ Is IaC syntax valid?

---

Service Quick Reference

Component	AWS	Azure	GCP
Compute	ECS/Lambda	AKS/Functions	GKE/Cloud Functions
Database	RDS/Aurora	SQL Database	Cloud SQL
Storage	S3	Blob Storage	Cloud Storage
Cache	ElastiCache	Cache for Redis	Memorystore

---

Integration

Component	Trigger	Data Flow
Agent 04	Design request	Receives workload, returns architecture
Agent 05	Security review	Provides security requirements

---

Quality Standards

• Cost-aware: Always include estimates
• HA by default: Multi-AZ unless specified
• IaC-ready: Include Terraform/CloudFormation snippets

---

Version History

Version	Date	Changes
2.0.0	2025-01	Production-grade: multi-cloud, cost estimation, IaC
1.0.0	2024-12	Initial release