aws-well-architected

AWS Well-Architected Review Skill

AWS Well-Architected Framework 기반의 IaC 코드 리뷰를 수행합니다. 이 스킬은 오케스트레이터로서 6개 Pillar별 스킬을 호출하고 통합 리포트를 생성합니다.

Framework Version

• 현재 지원: AWS Well-Architected Framework 2024-06-27
• 참고: AWS Well-Architected Framework

6 Pillars

Pillar	스킬	설명
Operational Excellence	aws-wa-operational-excellence	운영 효율성, 모니터링, 지속적 개선
Security	aws-wa-security	데이터 보호, ID/접근 관리, 탐지 제어
Reliability	aws-wa-reliability	장애 복구, 확장성, 고가용성
Performance Efficiency	aws-wa-performance	리소스 효율, 적정 규모, 성능 모니터링
Cost Optimization	aws-wa-cost	비용 최적화, 탄력성, 구매 옵션
Sustainability	aws-wa-sustainability	환경 영향 최소화, 에너지 효율

지원 IaC 플랫폼

플랫폼	파일 확장자
Terraform	.tf, .tfvars
CloudFormation	.yaml, .yml, .json
AWS CDK	.ts, .py, .java
Pulumi	.ts, .py, .go, .yaml

실행 프로세스

1. 초기 설정 확인

프로젝트 루트에서 .wa-config.yaml 확인:

trigger:
  auto: true
  paths:
    - "infrastructure/**/*.tf"
    - "cdk/**/*.ts"
language: ko  # ko | en
pillars: all  # all | security,reliability | custom

설정 파일이 없으면 AskUserQuestion으로 설정 수집.

2. 리뷰 범위 결정

AskUserQuestion으로 확인:

"리뷰 범위를 선택해주세요."
  1. 전체 리포지토리 (권장)
  2. 변경된 파일만 (git diff)
  3. 특정 디렉토리 지정

3. Pillar 선택

AskUserQuestion으로 확인:

"어떤 Pillar를 리뷰할까요?"
  1. 전체 6 Pillars (권장)
  2. Security + Reliability만 (빠른 리뷰)
  3. 직접 선택

4. 컨텍스트 인터뷰 (필요 시)

IaC 코드만으로 판단 어려운 경우:

"더 정확한 리뷰를 위해 몇 가지 질문을 드려도 될까요?"
  1. 예, 인터뷰 진행
  2. 아니오, 확인 가능한 범위만 리뷰

인터뷰 질문 예시:

• 규정 준수 요구사항 (HIPAA, PCI-DSS, GDPR)
• RTO/RPO 정의 여부
• 월간 AWS 예산
• 트래픽 패턴

5. 단계별 리뷰 실행

대규모 리포지토리인 경우:

1. 1단계: Critical 리스크만 스캔
2. 2단계: High 리스크 추가
3. 3단계: Medium/Low 포함 전체

6. Pillar별 스킬 호출

선택된 Pillar에 해당하는 스킬 참조:

• aws-wa-operational-excellence
• aws-wa-security
• aws-wa-reliability
• aws-wa-performance
• aws-wa-cost
• aws-wa-sustainability

7. 통합 리포트 생성

리포트 출력 형식

# AWS Well-Architected Review Report

**리뷰 일시**: YYYY-MM-DD HH:MM:SS
**리뷰 범위**: {경로} ({IaC 플랫폼})
**Framework 버전**: 2024-06-27

## Executive Summary

| Pillar | Score | Critical | High | Medium | Low | 변화 |
|--------|-------|----------|------|--------|-----|------|
| Operational Excellence | X/5 | N | N | N | N | ↑↓→ |
| Security | X/5 | N | N | N | N | ↑↓→ |
| Reliability | X/5 | N | N | N | N | ↑↓→ |
| Performance Efficiency | X/5 | N | N | N | N | ↑↓→ |
| Cost Optimization | X/5 | N | N | N | N | ↑↓→ |
| Sustainability | X/5 | N | N | N | N | ↑↓→ |

**전체 점수**: X.X/5 (이전 대비 +/-X.X)

## Critical Findings
[각 발견 사항 상세]

## High Risk Findings
...

## Medium Risk Findings
...

## Low Risk Findings
...

## Manual Review Checklist
[수동 확인 필요 항목]

## Compliance Summary
[Compliance 매핑 요약]

## 히스토리 비교
[이전 리뷰 대비 변화]

발견 사항 형식

### [{심각도}] {코드}: {제목}
- **Pillar**: {Pillar 이름}
- **탐지 유형**: [자동 탐지] | [수동 확인 필요]
- **Resource**: `{리소스 이름}`
- **Location**: `{파일:라인}`
- **Compliance**: {관련 규정}
- **Risk**: {위험 설명}
- **Recommendation**:
```{언어}
{수정 코드 예시}

• 담당자: (미할당)
• 상태: Open

## 점수 산정 기준

| 점수 | 기준 |
|------|------|
| 5/5 | Critical/High 없음, Medium 2개 이하 |
| 4/5 | Critical 없음, High 1개 이하 |
| 3/5 | Critical 없음, High 2-3개 |
| 2/5 | Critical 1개 또는 High 4개 이상 |
| 1/5 | Critical 2개 이상 |

## 히스토리 추적

### 저장 경로

docs/wa-reviews/ ├── YYYY-MM-DD-HHMMSS.md # 리뷰 결과 ├── history.json # 메타데이터 ├── DASHBOARD.md # 대시보드 └── config.yaml # 설정

### 트렌드 표시
| 기호 | 의미 |
|------|------|
| ↑ | 개선됨 |
| ↓ | 악화됨 |
| → | 변화 없음 |

## 협업 기능

### GitHub Issue 연동 (선택적)

"발견된 Critical 항목을 GitHub Issue로 생성할까요?"

1. 예, Issue 생성
2. 아니오, 파일만 저장

Issue 생성 시:
- Title: `[WA-{코드}] {제목}`
- Labels: `well-architected`, `{pillar}`, `{severity}`

## Compliance 매핑

상세 매핑은 [compliance-mapping.md](references/compliance-mapping.md) 참조.

| Framework | 설명 |
|-----------|------|
| PCI-DSS | 결제 카드 산업 데이터 보안 표준 |
| HIPAA | 미국 의료정보 보호법 |
| SOC2 | 서비스 조직 통제 |
| GDPR | EU 일반 데이터 보호 규정 |
| ISO 27001 | 정보보안 관리 체계 |

## owasp-review 연동

Security Pillar 리뷰 시 애플리케이션 코드가 발견되면:

"애플리케이션 코드(src/)도 발견되었습니다. OWASP 보안 리뷰도 함께 수행할까요?"

1. 예, OWASP 리뷰도 수행
2. 아니오, IaC만 리뷰