Formatted SKILL.md (raw) Package Files
Copy .md
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