菜单
AWS Well-Architected Framework based IaC review orchestrator. Use when users request infrastructure review, cloud architecture assessment, or Well-Architected review. Supports Terraform, CloudFormation, CDK, and Pulumi.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | aws-well-architected |
| description | AWS Well-Architected Framework based IaC review orchestrator. Use when users request infrastructure review, cloud architecture assessment, or Well-Architected review. Supports Terraform, CloudFormation, CDK, and Pulumi. |
AWS Well-Architected Framework 기반의 IaC 코드 리뷰를 수행합니다. 이 스킬은 오케스트레이터로서 6개 Pillar별 스킬을 호출하고 통합 리포트를 생성합니다.
| 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 | 환경 영향 최소화, 에너지 효율 |
| 플랫폼 | 파일 확장자 |
|---|---|
| Terraform | .tf, .tfvars |
| CloudFormation | .yaml, .yml, .json |
| AWS CDK | .ts, .py, .java |
| Pulumi | .ts, .py, .go, .yaml |
프로젝트 루트에서 .wa-config.yaml 확인:
trigger:
auto: true
paths:
- "infrastructure/**/*.tf"
- "cdk/**/*.ts"
language: ko # ko | en
pillars: all # all | security,reliability | custom
설정 파일이 없으면 AskUserQuestion으로 설정 수집.
AskUserQuestion으로 확인:
"리뷰 범위를 선택해주세요."
1. 전체 리포지토리 (권장)
2. 변경된 파일만 (git diff)
3. 특정 디렉토리 지정
AskUserQuestion으로 확인:
"어떤 Pillar를 리뷰할까요?"
1. 전체 6 Pillars (권장)
2. Security + Reliability만 (빠른 리뷰)
3. 직접 선택
IaC 코드만으로 판단 어려운 경우:
"더 정확한 리뷰를 위해 몇 가지 질문을 드려도 될까요?"
1. 예, 인터뷰 진행
2. 아니오, 확인 가능한 범위만 리뷰
인터뷰 질문 예시:
대규모 리포지토리인 경우:
선택된 Pillar에 해당하는 스킬 참조:
# 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**:
```{언어}
{수정 코드 예시}
## 점수 산정 기준
| 점수 | 기준 |
|------|------|
| 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로 생성할까요?"
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 보안 리뷰도 함께 수행할까요?"
Karpathy LLM Wiki 패턴 구현. 프로젝트 문서(스펙/ADR/회의록)를 wiki/raw/에 모으고 LLM이 컴파일하여 wiki/에 교차참조 마크다운 위키를 생성·갱신. qmd 설치 시 하이브리드 검색 자동 활성, 미설치 시 INDEX.md 라우팅으로 graceful degrade. LanceDB 선택적 벡터 인덱스. Obsidian 호환. 하위 명령 - init, ingest, query, lint, sync, export, qmd-index, lancedb-sync.
Intent Document(INTENT.md) 생성 및 관리 스킬. 프로젝트의 의도를 Why/What/Not/Learnings로 문서화하고, 탐구와 학습을 통해 의도를 진화시키는 생명주기를 관리한다. 반드시 사용해야 하는 경우: "intent document", "INTENT.md", "intent engineering", "프로젝트 의도 정리", "왜 만드는지 정리", "프로젝트 목적 문서화", "What/Why/Not 정리", "프로젝트 방향 잡기", "피벗", "프로젝트 종료 판단" 등을 언급하거나, 새 프로젝트를 시작하면서 방향을 잡고 싶다고 할 때. 기존 INTENT.md를 수정하거나 학습 결과를 기록하고 싶을 때도 이 스킬을 사용한다.
AWS always-on 아키텍처(EC2/ALB/ECS/RDS)를 서버리스+Spot 패턴으로 이행할 때 사용. 워크로드 분류, 트레이드오프 평가, 단계별 이행 계획 생성. 구현 how-to는 sagemaker-spot-training 등 후속 스킬로 위임. 트리거 예 - "서버리스 이행", "EC2에서 Lambda로", "Spot 이행", "serverless migration", "ALB에서 API Gateway", "비용 절감 이행".
Guide for running cost-effective ML training on SageMaker Managed Spot Training. Use this skill when setting up GPU training jobs, choosing instance types/regions, debugging Spot capacity issues, or optimizing SageMaker training costs.
AWS Well-Architected Cost Optimization Pillar review. Checks resource sizing, scaling, storage classes, and cost monitoring configurations in IaC code.
AWS Well-Architected Operational Excellence Pillar review. Checks monitoring, logging, deployment automation, and continuous improvement practices in IaC code.