Learn by Playing

샘플 게임 Spirit of Kiro를 직접 만지면서 Kiro의 핵심 기능을 손에 익히는 실습형 가이드입니다.

왜 게임으로 배우는가

이 가이드는 단순히 기능을 설명하는 대신, 실제로 동작하는 코드베이스 위에서 Kiro의 흐름을 체험하도록 구성되어 있습니다. 예제로 사용되는 Spirit of Kiro는 코드의 약 95%가 Kiro에게 프롬프트를 던져 만들어진 게임으로, AI 협업이 어디까지 가능한지 보여주는 살아있는 사례입니다. 가이드를 따라가며 버그를 잡고, 기능을 추가하고, 리팩터링하는 동안 Spec mode, Autopilot, Agent Hooks, MCP 같은 개념이 자연스럽게 익혀집니다.

Spirit of Kiro는 어떤 게임인가

Spirit of Kiro는 "무한 크래프팅"을 표방하는 게임입니다. 플레이하는 방식은 다음과 같이 요약할 수 있습니다.

1. 무작위로 생성되는 고유한 아이템을 발견합니다.
2. 아이템을 다른 아이템에 적용해 cut, paint, glue, enchant 같은 행동을 AI가 시뮬레이션한 결과로 받아봅니다.
3. 완성된 결과물을 AI 감정사(appraiser)에게 팔아 게임을 진행합니다.

아이템이 매번 새롭게 생성되고 상호작용 결과까지 AI가 만들어내기 때문에, 같은 플레이가 거의 반복되지 않는 것이 특징입니다.

가이드 진행 순서

총 9개 단계로 구성되어 있으며, 위에서부터 순서대로 따라가는 것을 권장합니다.

1. Setup — AWS 계정 확인, Cognito 사용자 풀 구성, Docker Compose로 게임 스택 빌드 및 실행, DynamoDB 테이블 부트스트랩까지 로컬 실행 환경을 갖춥니다.
2. 게임 홈페이지 개선 — Steering 파일로 Kiro에게 프로젝트 컨텍스트를 학습시키고, 랜딩 페이지를 다듬습니다.
3. 버그 수정: 물리 엔진 글리치 — 다른 탭에서 돌아왔을 때 물리 동작이 튀는 미묘한 버그의 원인을 추적하고 고칩니다.
4. 버그 수정: 상호작용 누락 — 초기 "vibe coding"으로 만들어진 부분에서 AI가 놓친 케이스를 여러 파일에 걸쳐 수정합니다.
5. 리팩터링: DRY 적용 — 중복을 정리하는 "vibe refactoring" 흐름을 따라갑니다. 저자는 이 과정을 vibe coding의 절반이라 부릅니다.
6. 새 기능: 이메일 인증과 비밀번호 재설정 — Spec mode를 활용해 클라이언트와 서버를 아우르는 복잡한 기능을 명세 기반으로 구현합니다.
7. 자동화: Agent Hooks로 에셋 관리 — 반복적이고 실수하기 쉬운 에셋 보일러플레이트 작업을 Agent Hooks로 자동화합니다.
8. MCP로 Kiro 확장하기 — Model Context Protocol을 활용해 Kiro의 컨텍스트와 동작을 커스터마이즈합니다.
9. 마무리 — 학습 내용을 정리하고 다음으로 시도할 만한 길을 안내합니다.

학습 효과를 높이는 방법

• 각 단계에서 Kiro에게 던질 프롬프트를 직접 다듬어 보세요. 같은 결과라도 더 짧고 명확한 지시를 만드는 연습이 됩니다.
• 버그를 고치기 전에 Kiro가 코드베이스를 어떻게 탐색하는지 살펴보면, 이후 자신의 프로젝트에 적용하기 쉽습니다.
• Spec mode와 Autopilot, Agent Hooks의 차이를 단계별로 비교하며 어떤 작업에 어떤 도구가 어울리는지 감각을 익히세요.

준비가 되었다면 다음 페이지에서 개발 환경부터 차근차근 세팅해 봅시다.