[사례글3] Kiro Spec 문서 활용하여 antigravity로 기능 추가하기

소개

Kiro에서 Spec 문서 작성을 잘해준다는 스터디 장님의 설명을 듣고 직접 웹사이트에 적용해보려고 함. Antigravity로만 구현되고 있는 기능들에서, 더 가지고 있는 부족한 점이 무엇인지 파악하고 더 완성도 높은 웹사이트를 만들기 위함임.

현재에는 없지만 있으면 더 좋을 것 같은 몇 가지 기능을 추가하고자 함.

진행 방법

Kiro: Spec 문서 작성 (Requirement.md, Design.md, Task.md)

Antigravity: 바이브코딩

잘못한 점 1. Antigravity에서 Open folder를 통한 구현이 아니라, Kiro에서 생성된 Task.md 내용을 복붙해서 Antigravity에게 구현해달라고 함. 내가 구현해놓은 웹사이트는 프로토타입을 확인할 수 있을 정도의 빠르고 가볍게 작동하는 수준이었던 반면, Kiro에서의 시스템은 무겁고 대규모의 백엔드 기초 공사가 필요했지만 확인하지 않고 "그냥 해줘!"라고 함.

오답 파악 및 해결 과정: ./kiro에 있는 문서가 숨겨져 있어서 디렉토리를 파악하는데 시간이 걸렸음. 동일한 folder에 저장해서 작업하면 훨씬 정확하게 구현할 수 있음을 확인함.

[스터디장님 도움으로 다시 수정한 코드]

.kiro 에 있는 requirements, design, task 파일 검토해주고 현재 프로젝트 스펙이나 기능에 상충되는게 없는지 그리고 현재 개발환경 및 그대로 사용하면서 추가 개발 및 유지보수에 용이한지 검토해줘
한국어로 된 문자 메시지의 스크린샷

잘못한 점 2. Antigravity에서 Open folder를 통한 구현이 아니라, Kiro에서 생성된 Task.md 내용을 복붙해서 Antigravity에게 구현해달라고 함.

내가 구현해놓은 웹사이트는 프로토타입을 확인할 수 있을 정도의 빠르고 가볍게 작동하는 수준이었던 반면, Kiro에서의 시스템은 무겁고 대규모의 백엔드 기초 공사가 필요했지만 확인하지 않고 "그냥 해줘!"라고 함.

오답 파악 및 해결 과정2. 이미 작성한 모든 기능이 다 작동할 수 없을 정도로 꼬인 상태가 되었음. 다행히 git에 저장하여 git pull 로 다시 원상복구를 진행할 수 있었음.

스터디장님의 도움으로 기존 상태를 유지하면서 기능을 추가하는 방향으로 코드를 다시 짤 수 있게 가이드했음.

현재 상태 유지하면서 기능을 추가하고 싶어. 최대한 개발 환경은 유지하고 싶어.   

결과와 배운 점

  • git을 잘 활용해서 다시 돌아갈 수 있는 안전장치를 마련하기! (내가 지키고 싶은 코드는 main으로 저장하고, 아직 더 확인이 필요한 부분은 branch를 이용하기)

  • 대충의 프로그램들이 작동할 때 구조에 대해서 파악할 수 있었음.

  • '과유불급'

  • 안해봤더라면 절대 모를 경험이기 때문에 'doing something is better than doing nothing" 임을 다시 한 번 느낌.

도움 받은 글 (옵션)

참고한 지피터스 글이나 외부 사례를 알려주세요.

(내용 입력)

지피터스 뉴스레터

이번 주 AI, 딱 쓸 것만

매주 월요일 오후,
읽고 바로 써먹을 AI 소식만