vibe-coding-template

Claude Code + OMC + Codex + Gemini를 한 세션에서 오케스트레이션하는 바이브 코딩 부트스트랩 템플릿. 한 줄 지시 → 멀티에이전트가 풀스택으로 완성까지 가는 워크플로우.

---

0. 이게 뭐임?

Claude Code 위에 OMC(oh-my-claudecode) 를 얹어서 PM/아키텍트/실행자/QA를 동시에 굴리는 환경. 이 repo를 클론하면 다음이 즉시 작동함:

• 🤖 /autopilot — 한 줄 던지면 끝까지 자동 실행
• 👥 /team N:role — 전문가 N명 병렬 호출
• 🔁 /ralph — 통과할 때까지 자가 수정 무한 루프
• 🎤 /deep-interview — 요구사항 소크라테스식 인터뷰
• 🤝 /ccg — Claude + Codex + Gemini 트리오 합의 모드

1. 빠른 시작

1-1. 사전 요구사항

도구	버전	확인
Node.js	18+	node --version
Claude Code	최신	claude --version
Git	2.x+	git --version
(옵션) Codex CLI	0.13+	codex --version
(옵션) Gemini CLI	최신	gemini --version
(옵션) tmux/psmux	—	winget install psmux

1-2. OMC 설치 (1회만)

PowerShell에서:

# 글로벌 OMC CLI 설치
npm i -g oh-my-claude-sisyphus@latest

# OMC 컴포넌트를 ~/.claude/에 동기화
omc setup

# 설치 검증
omc doctor conflicts
omc doctor team-routing

Claude Code 세션 안에서 (선택, 마켓플레이스 방식):

/plugin marketplace add https://github.com/Yeachan-Heo/oh-my-claudecode
/plugin install oh-my-claudecode

두 방식 다 깔아도 OK. CLI는 셸용, 플러그인은 인-세션용.

1-3. 이 템플릿으로 새 프로젝트 시작

# 이 repo를 새 프로젝트의 시작점으로 클론
gh repo create Park1981/내-새-프로젝트 --template Park1981/vibe-coding-template --public --clone
cd .\내-새-프로젝트

# Claude Code 세션 시작
claude

세션 안에서 첫 명령:

/deep-interview "TODO 앱 만들고 싶어. 로그인 + 태그 기능 포함"

2. 핵심 워크플로우 5선

패턴 1. 모호한 아이디어 → 정제된 요구사항

/deep-interview "협업 노트 앱 만들고 싶어"

→ AI가 질문 던지면서 진짜 의도/스코프/제약 파헤침. 끝나면 PRD 문서 생성.

패턴 2. 명확한 작업 → 자동 풀스택 실행

/autopilot "JWT 인증 + Postgres + React 프론트로 TODO API 만들어줘. 테스트 80% 커버리지 이상"

→ PM → 아키텍트 → 백엔드/프론트 병렬 → QA → 자동 커밋까지.

패턴 3. Codex를 노예로 부려먹기

# 일회성 의견
/ask codex "이 함수 보안 리뷰"

# 트리오 합의 (가장 강력)
/ccg "이 PR 리뷰 — 아키텍처는 Codex가, UI는 Gemini가 보고, Claude가 합성"

# 병렬 워커 (인-세션, tmux 불필요)
/team 2:codex "TypeScript 에러 다 고쳐"

# 진짜 패널 군단 (tmux 필요)
omc team 3:codex "auth 모듈 보안 분석"

패턴 4. 끝장 검증 — Ralph 루프

/ralph "테스트 다 통과시키고 lint도 0 warning까지 가"

→ 실패 → 분석 → 수정 → 재실행을 통과할 때까지 무한 반복.

패턴 5. 인터뷰 + 자동실행 콤보 (가장 강력)

/ralphthon "주말 안에 SaaS 랜딩 + 결제 만들어"

→ deep-interview → autopilot → harden → done. 잘 때 돌려놓고 자고 일어나면 PR.

3. superpowers와 OMC 같이 쓰기

이 템플릿은 둘 다 활용. 단계별로 분리:

단계	도구	명령어 예시
탐색	superpowers brainstorming	(자동 활성)
플랜	superpowers writing-plans	(자동 활성)
실행	OMC /autopilot, /team	/autopilot "..."
검증	superpowers verification-before-completion + OMC /ralph	/ralph "..."
마무리	superpowers finishing-a-development-branch	(자동 활성)

4. 디렉토리 컨벤션

.
├── CLAUDE.md           # 프로젝트 톤·룰·환경
├── README.md           # 이 파일
├── .claude/
│   └── settings.json   # 권한·환경변수
├── .gitignore
├── docs/               # 산출물 (PRD, ADR, 분석 등)
└── examples/           # OMC 활용 시나리오 예제

5. 자주 막히는 곳 (Troubleshooting)

증상	원인	해결
omc team 호출 실패	tmux 없음	winget install psmux 또는 /team N:role (인-세션) 사용
/plugin install 실패	마켓플레이스 미등록	/plugin marketplace add ... 먼저
Codex/Gemini fallback warn	CLI PATH 인식 실패	warn only, 실제론 동작. omc doctor team-routing으로 확인
omc setup 후 슬래시 명령어 안 보임	Claude Code 재시작 필요	세션 끄고 다시 claude
superpowers와 키워드 충돌	같은 워크플로우 중복	CLAUDE.md의 "5. superpowers와 OMC 같이 쓰기" 참고

6. 참고

• OMC 공식: https://github.com/Yeachan-Heo/oh-my-claudecode
• OMC 문서: https://yeachan-heo.github.io/oh-my-claudecode-website
• Claude Code: https://claude.com/product/claude-code
• 이 템플릿: https://github.com/Park1981/vibe-coding-template

---

Made with 🎨 by @Park1981 — 바이브 코딩, 한 줄로 끝내자.