Kiro를 사용한 Spec-driven Development 시작하기

발행: 2일 전 (2025년 12월 14일 오전 03:33 GMT+9)

4 min read

원문: Dev.to

Source: Dev.to

간단한 투표 API 만들기

만들게 될 것

사용자가 다음을 할 수 있는 간단한 REST API:

옵션이 있는 설문 만들기
설문에 투표하기
설문 결과 보기

사전 요구 사항

운영 체제에 맞는 Kiro IDE를 다운로드하고 설치합니다.

프로젝트 폴더를 만들고 개발 시작!

프로젝트 폴더 만들기
로컬 파일 시스템에 Kiro_Voting_API 라는 폴더를 생성합니다.
Kiro에서 폴더 열기
Kiro를 실행하고 File → Open Folder 를 선택한 뒤 방금 만든 폴더를 엽니다.
스펙‑드리븐 세션 시작
옵션 중 Spec 을 선택합니다.

자연어 프롬프트 입력

Build a simple poll and voting REST API using Python and FastAPI

Requirements:
- A poll has: id, question, options, votes
- Options are strings
- Votes are counted per option
- Endpoints:
  - POST /polls to create a poll
  - GET /polls/{id} to retrieve a poll and its results
  - POST /polls/{id}/vote to vote for an option
- Store all data in memory
- Return JSON responses

요구 사항 문서 생성
Kiro가 요구 사항, 사용자 스토리, 수용 기준을 포함한 문서를 생성합니다.

요구 사항 다듬기 (선택 사항)

Add support for displaying poll results as a percentage
Poll results must be calculated as a percentage as well as displaying the raw numbers of votes

디자인 단계로 이동
요구 사항이 만족스럽다면 Move to design phase 를 클릭합니다.
생성된 디자인 검토
생성된 design.md 파일을 엽니다. 디자인에는 오류 처리와 테스트 전략이 포함되어 있습니다(더 빠른 프로토타입을 원한다면 나중에 줄일 수 있습니다).
구현 계획 단계로 이동
최종 디자인 수정이 끝났다면 Move to implementation plan 을 클릭합니다. Kiro가 구현 계획과 tasks.md 파일을 생성합니다.
작업 목록 열기
tasks.md 를 엽니다 (Task list 를 상단에서 선택하거나 폴더 보기에서 열 수 있습니다).
구현 시작
첫 번째 작업에서 Start task 를 클릭합니다. Kiro가 환경을 설정하고, requirements.txt 를 검토한 뒤 의존성을 설치하며 테스트를 시작합니다.
구현 계획 따라 진행
남은 작업들을 차례대로 진행합니다. Kiro는 각 단계마다 테스트 실행 허가를 요청하여 코드가 예상대로 동작하는지 확인합니다.
선택 사항 – 초기 구현 시 광범위한 오류 처리나 응답 포맷팅을 생략하고, 필요에 따라 나중에 추가할 수 있습니다.