Step by Step 룰로 AI 뇌절 방지하기

AI에게 바로 코드를 시키면 안 되는 이유

AI 코딩 도구를 사용해본 적이 있나요? Cursor나 Claude Code 같은 도구에 "이 기능 만들어줘"라고 요청하면, AI는 즉시 코드를 작성하기 시작합니다. 하지만 결과물을 확인하면 의도와는 완전히 다른 경우가 많습니다.

왜 이런 일이 발생할까요? AI는 맥락 없이 바로 구현하려는 경향이 있습니다. 프로젝트의 기존 코드베이스 컨벤션을 제대로 파악하지 못하고, 중간에 방향이 틀어져도 알아차리기 어렵습니다. 마치 지도 없이 목적지를 향해 달리는 것과 같습니다.

이 글에서는 Step by Step 룰을 통해 AI가 체계적으로 작업하도록 강제하는 방법을 소개합니다. 탐색 → 플래닝 → 구현의 3단계만 지켜도, AI의 "뇌절"을 방지하고 훨씬 나은 결과물을 얻을 수 있습니다.

Step by Step 3단계 프로세스

Step by Step 룰의 핵심은 AI가 작업을 받으면 즉시 코드를 작성하는 것이 아니라, 3단계 프로세스를 거치도록 강제하는 것입니다.

1단계: 탐색 및 분석 (Explore)

먼저 AI가 프로젝트를 충분히 이해하도록 합니다.

• 코드베이스 탐색: 관련된 파일과 디렉토리 구조를 파악합니다
• 분석: 기존 코드의 패턴과 아키텍처를 이해합니다
• 컨벤션 파악: 네이밍 규칙, 파일 생성 규칙 등을 확인합니다

예를 들어, "사용자 프로필 기능을 만들어줘"라는 요청을 받으면, AI는 먼저 기존의 사용자 관련 코드, 데이터베이스 스키마, API 라우팅 패턴 등을 살펴봅니다.

2단계: 플래닝 (Plan)

바로 개발하지 않고, 작업 계획을 수립합니다. 이 단계가 가장 중요합니다.

• 작업 목록 작성: 구현해야 할 항목을 단계별로 나눕니다
• Acceptance Criteria 정의: 각 작업의 완료 기준을 명확히 합니다
• 의존성 파악: 어떤 작업이 먼저 완료되어야 하는지 확인합니다

플래닝 단계가 있으면 중간에 이상한 방향으로 가는지 체크할 수 있습니다. 예를 들어:

작업 목록 예시:

1. User 모델에 profileImage, bio 필드 추가
2. 프로필 조회 API 엔드포인트 생성 (GET /api/profile/:userId)
3. 프로필 수정 API 엔드포인트 생성 (PUT /api/profile)
4. 프로필 페이지 UI 컴포넌트 작성
5. 이미지 업로드 기능 구현

Acceptance Criteria 예시:

• 프로필 이미지는 5MB 이하만 업로드 가능
• bio는 최대 500자 제한
• 로그인한 사용자만 자신의 프로필 수정 가능
• 수정 후 즉시 UI에 반영

3단계: 구현 실행 (Execute)

플래닝 단계에서 만든 목록을 하나씩 체크하며 진행합니다.

AI는 각 작업 항목을 순서대로 구현하고, Acceptance Criteria를 만족하는지 확인합니다. 이 과정에서 중간에 의도와 다른 방향으로 가면, 플래닝 목록을 보고 즉시 알아차릴 수 있습니다.

왜 플래닝 단계가 중요한가

많은 개발자들이 플래닝 단계를 건너뛰고 싶어 합니다. "그냥 빨리 코드 짜면 되지, 왜 계획까지 세워야 하나요?"라고 생각할 수 있습니다.

하지만 플래닝 단계는 AI 코딩에서 가장 강력한 안전장치입니다.

1. 중간 검증이 가능합니다

작업 목록이 있으면 AI가 현재 어느 단계를 진행 중인지 명확합니다. 만약 3번 작업을 하다가 갑자기 데이터베이스 전체 구조를 바꾸려 한다면? 즉시 "잠깐, 이건 계획에 없는데?"라고 알아차릴 수 있습니다.

2. "완료"의 기준이 명확합니다

Acceptance Criteria가 있으면 "이 기능 다 됐나요?"라는 애매한 질문에 명확한 답을 할 수 있습니다. 모든 Acceptance Criteria를 만족하면 완료, 하나라도 빠지면 미완료입니다.

3. 의도와 다른 결과를 사전에 방지합니다

