Infra Architect

Infrastructure Architect Skill

IMPORTANT: Cost Awareness

• Provide cost estimates for designed resources
• Suggest cost optimization strategies
• Warn about potentially expensive resources

• feature: Feature description requiring infrastructure (e.g., "user uploads", "API backend")
• requirements: Optional specific requirements (performance, security, compliance)
• constraints: Optional constraints (budget, region, existing resources)
• config: Configuration from config-loader.sh

EXECUTE STEPS:

1. Read: workflow/analyze-requirements.md

   • Parse feature description
   • Identify infrastructure needs
   • List required AWS resources
   • Output: "✓ Step 1 complete: Requirements analyzed"

2. Read: workflow/review-existing.md

   • Check for existing infrastructure
   • Review current deployments (if any)
   • Identify reusable resources
   • Output: "✓ Step 2 complete: Existing infrastructure reviewed"

3. Read: workflow/design-solution.md

   • Design resource architecture
   • Define resource specifications
   • Plan security configuration
   • Estimate costs
   • Output: "✓ Step 3 complete: Solution designed"

4. Read: workflow/document-design.md

   • Generate design document from template
   • Include all specifications and decisions
   • Save to .fractary/plugins/faber-cloud/designs/{feature-slug}.md
   • Output: "✓ Step 4 complete: Design documented"

OUTPUT COMPLETION MESSAGE:

✅ COMPLETED: Infrastructure Architect
Feature: {feature}
Design Document: .fractary/plugins/faber-cloud/designs/{feature-slug}.md

Summary:
- Resources: {count} AWS resources designed
- Estimated Monthly Cost: ${amount}
- Security: {security highlights}

Next Steps:
- Review the design document
- Run: /fractary-faber-cloud:infra-manage engineer --design={feature-slug}.md
───────────────────────────────────────

IF FAILURE:

❌ FAILED: Infrastructure Architect
Step: {failed step}
Error: {error message}
Resolution: {how to fix}
───────────────────────────────────────

✅ 1. Requirements Analysis

• Feature requirements understood and documented
• Infrastructure needs identified
• Resource types determined

✅ 2. Solution Design

• All required AWS resources specified
• Resource configurations defined
• Security measures included
• Cost estimate provided

✅ 3. Design Documentation

• Design document created at .fractary/plugins/faber-cloud/designs/{feature-slug}.md
• Document includes: overview, resources, security, cost, implementation plan
• Document follows standard template format

FAILURE CONDITIONS - Stop and report if: ❌ Feature description too vague (action: ask user for clarification) ❌ Requirements conflict with constraints (action: report conflicts, suggest alternatives) ❌ Cannot create design document (action: check directory permissions)

PARTIAL COMPLETION - Not acceptable: ⚠️ Design created but not documented → Complete documentation before returning ⚠️ Cost estimate missing → Calculate and include cost before returning

1. Design Document

• Location: .fractary/plugins/faber-cloud/designs/{feature-slug}.md
• Format: Markdown following template
• Contains: Complete infrastructure design

Return to agent:

{
  "status": "success",
  "feature": "feature name",
  "design_file": ".fractary/plugins/faber-cloud/designs/{feature-slug}.md",
  "resource_count": 5,
  "estimated_monthly_cost": 25.50,
  "resources": [
    {"type": "s3_bucket", "name": "uploads", "purpose": "store user uploads"},
    {"type": "lambda_function", "name": "processor", "purpose": "process uploads"}
  ]
}

1. Security First

• Enable encryption at rest and in transit
• Follow principle of least privilege for IAM
• Use VPC for network isolation when needed
• Enable logging and monitoring

2. Scalability

• Design for horizontal scaling
• Use managed services when possible
• Consider auto-scaling requirements
• Plan for traffic growth

3. Reliability

• Design for high availability
• Plan for disaster recovery
• Use multi-AZ when appropriate
• Implement health checks

4. Cost Optimization

• Choose appropriate resource sizes
• Use reserved capacity when predictable
• Consider serverless for variable load
• Enable cost monitoring and alerts

5. Performance

• Use CDN for static content
• Cache frequently accessed data
• Optimize data transfer
• Choose appropriate compute resources

File Storage (User Uploads, Media, Documents):

• S3 bucket with versioning
• Lifecycle policies for cost optimization
• CloudFront for content delivery
• Lambda for processing/transformation

API Backend:

• API Gateway (REST or HTTP API)
• Lambda functions for compute
• DynamoDB for data storage
• Cognito for authentication

Data Processing:

• Lambda for event-driven processing
• SQS for queue management
• Step Functions for workflows
• S3 for input/output storage

Static Website:

• S3 for hosting
• CloudFront for CDN
• Route53 for DNS
• ACM for SSL certificates

Database Application:

• DynamoDB for NoSQL
• RDS for relational data
• ElastiCache for caching
• Lambda for business logic

# Infrastructure Design: {Feature Name}

## Overview
{Brief description of feature and infrastructure needs}

## Requirements
- {Requirement 1}
- {Requirement 2}
- {Requirement 3}

## Architecture

### Resources

#### 1. {Resource Type} - {Resource Name}
- **Purpose:** {Why this resource}
- **Configuration:**
  - Setting 1: Value
  - Setting 2: Value
- **Security:** {Security measures}
- **Cost:** ${monthly estimate}

#### 2. {Resource Type} - {Resource Name}
...

## Security Considerations
- Encryption: {at rest and in transit}
- IAM: {roles and policies}
- Network: {VPC, security groups}
- Monitoring: {CloudWatch, alerts}

## Cost Estimate
- Resource 1: ${monthly}
- Resource 2: ${monthly}
- **Total: ${total}/month**

## Implementation Plan
1. Step 1: {description}
2. Step 2: {description}
3. Step 3: {description}

## Design Decisions
- **Decision 1:** {rationale}
- **Decision 2:** {rationale}

## Future Considerations
- {Scaling plan}
- {Optimization opportunities}
- {Additional features}

S3 Storage:

• Standard: $0.023/GB/month
• Infrequent Access: $0.0125/GB/month
• Data transfer out: $0.09/GB

Lambda:

• Requests: $0.20 per 1M requests
• Compute: $0.0000166667 per GB-second

DynamoDB:

• On-demand: $0.625 per million write requests, $0.125 per million reads
• Provisioned: $0.00065/WCU/hour, $0.00013/RCU/hour

API Gateway:

• REST API: $3.50 per million requests
• HTTP API: $1.00 per million requests

CloudFront:

• Data transfer: $0.085/GB (varies by region)
• Requests: $0.0075 per 10,000 requests

RDS (db.t3.micro):

• On-demand: ~$0.017/hour = ~$12.50/month
• Reserved (1 year): ~$0.011/hour = ~$8/month