Cloud Architecture Skill Skill

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 |

Agent Skills: Cloud Architecture Skill

Install this agent skill to your local

Skill Files