플래닝 단계에서 작업 목록을 검토하면, 실제 구현 전에 "어, 이건 내가 원한 게 아닌데?"를 발견할 수 있습니다. 코드를 다 작성하고 나서 뒤집는 것보다 훨씬 효율적입니다.

4. 협업 시 공유가 쉽습니다

팀으로 일한다면, AI가 작성한 플래닝을 팀원과 공유해서 피드백을 받을 수 있습니다. 모든 팀원이 같은 목표와 완료 기준을 공유하게 됩니다.

Cursor 룰 작성 시 추가 팁

Step by Step 룰을 Cursor나 Claude Code에 적용할 때 몇 가지 팁이 있습니다.

1. 파일 참조를 활용하세요

룰에서 "이 파일을 참고해"라고 명시적으로 지정하면, AI가 컨벤션을 더 정확하게 따릅니다.

예시:

Before implementing, check:
- File naming: See `src/components/user/UserCard.tsx`
- API patterns: See `src/app/api/users/route.ts`
- Type definitions: See `src/types/user.ts`

2. Code Example을 포함하세요

"이런 스타일로 작성해"라는 예시 코드를 룰에 넣으면, AI가 일관된 코딩 스타일을 유지합니다.

3. 영어로 작성하세요

많은 개발자들이 한국어로 룰을 작성하지만, 영어로 작성하는 것을 강력히 권장합니다. 이유는:

• 토큰 수가 적습니다: 영어는 한국어보다 토큰 효율이 좋습니다
• 프롬프트 설명력이 더 풍부합니다: AI 모델이 영어 학습 데이터가 훨씬 많아서, 영어 프롬프트에 더 정확하게 반응합니다
• 글로벌 커뮤니티와 공유 가능합니다: 영어로 작성하면 다른 개발자와 쉽게 공유할 수 있습니다

4. 각 단계마다 중단 포인트를 명시하세요

## Step 1: Explore
- Explore the codebase
- **STOP HERE and confirm with me before proceeding to Step 2**

## Step 2: Plan
- Create task list
- Define acceptance criteria
- **STOP HERE and get my approval before Step 3**

## Step 3: Execute
- Implement one task at a time
- Check each acceptance criteria

이렇게 하면 AI가 각 단계마다 멈춰서 확인을 받게 됩니다.

Vooster AI에서 Step by Step 룰 활용하기

좋은 소식이 있습니다. Vooster AI는 Step by Step 룰을 기본 제공합니다.

Rules 시스템

Vooster AI의 Rules 시스템에서는 다음과 같은 기본 룰들을 제공합니다:

• Step by Step: 3단계 분석 및 구현 프로세스
• Clean Code: 코드 품질 가이드라인
• Git Commit Message: Conventional Commit 형식
• TDD: 테스트 주도 개발
• ISMS-P: 정보보안 표준

프로젝트 생성 시 템플릿을 선택하면, 해당 템플릿에 최적화된 Step by Step 룰이 자동으로 포함됩니다. EasyNext, SuperNext, FullSaaS 등 각 템플릿마다 프레임워크와 아키텍처에 맞는 룰이 제공됩니다.

MCP 연동으로 바로 적용

Vooster AI는 MCP(Model Context Protocol)를 통해 Cursor, Claude Code와 직접 연동됩니다. 설정 파일에 한 줄만 추가하면:

{
  "mcpServers": {
    "vooster-ai": {
      "command": "npx",
      "args": ["-y", "--package=@vooster/mcp@latest", "vooster-ai", "--api-key=YOUR_KEY"],
      "type": "stdio"
    }
  }
}

이제 코딩 도구에서 Vooster AI의 Step by Step 룰을 바로 사용할 수 있습니다. AI가 자동으로 탐색 → 플래닝 → 구현 순서를 따르게 됩니다.

결론

AI에게 일을 시킬 때 "탐색 → 플래닝 → 구현" 순서만 지켜도 결과물이 완전히 달라집니다.

• 탐색으로 AI가 프로젝트를 제대로 이해하게 하고
• 플래닝으로 의도와 다른 결과를 사전에 방지하며
• 구현에서 체크리스트를 따라 일관성을 유지합니다

Step by Step 룰은 단순하지만 강력합니다. AI의 "뇌절"을 방지하는 가장 확실한 방법입니다.

Vooster AI는 이 Step by Step 룰을 기본 제공하며, 프로젝트에 바로 적용할 수 있도록 MCP 연동을 지원합니다. 체계적인 AI 개발 프로세스를 원한다면, 오늘 Vooster AI의 Step by Step 룰을 적용해보세요.

오늘 Vooster AI와 함께 체계적인 바이브 코딩을 시작하세요!