메뉴
Vibe Coding 2단계: 상세 구현 계획 수립 (Auto-Detection). 요청 내용을 분석하여 필요한 옵션을 자동으로 활성화합니다. 다음 상황에서 사용: (1) /vibe-research 완료 후 구현 계획이 필요할 때 (2) "계획 세워줘", "plan", "vibe plan" 등의 요청 시 (3) 기존 plan의 인라인 메모 피드백 반영 시 (4) AI 리뷰 및 리스크 평가 필요 시
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Vibe Coding 3단계: 기계적 구현 및 감독 (Auto-Detection). 요청 내용을 분석하여 필요한 옵션을 자동으로 활성화합니다. 다음 상황에서 사용: (1) /vibe-plan 승인 완료 후 구현 시작할 때 (2) "구현해", "implement", "vibe implement" 등의 요청 시 (3) Plan 범위 내 코드 변경을 순차적/병렬로 실행할 때 (4) 실시간 검증 및 자동 롤백이 필요할 때
Vibe Coding 4단계: 자동 코드 리뷰 (Auto-Detection). 요청 내용을 분석하여 필요한 리뷰 영역을 자동으로 활성화합니다. 다음 상황에서 사용: (1) /vibe-implement 완료 후 코드 리뷰가 필요할 때 (2) "코드 리뷰", "review", "vibe review" 등의 요청 시 (3) PR 생성 전 사전 리뷰가 필요할 때 (4) 보안/성능 취약점 스캔이 필요할 때
Vibe Coding - AI-driven development workflow with auto phase detection. Analyzes user intent and automatically selects the right phase: Research, Plan, Implement, or Review. Supports team mode for parallel execution with multiple agents. Use when: "vibe", "분석", "계획", "구현", "리뷰", "analyze", "plan", "implement", "review", "build", "check code", "team", "팀", "solo", "싱글", "단독". Single unified command replaces vibe-research, vibe-plan, vibe-implement, vibe-review.
Vibe Coding 1단계: 심층 리서치 (Auto-Detection). 요청 내용을 분석하여 필요한 옵션을 자동으로 활성화합니다. 다음 상황에서 사용: (1) 새 기능 구현 전 코드베이스 분석이 필요할 때 (2) 버그 원인을 심층 조사할 때 (3) 리팩토링 범위를 파악할 때 (4) "vibe research", "리서치", "분석해줘" 등의 요청 시
| name | vibe-plan |
| description | Vibe Coding 2단계: 상세 구현 계획 수립 (Auto-Detection). 요청 내용을 분석하여 필요한 옵션을 자동으로 활성화합니다. 다음 상황에서 사용: (1) /vibe-research 완료 후 구현 계획이 필요할 때 (2) "계획 세워줘", "plan", "vibe plan" 등의 요청 시 (3) 기존 plan의 인라인 메모 피드백 반영 시 (4) AI 리뷰 및 리스크 평가 필요 시 |
| argument-hint | [계획 요청 내용] |
Vibe Coding 방법론의 2단계: 상세 구현 계획 수립 + AI 기반 리뷰 & 리스크 평가.
개발자가 계획을 검토·승인하기 전까지 AI는 코드를 절대 작성하지 않는다. 기획(의사결정)과 구현(기계적 실행)을 분리해 아키텍처 주도권을 개발자가 유지한다.
/vibe-plan — 가장 최근 .vibe/NNN_topic/research.md 기반으로 계획 수립/vibe-plan --research 002_foo — 특정 토픽 폴더 지정 (.vibe/002_foo/research.md)/vibe-plan --feedback — 기존 plan 파일의 인라인 메모 반영 루프/vibe-plan --review — AI 기반 계획 리뷰 실행/vibe-plan --risk-analysis — 상세 리스크 분석 포함# 최신 리서치 파일 자동 탐지 (토픽 폴더 내부의 research.md)
LATEST_TOPIC_DIR=$(fd -t d -d 1 '^[0-9]' .vibe 2>/dev/null | sort -r | head -1)
LATEST_RESEARCH="${LATEST_TOPIC_DIR}research.md"
# 특정 리서치 지정 시: --research 002_foo → .vibe/002_foo/research.md
# SPECIFIED_RESEARCH=".vibe/${TOPIC_NAME}/research.md"
# 관련 리서치 파일들 연결 분석
rg "## 🔗 관련 리서치" .vibe/*/research.md | cut -d' ' -f3-
파일이 없으면: 먼저 /vibe-research "주제" 를 실행하세요.
리서치 파일을 완전히 읽은 후 선언:
리서치 파일을 읽었습니다: .vibe/NNN_topic/research.md
📊 리서치 요약:
- 분석 파일: N개
- 영향 범위: N개 모듈
- 리스크 레벨: [Low/Medium/High]
- 핵심 발견: [발견 사항]
✅ 코드 작성은 하지 않습니다. 계획 문서만 작성합니다.
같은 토픽 폴더에 plan 파일 생성: .vibe/NNN_topic/plan.md
research.md가 있는 토픽 폴더를 찾아서 같은 폴더에 plan.md를 저장한다. 새 토픽이면 폴더를 먼저 생성한다.
각 섹션에 <!-- MEMO: --> 인라인 메모 공간 및 AI 평가를 포함:
# Plan: [주제]
**기반 리서치**: .vibe/NNN_topic/research.md
**생성일**: YYYY-MM-DD HH:MM
**상태**: DRAFT (미승인 — 구현 금지)
**승인 여부**: ☐ 미승인
**리스크 레벨**: [Low/Medium/High/Critical]
**예상 소요 시간**: [N hours/days]
---
## 📋 Plan Metadata
```yaml
version: 1.0
author: AI Assistant
reviewers: []
approval_status: pending
risk_score: 0.0
confidence_level: 0.0
| 메트릭 | 현재 값 | 목표 값 | 측정 방법 |
|---|---|---|---|
| 성능 | X ms | Y ms | Lighthouse |
| 커버리지 | X% | Y% | Jest |
| 파일 경로 | 목적 | 예상 라인 | 우선순위 |
|---|---|---|---|
| src/new/file.ts | 신규 기능 | ~100 | P0 |
| 파일 경로 | 변경 유형 | 영향도 | 리스크 |
|---|---|---|---|
| src/existing/file.ts | Refactor | High | Medium |
| 파일 경로 | 삭제 이유 | 의존성 확인 |
|---|---|---|
| src/deprecated/old.ts | 더 이상 사용 안 함 | ✅ |
변경 전: ```typescript // 현재 코드 스니펫 function login(email: string, password: string) { // ... } ```
변경 후: ```typescript // 계획된 코드 변경 async function login(credentials: LoginCredentials): Promise { // 개선된 로직 } ```
변경 이유:
```typescript // BEFORE interface User { name: string; }
// AFTER interface User { firstName: string; // Breaking! lastName: string; // Breaking! } ```
```typescript interface AuthOptions { timeout?: number; // 신규 옵션 (optional) retryCount?: number; // 신규 옵션 (optional) } ```
graph LR
A[Phase 1: 기초 설정] --> B[Phase 2: 핵심 로직]
B --> C[Phase 3: 통합]
C --> D[Phase 4: 테스트]
D --> E[Phase 5: 최적화]
| 시스템 | 현재 버전 | 최소 요구 버전 | 호환성 |
|---|---|---|---|
| Node.js | 18.x | 16.x | ✅ |
| React | 18.2 | 18.0 | ✅ |
| TypeScript | 5.0 | 4.8 | ⚠️ |
⚠️ BREAKING CHANGES in v2.0:
- `login()` 함수 시그니처 변경
- `User` 타입 구조 변경
- 환경변수 이름 변경: OLD_VAR → NEW_VAR
| 테스트 유형 | 현재 | 목표 | 신규 작성 |
|---|---|---|---|
| Unit | 65% | 85% | 15개 |
| Integration | 40% | 70% | 8개 |
| E2E | 20% | 50% | 5개 |
Happy Path
Error Cases
Edge Cases
ci-pipeline:
- lint
- type-check
- unit-tests
- integration-tests
- e2e-tests (staging only)
활성화 조건: 변경 파일 목록에
.tsx,.jsx,.vue,.svelte,.css,.scss파일이 하나라도 있으면 이 섹션을 포함한다. 없으면 생략한다.
| 항목 | 선택 | 근거 |
|---|---|---|
| Typography | [폰트 + scale 전략] | [가독성/브랜드 부합 여부] |
| Color System | [컬러 접근법] | [대비비/접근성/브랜드 일관성] |
| Layout | [그리드/레이아웃 전략] | [반응형/콘텐츠 우선순위] |
| Motion | [모션 전략] | [목적성/성능 영향] |
| Spacing | [spacing scale] | [수직 리듬/일관성] |
AI가 생성한 UI는 특유의 "AI스러움"이 있다. 아래 안티패턴을 사전에 차단한다:
# 1. 즉시 이전 버전으로 복원
git revert --no-commit HEAD~N..HEAD
git commit -m "Revert: [기능명] 롤백"
# 2. 핫픽스 배포 (필요시)
git cherry-pick [safe-commit]
# 3. 데이터 마이그레이션 롤백 (필요시)
npm run migration:rollback
| 요소 | 현재 접근 | 대안 A | 대안 B |
|---|---|---|---|
| 개발 시간 | 3일 | 1일 | 5일 |
| 성능 | 좋음 | 보통 | 최고 |
| 유지보수성 | 높음 | 낮음 | 보통 |
| 확장성 | 높음 | 낮음 | 최고 |
| 리스크 | 확률 | 영향도 | 레벨 | 완화 전략 |
|---|---|---|---|---|
| 성능 저하 | Medium | High | 🟡 High | 프로파일링, 점진적 롤아웃 |
| 데이터 손실 | Low | Critical | 🟡 High | 백업, 트랜잭션 처리 |
| 보안 취약점 | Low | High | 🟠 Medium | 보안 리뷰, 펜테스팅 |
| 호환성 이슈 | Medium | Medium | 🟠 Medium | 충분한 테스트, 카나리 배포 |
Risk Score = (확률 × 영향도 × 노출도) / 완화 수준
총 리스크 점수: 6.5/10
리스크 레벨: MEDIUM
Q1: 동기 vs 비동기 처리 방식?
Q2: 에러 처리 전략 (throw vs return)?
Q3: 캐싱 전략 (메모리 vs Redis)?
점수 산출 기준 (각 항목 10점, 총 100점):
| 평가 항목 | 기준 | 배점 |
|---|---|---|
| 목표 명확성 | Goals/Non-goals가 구체적이고 측정 가능한가? | 10 |
| 파일 변경 완성도 | 모든 변경 파일이 경로/변경유형과 함께 명시되었는가? | 10 |
| 코드 변경 상세도 | Before/After 코드 스니펫이 주요 변경마다 포함되었는가? | 10 |
| 타입 안전성 | Breaking changes가 명확히 표시되고 마이그레이션 방안이 있는가? | 10 |
| 구현 순서 | 의존성 기반 Phase별 순서가 정의되었는가? | 10 |
| 테스트 전략 | 테스트 유형별 커버리지 목표와 시나리오가 있는가? | 10 |
| 롤백 전략 | 트리거 조건, 절차, 복잡도가 정의되었는가? | 10 |
| 리스크 분석 | 리스크 매트릭스와 완화 전략이 있는가? | 10 |
| 보안 고려 | 보안 관련 변경사항이 검토되었는가? | 10 |
| 의사결정 완료 | 핵심 질문이 모두 답변되었는가? | 10 |
점수 산출 방법: 각 항목을 Yes(10)/Partial(5)/No(0)로 평가 후 합산.
완성도 점수: [합산 점수]/100
평가 상세:
목표 명확성: [10/5/0] - [근거]
파일 변경 완성도: [10/5/0] - [근거]
코드 변경 상세도: [10/5/0] - [근거]
# ... 나머지 항목
누락 요소:
- [점수 0인 항목 나열]
강점:
- [점수 10인 항목 나열]
보안 강화
성능 최적화
관찰 가능성
AI 추천 대안:
현재 계획의 동기 처리 대신 이벤트 드리븐 아키텍처 고려:
- 확장성 30% 향상 예상
- 복잡도 20% 증가
- 개발 시간 1.5배
승인 시각: [YYYY-MM-DD HH:MM] 승인자: [이름] 승인 코멘트: [선택사항]
승인 완료 후 다음 명령으로 구현 시작:
/vibe-implement --plan NNN_topic
vibe-implement는 .vibe/NNN_topic/plan.md를 자동으로 찾습니다.
미승인 상태에서는 구현이 차단됩니다.
## Advanced Features
### --review 모드
AI가 계획을 자동으로 검토하고 개선점을 제안:
```bash
/vibe-plan --review
# 출력:
✅ 강점: 명확한 목표, 상세한 테스트 계획
⚠️ 개선 필요: 보안 고려사항, 성능 메트릭
💡 제안: 캐싱 전략 추가, 모니터링 계획 수립
상세한 리스크 분석 및 시뮬레이션:
/vibe-plan --risk-analysis
# 출력:
리스크 시뮬레이션 결과:
- 최악 시나리오: 3일 지연, 롤백 필요
- 최선 시나리오: 예정대로 완료
- 가능성 높은 시나리오: 1일 지연, 부분 기능 제외
--feedback 모드)<!-- MEMO: 개발자 코멘트 --> 섹션의 모든 메모를 추출해 plan.md를 자동 업데이트.
절대 금지 사항:
필수 준수 사항:
<!-- MEMO: --> 인라인 메모 공간 포함성공 지표: