brunch
매거진 생성형 AI

성공적인 Vibe Coding - 정확한 의도

AI Codiing Assistant에게 일을 시키는 방법

by 송 재희


� AI에게 일을 시키는 방법: 'Clearly' 서비스


"개떡같이 말해도 찰떡같이 알아듣는" AI는 없습니다. AI 코딩의 성공률을 100%로 끌어올리는 의도(Intent) 엔지니어링 플랫폼, Clearly를 소개합니다.


1. 서론: AI 코딩, 왜 실패할까요?


최근 Cursor, Loveable, v0, Bolt.new 등 혁신적인 AI 코딩 도구들이 등장했습니다. 이제 누구나 "쇼핑몰 만들어줘"라고 말하면 코드를 짜줍니다. 하지만, 결과물이 여러분의 생각과 정확히 일치하던가요?


대부분의 경우 **"아니요"**일 것입니다.

"로그인 기능 만들어줘" → AI는 OAuth를 쓸지, 이메일 방식을 쓸지 모릅니다.

"데이터 보여줘" → AI는 테이블로 보여줄지, 차트로 보여줄지, 페이지네이션은 어떻게 할지 모릅니다.


문제의 원인은 '모호함(Ambiguity)'입니다.


인공지능은 명령이 구체적이지 않으면, 학습된 데이터 중 가장 일반적인 패턴을 **'가정(Assumption)'**하여 코드를 작성합니다. 이 가정이 사용자의 의도와 어긋나는 순간, 우리는 수정을 위해 더 많은 시간을 허비하게 됩니다.


이 문제를 해결하기 위해 등장한 서비스가 바로 **Clearly**입니다.


2. Clearly란 무엇인가? (The Solution)

Clearly는 사용자의 머릿속에 있는 추상적인 아이디어를 AI가 완벽하게 이해할 수 있는 **'구조화된 명세서(Specification)'**로 변환해주는 인텔리전트 위저드(Intelligent Wizard) 서비스입니다.


사용자가 빈 화면(Blank Page) 공포 없이, AI가 이끄는 대화형 질문에 답을 하다 보면 어느새 완벽한 **BRD(비즈니스 요구사항 정의서)**와 **PRD(제품 요구사항 정의서)**가 완성됩니다. 그리고 이 문서는 AI 코더를 위한 최적의 프롬프트로 자동 변환됩니다.


핵심 가치 제안

Ambiguity Reduction: 모호한 표현을 제거하고 구체적인 기술 요구사항으로 변환합니다.

Context Management: 프로젝트의 전반적인 맥락(Context)을 유지하며 문서 간의 정합성을 맞춥니다.

Role-Based Mode: 비즈니스 오너를 위한 'Plain Mode'와 개발자를 위한 'Technical Mode'를 모두 지원합니다.


3. Clearly 워크플로우: 아이디어가 코드가 되기까지

Clearly를 사용하여 '나만의 서비스'를 만드는 과정은 다음과 같습니다.


Step 1: BRD (Business Requirement Document) 작성

"무엇을 만들고 싶은가요?"라는 질문에서 시작합니다.

Clearly의 AI는 비즈니스 목표, 타겟 유저, 핵심 가치를 구체화하도록 유도합니다.

결과물: 비즈니스 논리가 탄탄한 기획서.


Step 2: PRD (Product Requirement Document) 변환

승인된 BRD를 바탕으로, 이제 '어떻게(How)' 구현할지 정의합니다.

기술 스택, 데이터베이스 구조, API 명세 등 구체적인 기술적 질문이 이어집니다.

개발 지식이 없어도 괜찮습니다. Clearly가 "이 기능에는 A방식과 B방식이 있는데, A가 더 저렴합니다"와 같이 Contextual Tip을 제공합니다.


Step 3: Actionable Output 생성

For 비즈니스 유저: 'Vibe Coding Prompt'를 생성하여 Loveable이나 v0에 붙여넣기만 하면 즉시 웹사이트가 생성됩니다.

For 개발자: 상세한 'Technical Task List'를 생성하여 Jira나 GitHub Issue에 바로 등록할 수 있는 수준의 개발 명세서를 제공합니다.


4. 결론: AI 시대의 새로운 '기획자'

AI가 코딩을 하는 시대에, 인간의 역할은 '코딩(Coding)'에서 '지시(Directing)'로 변화하고 있습니다. 훌륭한 감독이 있어야 훌륭한 영화가 나오듯, 명확한 요구사항(Clearly Requirements)이 있어야 훌륭한 소프트웨어가 나옵니다.


여러분의 아이디어가 AI의 '가정(Assumption)'에 의해 왜곡되지 않도록 하세요. Clearly는 여러분의 의도를 가장 정확한 언어로 AI에게 전달하는 통역사이자, 든든한 파트너가 될 것입니다.


� 지금 바로 시작하세요


당신의 아이디어를 5분 만에 완벽한 개발 명세서로 바꿔보세요. 개발 지식이 없어도 상관없습니다. 지금 바로 Clearly를 방문하여 AI 코딩의 신세계를 경험해보세요.


� Clearly 서비스 바로가기 (https://www.clearlyreqs.com)

keyword
매거진의 이전글나만의 플랫폼 구축이 무조건 정답일까?