쉽게 PRD, TRD, TODO List를 만들 수 있는 vibe document 생성 도구
npm install firstvibeMVP의 첫 진동, firstvibe.
당신의 한 문장의 아이디어를 확장시켜 MVP로 만들기 위한 토대를 만들어드립니다.


🌐 공식 웹사이트: https://firstvibe.dev/
📚 GitHub 저장소: https://github.com/kstost/firstvibe
📦 NPM 패키지: https://www.npmjs.com/package/firstvibe
---
firstvibe는 복잡한 과정을 자동화하여, 당신이 가장 중요한 것, 즉 아이디어의 본질에 집중할 수 있도록 돕습니다.
코딩을 전혀 모르는 사람들도 간단한 아이디어를 확장시켜 MVP 형태로 빠르게 만들어 볼 수 있도록 PRD, TRD 등의 형태로 기획을 만드는데 도움을 드리는 프로그램입니다.
---
---
bash
npm install firstvibe -g
`$3
`bash
firstvibe
`
처음 실행 시 AI 제공자와 API 키를 설정하는 대화형 설정이 시작됩니다.$3
`bash
💰 빠르고 경제적 (프로토타입용)
firstvibe config mode cheap💎 고품질, 고비용 (실제 프로젝트용)
firstvibe config mode expensive
`$3
`bash
firstvibe
`$3
생성된 파일들을 확인하고 ✨ 바이브코딩을 시작하세요!
- 💾 firstvibe.json - 질문-답변 데이터
- 📄 prd.md - 제품요구사항문서
- 🔧 trd.md - 기술요구사항문서
- ✅ todo.yaml - 개발 할일 목록---
📖 상세 사용법
$3
`bash
기본 실행 (대화형 모드)
firstvibe명령줄에서 프로젝트 설명 제공
firstvibe "음식 주문 배달 앱"파일에서 프로젝트 설명 읽기
firstvibe -f project.txt이전 설문 결과 재사용 (설문 건너뛰고 수정/생성 선택)
firstvibe -f firstvibe.json도움말 보기
firstvibe help
`$3
`bash
상세 출력 모드 (디버깅 정보 포함)
firstvibe -v파일 입력 옵션
firstvibe -f project.txt # 텍스트 파일에서 프로젝트 설명 읽기
firstvibe -f firstvibe.json # 이전 Q&A 결과 재사용질문 횟수 조절 (1-50)
firstvibe -q 5 # 빠른 생성 (5문항)
firstvibe --questions 15 # 상세 생성 (15문항)선택적 생성
firstvibe --skip-trd # PRD만 생성
firstvibe --skip-todo # PRD, TRD만 생성
`$3
#### AI 제공자 설정
`bash
OpenAI 설정
firstvibe config set openai.apiKey sk-your-api-key-here
firstvibe config set provider openaiGoogle Gemini 설정
firstvibe config set gemini.apiKey your-gemini-api-key-here
firstvibe config set provider gemini
`#### 모델별 세부 설정
`bash
OpenAI 모델 설정
firstvibe config set openai.prdModel gpt-5 # PRD용 모델
firstvibe config set openai.trdModel gpt-5-mini # TRD용 모델
firstvibe config set openai.todoModel gpt-5-mini # TODO용 모델Gemini 모델 설정
firstvibe config set gemini.prdModel gemini-2.5-pro
firstvibe config set gemini.trdModel gemini-2.5-flash
`#### OpenAI 성능 및 품질 조절
`bash
Verbosity 레벨 (생성 결과의 상세도) - OpenAI 전용
firstvibe config set openai.prdVerbosity high # high/medium/low
firstvibe config set openai.trdVerbosity mediumReasoning Effort (AI 추론 노력도) - OpenAI 전용
firstvibe config set openai.prdReasoningEffort high # high/medium/minimal
`$3
`bash
현재 설정 확인
firstvibe config get특정 설정 확인
firstvibe config get openai.apiKey현재 모드 확인
firstvibe config mode모든 설정 키 목록
firstvibe config list설정 초기화
firstvibe config reset
`---
📁 생성되는 파일 상세
$3
JSON 형식의 설문 결과 저장 파일
- 📅 생성 타임스탬프
- 📝 프로젝트 설명
- 🗣️ 모든 질문과 답변 내역
- 🔄 재사용 가능: firstvibe -f firstvibe.json로 이전 설문 결과 활용$3
Product Requirements Document
- 🎯 제품 개요 및 비전
- 👥 대상 사용자 페르소나
- 📖 사용자 스토리 및 유스케이스
- ⚙️ 기능적/비기능적 요구사항
- 📈 성공 측정 기준 (KPI)
- 🗺️ 개발 로드맵 및 일정$3
Technical Requirements Document
- 🏗️ 고수준 시스템 아키텍처
- 💾 데이터베이스 모델 및 스키마
- 🛠️ 기술 스택 및 라이브러리 선택
- 🔒 보안 설계 및 인증 방식
- ⚡ 성능 최적화 전략
- 🧪 테스트 전략 및 QA 계획$3
YAML 형식의 구조화된 작업 목록
- 📋 우선순위별 작업 분류 (P0/P1/P2)
- 🔍 세부 작업 및 구현 가이드
- 🔗 작업 간 의존성 관계
- ✔️ 완료 기준 및 검증 방법
- 📅 실행 순서 및 타임라인
- 💡 구현 가이드 및 코드 예시---
💡 사용 시나리오
$3
`bash
빠른 프로토타입 검증용
firstvibe config mode cheap
firstvibe -q 5 "소셜 독서 플랫폼"
`
결과: 빠른 MVP 계획 완성$3
`bash
상세한 프로젝트 계획 수립
firstvibe config mode expensive
firstvibe --questions 15 -v
`
결과: 상세하고 체계적인 개발 계획서 완성$3
`bash
1단계: 첫 번째 실행으로 firstvibe.json 생성
firstvibe -q 10 "헬스케어 앱"2단계: 설정 변경 후 같은 설문으로 다른 결과 생성
firstvibe config mode expensive
firstvibe -f firstvibe.json3단계: 일부 답변만 수정하여 새로운 버전 생성
firstvibe -f firstvibe.json # 수정 옵션 선택
`
결과: 동일한 설문을 기반으로 여러 버전의 문서 생성$3
`bash
project-description.txt 파일 생성
echo "AI 기반 언어학습 플랫폼" > project.txt파일을 통한 프로젝트 시작
firstvibe -f project.txt --questions 12
`
결과: 일관된 프로젝트 설명으로 반복 실행 가능
---
⚙️ 설정 옵션 완전 가이드
$3
| 모드 | 설명 | 모델 | 품질 | 비용 | 속도 |
|------|------|------|------|------|------|
| cheap | 프로토타입용 | gpt-5-mini | 기본 | 낮음 | 빠름 |
| expensive | 프로덕션용 | gpt-5 | 고품질 | 높음 | 보통 |
| custom | 사용자 정의 | 혼합 | 맞춤형 | 가변 | 가변 |$3
- low: 핵심만 간결하게
- medium: 적절한 상세도 (권장)
- high: 매우 상세한 설명$3
- minimal: 빠른 생성, 기본적인 추론
- medium: 균형잡힌 품질과 속도
- high: 깊이 있는 분석과 추론---
🎯 실전 팁
$3
1. 첫 번째 시도: cheap 모드로 빠르게 아이디어 검증
2. 설문 데이터 보존: firstvibe.json 파일을 통한 설문 결과 재활용
3. 모드 전환 활용: 동일 설문 + 다른 모드로 품질 비교
4. 점진적 개선: 답변 수정 기능으로 세밀한 조정
5. 파일 기반 관리: 프로젝트 설명을 텍스트 파일로 관리하여 일관성 유지$3
- 구체적으로: "모바일 앱" → "iOS/Android 네이티브 앱"
- 사용자 중심으로: 기술보다는 사용자 니즈에 집중
- 현실적으로: 실현 가능한 범위 내에서 목표 설정$3
- 반복 실행: firstvibe.json 재사용으로 동일 설문 + 다른 설정 조합 테스트
- 질문 수 조절: 복잡한 아이디어일수록 질문 수를 늘려서 실행
- 모델 조합: PRD는 고급 모델, TODO는 경제적 모델로 비용 최적화
- 점진적 개선: 설문 결과 수정 기능으로 특정 답변만 개선
- 파일 관리: 프로젝트별로 firstvibe.json을 버전 관리하여 히스토리 추적---
🚨 주의사항 및 제한사항
$3
- OpenAI/Google API 사용으로 토큰 기반 비용 발생
- 질문 수가 많을수록, OpenAI의 verbosity가 높을수록 비용 증가$3
- 생성된 문서는 출발점으로 활용, 프로젝트에 맞는 추가 검토 필수
- AI가 생성한 기술 스택은 최신 트렌드 반영 확인 필요
- 도메인별 전문 지식은 별도 검증 권장$3
- API 키 필수 (OpenAI 또는 Google)
- 인터넷 연결 필수---
🛠️ 문제 해결
$3
`bash
API 키 확인
firstvibe config get openai.apiKey새로운 API 키 설정
firstvibe config set openai.apiKey sk-new-key-here
`$3
`bash
상세 로그로 오류 확인
firstvibe -v프록시 환경에서 사용 시
export https_proxy=your-proxy-url
firstvibe
`$3
`bash
모든 설정 리셋
firstvibe config reset --force특정 제공자 설정만 변경
firstvibe config set provider gemini
``---
---
AGPL-3.0 - 자세한 내용은 LICENSE 파일을 참조하세요.
---
> firstvibe와 함께라면, 아이디어에서 MVP까지의 여정이 더 이상 막막하지 않습니다.
당신의 혁신적인 아이디어가 현실이 되는 첫 번째 진동을 firstvibe와 함께 시작해보세요! 🚀
---
Made with ❤️ by the firstvibe team