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