Kiro의 Global Steering이 나를 Solo Frankenstein Engineer로 만든 방법
Source: Dev.to
Kiroween 해커톤은 나에게 야심찬 무언가를 만들도록 도전했습니다. 혼자 작업하면서 나는 단순히 코드 생성기만으로는 부족하다는 것을 알았고, 내 전체 아키텍처 철학을 실제로 이해하는 AI 팀원이 필요했습니다. 내 프로젝트 quickOnboardDoc(보안이 강화된 멀티‑테넌트 RAG 챗봇)는 Next.js, Prisma, NextAuth, 그리고 Gemini API를 엮어 만든 진정한 “프랑켄슈타인” 빌드였습니다.
문제: 아키텍처 드리프트
복잡한 솔로 프로젝트에서는 두 가지에 시간을 낭비하기 쉽습니다:
- 반복적인 보일러플레이트 작성(예:
QueryClientProvider를 올바르게 설정하기). - AI가 잘못된 기술을 제안할 때마다 계속 수정하기—예를 들어, 내가 PostgreSQL과 Prisma가 필요함에도 불구하고 MongoDB를 제안하는 경우.
두 경우 모두 흐름을 끊고 시간을 낭비합니다.
해결책: 코드 적용으로서의 글로벌 스티어링
나는 레포지토리 루트에 /.kiro/global_steering_rules.md 파일을 만들고 중요한 지시문 inclusion: always를 포함시켰습니다. 이 파일에는 다섯 가지 엄격한 규칙이 들어 있었습니다:
- Directive 1 – Next.js App Router를 TypeScript와 Tailwind와 함께 반드시 사용한다.
- Directive 2 – Prisma와 PostgreSQL을 반드시 사용한다.
- Directive 3 – 인증은 반드시 NextAuth와 Prisma Adapter를 사용한다.
- Directive 5 – 데이터 페칭은 반드시 TanStack Query를 사용하고 세션 지속성 및 재시도 제한을 1로 설정한다.
이 문서는 Kiro를 나만의 린터이자 설계자로 만들었습니다. 내가 Kiro에게 “새 페이지 스캐폴드” 혹은 “데이터베이스 모델 추가”를 요청하면, 이미 내 스택과 모든 설정을 알고 있었습니다.
그 효과는 즉각적이었습니다. Kiro는 QueryProvider.tsx 파일처럼 상태 지속성을 처리하는 복잡하고 프로덕션 수준의 패턴을 자동으로 생성했으며, 나는 한 번도 해당 세부 사항을 별도로 요청하지 않았습니다. 이는 아키텍처 드리프트를 완전히 없앴습니다.
코스튬 콘테스트 승리를 위한 Vibe 코딩
스티어링이 기술 기반을 담당하는 동안, 나는 창의적인 “코스튬 콘테스트” 요소를 위해 Vibe Coding을 사용했습니다.
다음과 같은 서술형 프롬프트를 반복적으로 Kiro에 제공했습니다:
“UI 컴포넌트를 위한 깊은 차콜 색상의 고대비 ‘Crypt Keeper’ 미학을 생성해 주세요.”
Kiro는 이 추상적인 브리프를 구체적인 oklch CSS 변수로 변환했으며, 이제 이 변수들이 앱 전체의 룩앤필을 정의합니다. 이 빠른 시각적 프로토타이핑은 수시간에 걸친 CSS 전투 없이 분위기를 정확히 잡는 데 큰 도움이 되었습니다.
배운 점
가장 큰 교훈은 사전 도구 활용의 힘이었습니다. Kiro의 글로벌 스티어링은 단순한 기능이 아니라 개발 철학입니다. 초기 15분 동안 제약 조건을 정의함으로써 해커톤 전체에 걸쳐 약 15시간의 수정 및 디버깅 시간을 절감할 수 있었습니다.
quickOnboardDoc은 개발 환경이 아키텍처 비전과 완벽히 일치할 때 혼자서도 무엇을 만들 수 있는지를 보여주는 증거입니다.
Kiro에게 이 “프랑켄슈타인” 프로젝트를 가능하게 해준 AI 팀원에게 감사드립니다!
quickOnboardDoc 체험하기 – live demo | 코드 보기
더 빠르게 빌드하고 싶나요?
kiro #nextjs #aitools #hackathon #codewithkiro