[바이브코딩] AWS Kiro 스펙 주도 개발 가이드 — requirements·design·tasks 품질 체크리스트
목차
- 1. 바이브코딩의 한계와 Kiro가 등장한 맥락
- 2. AWS Kiro란? Amazon Q Developer의 후계자
- 3. 스펙 주도 개발 핵심 — requirements.md · design.md · tasks.md
- 4. Pro Max 신규 티어와 Auto 에이전트 (2026년 6월)
- 5. Steering Files로 팀 컨벤션 AI에 주입하기
- 6. 작업 유형별 Kiro 활용 기준
- 7. 스펙 주도 개발 시작 체크리스트
AI와 대화하며 코드를 만드는 방식(이를 바이브 코딩이라고 합니다)으로 작은 기능 몇 개를 만들다 보면 이런 순간이 옵니다. 사흘 전에 "로그인 기능 만들어줘"라고 했던 맥락을 AI가 기억하지 못하고, 오늘 "세션 관리 추가해줘"라고 하면 처음 설계와 전혀 다른 구조가 나오는 상황. 코드는 돌아가는데 뭔가 어긋나고, 두 달 뒤 다시 보면 어디서부터 손봐야 할지 파악이 안 됩니다.
Kiro(AWS가 만든 사양 기반 코딩 도구, VS Code에서 사용)는 코드를 바로 짜는 대신 "AI에게 줄 작업 설명서(스펙)를 먼저 씁니다". AI가 설명서 초안을 만들면 사람이 검토하고, 승인 후 코드가 생성됩니다. 두 달 뒤 코드를 다시 봐도 설명서로 맥락을 파악할 수 있습니다.
AWS가 이 문제를 정면으로 겨냥한 도구를 내놨습니다. 이름은 Kiro(AWS가 만든 사양 기반 코딩 도구, VS Code에서 사용). 코드 먼저 쓰는 게 아니라 스펙(AI에게 줄 작업 설명서)을 먼저 씁니다. 그리고 2026년 6월 15일 AWS Weekly Roundup에서 Pro Max 신규 티어가 발표됐고, 6월 17일 AWS Summit New York에서 공개 시연이 이뤄졌습니다.
"회원가입과 로그인이 되는 앱을 만들어줘"라고 입력하면, Kiro는 코드 대신 "로그인 버튼을 누르면 이메일/비밀번호를 확인하고, 실패하면 오류를 표시한다"는 식의 작업 설명서를 먼저 작성합니다. 설명서를 검토하고 승인하면 그때 코드 생성이 시작됩니다.
AI 코딩 도구로 무언가 만들기 시작했는데 AI가 이전 맥락을 잊어버려서 설계가 자꾸 바뀌는 경험을 했다면, Kiro의 스펙 주도 방식이 그 문제를 구조적으로 해결합니다. 팀에서 AI 코딩 도구를 공통 기준으로 쓰고 싶은 경우에도 적합합니다.
Kiro 전체 흐름 — 자연어 요청에서 완성 코드까지
2. AWS Kiro란? Amazon Q Developer의 후계자
Kiro는 AWS가 직접 만든 에이전틱 IDE입니다. 에디터 안에 AI 에이전트가 내장돼 있어서, 단순히 코드 자동완성이 아니라 스스로 계획을 세우고 여러 파일에 걸쳐 작업을 실행합니다.
배경이 중요합니다. AWS는 2026년 5월 15일부로 Amazon Q Developer 신규 가입을 중단했습니다. Kiro가 공식 후계자입니다. 기존 Q Developer 사용자라면 이미 이전 경로가 열려 있고, 새로 시작하는 분들은 Kiro가 첫 번째 선택지가 됩니다.
구동 엔진은 Claude Sonnet + Amazon Nova를 Amazon Bedrock을 통해 사용합니다. AWS 인프라 위에서 돌아가니 Bedrock 모델 접근 권한이 있는 팀이라면 엔터프라이즈 설정에서도 바로 연결됩니다.
Kiro 단계별 사용법 — 작업 설명서 3종으로 개발하기
3. 스펙 주도 개발 핵심 — requirements.md · design.md · tasks.md
Kiro가 다른 AI 코딩 도구와 가장 다른 점은 여기 있습니다. 개발 시작 전에 3개의 마크다운 파일을 자동으로 생성합니다.
기존 AI 코딩 vs Kiro 스펙 주도 — 달라지는 점
| 항목 | 기존 AI 코딩 도구 | Kiro 스펙 주도 |
|---|---|---|
| 첫 단계 | 프롬프트 → 바로 코드 생성 | 자연어 → 작업 설명서 → 코드 |
| 수정 기준점 | 없음 — 프롬프트 재작성 | 스펙 문서 수정 → 재생성 |
| 두 달 뒤 유지보수 | 코드 맥락 파악 어려움 | 스펙 문서로 의도 즉시 파악 |
| 팀 협업 | 프롬프트 히스토리 공유 어려움 | AI 코딩 방향 설정 파일 공유로 일관성 |
따라 해보는 순서
① VS Code에서 Kiro 확장 설치 → ② AWS 계정으로 로그인 → ③ 채팅창에 만들고 싶은 기능을 한 문장으로 입력 → ④ Kiro가 생성한 requirements.md 초안 검토·수정 → ⑤ 승인 후 design.md·tasks.md 자동 생성 확인 → ⑥ 작업 목록 중 첫 번째 항목 실행. 각 단계에서 Kiro가 먼저 설명서 초안을 내놓으므로, 처음엔 "OK" 또는 "이 부분은 이렇게 바꿔줘"로만 응답해도 됩니다.
requirements.md — 무엇을 만드나
사용자 스토리와 수락 기준을 EARS 표기법(Easy Approach to Requirements Syntax)으로 작성합니다. EARS 패턴은 이렇게 생겼습니다:
WHEN [사용자가 로그인 버튼을 클릭하면] THE SYSTEM SHALL [이메일/비밀번호 유효성 검사를 실행한다]
이 형식이 중요한 이유는 테스트 가능성 때문입니다. “로그인 기능 만들어줘”가 아니라 조건과 기대 결과가 명확하게 표현되니 나중에 AI가 구현한 코드가 요구사항을 만족하는지 확인할 수 있습니다.
design.md — 어떻게 만드나
기술 아키텍처, 시퀀스 다이어그램, 컴포넌트 구성을 문서화합니다. “왜 이 프레임워크를 선택했는지”, “데이터 흐름이 어떻게 되는지”가 이 파일에 담깁니다. 두 달 뒤에 돌아봐도 코드 의도를 파악할 수 있는 기반이 여기서 만들어집니다.
tasks.md — 어떤 순서로 만드나
구현을 번호가 매겨진 체크리스트로 쪼갭니다. 각 태스크에 예상 결과물과 의존성이 표시됩니다. AI 에이전트는 이 목록을 순서대로 실행하면서 자동으로 체크해 나갑니다.
2026년 6월 추가된 Requirements Analysis 기능은 요구사항 문서에 수학적 검증을 돌립니다. 모순되거나 빠진 조건을 코드 작성 전에 잡아냅니다. GeekWire는 이를 “AI 슬롭(품질 낮은 AI 생성물)을 구조적으로 차단하는 장치”라고 분석했습니다.
4. Pro Max 신규 티어와 Auto 에이전트 (2026년 6월)
AWS 공식 블로그가 2026년 6월 15일 발표한 내용에 따르면, Kiro는 요금 체계를 전면 개편하면서 Pro Max 티어를 추가했습니다.
Kiro 시작 전 확인할 체크리스트
코드 없이 "무엇을 원하는지"만 말할 수 있으면 충분합니다.
Kiro가 초안을 쓰고 사용자가 확인 후 코드 생성을 진행합니다.
스펙 2~3회 + 간단한 코드 생성. 부족하면 Pro($20)부터 고려.
기존 계정 사용 가능. 없으면 kiro.dev 가입 시 새로 만들 수 있습니다.
Free/Pro로 개인 프로젝트를 먼저 검증한 뒤 팀 도입을 권장합니다.
요금 체계에서 중요한 변화가 하나 더 있습니다. 기존에는 “바이브 모드”와 “스펙 모드” 요청이 각각 다른 크레딧 풀을 썼는데, 이번 개편으로 단일 크레딧 풀로 통합됐습니다. 단순 편집은 1 크레딧 미만, 복잡한 에이전틱 작업은 더 많이 소모하는 방식으로 0.01 크레딧 단위로 과금됩니다.
Auto 에이전트는 이번 개편의 핵심 기능입니다. Claude Sonnet 4.5와 여러 전문화 모델을 작업 성격에 따라 자동으로 선택해 씁니다. 단순 인텐트 감지나 캐시 히트가 가능한 요청엔 가벼운 모델을, 스펙 생성처럼 추론이 필요한 작업엔 무거운 모델을 씁니다. 결과적으로 kiro.dev 공식 발표에 따르면 Sonnet 4급 품질을 23% 낮은 비용으로 제공합니다.
Pro Max 티어($100/월)는 고용량 전문 개발자 대상으로 최신 프론티어 모델 접근과 팀 단위 에이전틱 작업에 필요한 크레딧을 제공합니다. TechTimes 보도에 따르면 AWS Summit NY(2026년 6월 17일)에서 Amazon Bedrock AgentCore, Amazon Quick과 함께 Kiro가 메인 발표 주제로 다뤄졌습니다.
5. Steering Files로 팀 컨벤션 AI에 주입하기
바이브코딩 할 때 가장 귀찮은 게 “우리 팀은 TypeScript strict mode 써, ESLint 규칙 이거야” 같은 컨텍스트를 매번 프롬프트에 붙여야 하는 일입니다. Kiro는 Steering Files로 이 문제를 해결합니다.
공식 문서에 따르면 Steering Files는 세션 전체에 걸쳐 에이전트 행동을 유도하는 지속적 컨텍스트 파일입니다. 위치는 두 곳:
~/.kiro/steering/— 전역 설정, 모든 프로젝트에 적용.kiro/steering/(프로젝트 루트) — 해당 프로젝트에만 적용
예를 들어 이런 내용을 Steering File에 넣어두면:
모든 Python 코드는 type hint 필수. 함수 길이 40줄 초과 시 분리. AWS SDK 사용 시 boto3 session 명시적 생성.
이후 모든 Kiro 세션에서 이 규칙이 자동 적용됩니다. 팀원 모두가 같은 Steering File을 공유하면 AI가 자연스럽게 팀 스타일을 따릅니다.
Agent Hooks도 함께 알아두면 좋습니다. 파일 변경이나 배포 이벤트 발생 시 자동으로 에이전트가 실행되는 트리거 시스템입니다. 코드 수정 → 자동 보안 스캔, 마크다운 변경 → 자동 문서 업데이트 같은 흐름을 설정할 수 있습니다.
Kiro 플랜 선택 기준표
| 사용 패턴 | 추천 플랜 | 월 요금 |
|---|---|---|
| 처음 써보는 경우, 기능 테스트 | Free | $0 |
| 주 2~3회, 사이드 프로젝트 | Pro | $20 |
| 매일 사용, 개인 고용량 | Pro+ | $40 |
| 하루 수 시간, 최신 모델 필요 | Pro Max | $100 |
| 팀 단위, 대형 프로젝트 | Power | $200 |
6. 작업 유형별 Kiro 활용 기준
Kiro의 스펙 주도 방식이 모든 상황에 맞는 건 아닙니다. 작업 성격에 따라 어떤 모드를 선택할지 기준을 잡아두면 불필요한 단계를 줄일 수 있습니다.
| 작업 유형 | 권장 방식 | 이유 |
|---|---|---|
| 간단한 스크립트·버그 수정 | Vibe Mode (채팅) | 스펙 오버헤드가 작업보다 크다 |
| 기능 단위 개발 (300줄+) | Spec 기반 | EARS 요구사항이 구현 방향을 고정시켜 중간 변경을 줄인다 |
| 팀 공유 코드베이스 | Steering + Spec | 팀 컨벤션을 Steering File에 한 번만 등록하면 반복 프롬프트 불필요 |
| 레거시 코드 파악·정리 | 역방향 Spec | 기존 코드 분석 → requirements.md 역생성 → 개선 방향 도출 |
Auto 에이전트는 작업 성격을 스스로 판단해 Vibe Mode와 Spec 기반 중 적합한 흐름을 선택합니다. 처음에는 Auto를 켜두고 패턴을 익힌 뒤, 자신의 작업 유형에 맞게 모드를 수동 전환하는 방식이 학습 곡선을 낮춥니다.
7. 스펙 주도 개발 시작 체크리스트
- ☐ kiro.dev에서 Free 티어로 가입 — 월 50 크레딧, 신용카드 불필요. 스펙 생성 2~3회 충분히 테스트 가능.
- ☐ Kiro 공식 문서에서 Quick Start 실행 — 간단한 Todo 앱으로 requirements.md → design.md → tasks.md 생성 흐름을 먼저 체험.
- ☐ ~/.kiro/steering/ 폴더에 코딩 스탠다드 파일 1개 작성 — 자주 쓰는 언어의 네이밍 규칙, 금지 패턴, 사용 라이브러리 목록을 마크다운으로 정리.
- ☐ 기존 사이드 프로젝트 1개에 Kiro 연결 — 새 기능 하나만 스펙 주도로 추가해보기. Kiro → 기존 코드 분석 → requirements 자동 제안 기능 확인.
- ☐ Pro 또는 Pro Max 전환 전에 크레딧 소비 패턴 1주일 확인 — kiro.dev/docs/billing에서 실시간 사용량 모니터링 방법 확인 후 플랜 결정.
마무리
AWS Kiro Pro Max의 핵심 가치는 “AI가 더 빠른 코드 생성”이 아니라 “AI와 함께 써도 무너지지 않는 코드베이스”입니다. 스펙 주도 개발은 초반 세팅이 번거롭지만, 프로젝트 규모가 커질수록 그 차이가 드러납니다. Free 티어로 먼저 requirements.md 하나 만들어보는 것만으로도 접근 방식이 확 다르다는 걸 체감할 수 있습니다.
참고 자료
- AWS 공식 블로그 — AWS Weekly Roundup: Kiro Pro Max (2026-06-15)
- TechTimes — AWS Summit NY 2026: Kiro, AgentCore, Amazon Quick
- GeekWire — AWS targets AI slop with spec check in Kiro
- AWS re:Post — Kiro Agentic AI IDE: Full Stack Spec-Driven Development
- kiro.dev — Announcing new pricing plans and Auto agent
- kiro.dev — Steering Files 공식 문서
'바이브코딩' 카테고리의 다른 글
| [바이브코딩] GitHub Copilot 앱 설치 가이드 — 이슈에서 PR 자동화 시작법 (0) | 2026.07.06 |
|---|---|
| [바이브코딩] AWS Kiro 비개발자 입문 가이드 — 스펙 주도 방식으로 AI 코딩 시작하기 (0) | 2026.06.28 |
| [바이브코딩] Claude Agent SDK 과금 분리 — 6월 15일부터 달라지는 크레딧 사용법 (0) | 2026.06.23 |
| [바이브코딩] Xcode 27 AI 에이전트 — 코딩 없이 아이폰 앱 첫 시도 가이드 (0) | 2026.06.19 |
| [바이브코딩] Gemini 3.5 Flash 바이브코딩 입문 — 코딩 몰라도 앱 만드는 법 (3) | 2026.06.15 |