테마
Scene 0 · 개요와 준비
목표
To-Do 웹앱 실습의 전체 흐름을 이해하고, 두 개의 작업 폴더를 준비합니다. 이 실습에서는 동일한 앱을 Vibe(즉흥) 방식과 Spec(설계 기반) 방식으로 각각 만들어보며 차이를 체감합니다.
사전 준비
- Kiro IDE 실행 및 로그인 완료
- 기능 카탈로그의 Vibe·Spec·Steering 개념 이해 권장
해볼 것
폴더 생성
홈 디렉토리의 Documents처럼 찾기 쉬운 작업 위치에서 터미널을 열고 두 개의 빈 프로젝트 폴더를 생성합니다:
bash
mkdir vibe-todo
mkdir spec-todoKiro에서 열기
- vibe-todo 폴더를 Kiro에서 열기 (File → Open Folder)
- 채팅 패널이 정상 동작하는지 확인
text
안녕하세요! 이 폴더에서 할 일 관리 앱을 만들어볼 예정입니다.Kiro가 빈 폴더임을 인식하고 응답하면 준비 완료입니다. Scene A1로 진행하세요. spec-todo는 Scene C에서 사용합니다.
실습 구조 요약
| 트랙 | 방식 | Scene |
|---|---|---|
| A | Vibe로 만들기 | A1~A3 + 회고 |
| B | Steering 표준 적용 | B |
| C | Spec으로 만들기 | C1~C5 |
| D | Agent Hook 자동화 | D |
| E | MCP 연동 | E |
| F | 비교·하이브리드 | F |
| G | Sub-agent 병렬 위임·검증 | G |
공식 Kiro 워크숍으로 선택 심화
이 핸드북은 로컬 To-Do 앱으로 핵심 흐름을 연습합니다. AWS 계정과 공식 랩 환경을 사용할 수 있다면, 다음 공식 워크숍을 별도 선택 심화로 이어갈 수 있습니다.
- AI-Driven Development with Kiro — 사전 구축된 microblog 애플리케이션을 다루는 brownfield 시나리오입니다. 기존 코드·경계·검증을 먼저 이해한 뒤 변경을 설계하는 연습에 적합합니다.
- AI-Assisted Serverless Development — Users Service를 새로 만드는 greenfield 서버리스 시나리오입니다. 새 서비스의 요구사항·구현·배포 경로를 연습할 수 있습니다.
- Kiro CLI & MCP Workshop — CLI와 MCP로 AWS 개발·트러블슈팅·문서화를 연습합니다.
핸드북의 Scene A~G는 위 워크숍의 선행 지식 또는 보완 연습으로 활용할 수 있지만, 동일한 실습 순서나 결과물을 재현한다고 가정하지 않습니다.
이 핸드북은 AWS 계정 없이 로컬에서 완결되도록 구성했습니다. 공식 워크숍의 AWS 배포와 운영 실습은 선택 사항이며, 로컬 실습과 분리해 진행하세요.
실전 관점: Green field와 Brownfield
이 To-Do 실습은 빈 폴더에서 시작하는 green field 학습입니다. 그러나 실무 개발자는 새 프로젝트 생성보다 실행 중인 기존 코드베이스를 유지·개선하는 brownfield 작업에 더 많은 시간을 씁니다. 중요한 것은 AI가 기존 패턴과 아키텍처를 먼저 이해하고, 작동하는 시스템에서 변경을 검증하게 만드는 것입니다.
Kiro Immersion Day의 마이크로블로깅 시나리오는 다음 구조의 기존 앱에 기능을 추가합니다.
- Frontend — React + TypeScript + Vite, local development server
- Backend — API Gateway → Lambda (Node.js) → DynamoDB
- Authentication — Cognito
- Infrastructure — AWS CDK → CloudFormation
AWS 계정 없이도 전이 가능한 흐름은 같습니다.
- 기존 파일 구조와 데이터 흐름을 먼저 분석합니다.
- Spec으로 변경 범위와 시스템 경계를 명시합니다.
- Steering으로 기존 코딩·보안 규칙을 유지합니다.
- 실행 중인 앱에서 변경을 테스트하고 회귀를 확인합니다.
💡 실제 AWS 배포는 선택 사항
AWS 계정이 있다면 CDK·CloudFormation 배포로 실제 서버리스 백엔드에 연결할 수 있습니다. 이 워크샵에서는 계정 없이도 구조와 검증 원리를 이해할 수 있도록 배포 명령 자체보다 brownfield 변경 흐름에 집중합니다. 개발부터 운영까지의 연결은 AI-DLC에서 이어집니다.
기대 결과
vibe-todo폴더: Scene A(Vibe 즉흥)에서 사용spec-todo폴더: Scene C(Spec 설계)에서 사용- 두 폴더 모두 비어 있는 상태에서 시작
- `vibe-todo` 폴더 생성필수
- `spec-todo` 폴더 생성필수
- Kiro에서 `vibe-todo` 폴더 열기 성공필수
- 채팅 패널 정상 응답 확인필수
🚨 문제 해결
- 폴더를 열 수 없음: File → Open Folder에서 정확한 경로 지정. 바탕화면이나 Documents 하위 추천.
- 채팅 패널 무응답: Kiro 재시작. 인증 상태 확인(우측 하단 상태바).