KhazP/vibe-coding-prompt-template

Templates and workflow for generating PRDs, Tech Designs, and MVP and more using LLMs for AI IDEs

Vibe‑Coding 프롬프트 템플릿 – 무엇인가요

Vibe‑Coding는 AI 코딩 어시스턴트(Claude, Gemini, ChatGPT, Cursor, VS Code Copilot 등)를 사용하여 아이디어를 작동 가능한 MVP로 전환하는 5단계 구조화된 워크플로우입니다. 이 리포지토리는 실행 가능한 애플리케이션을 포함하지 않으며, 대신 다음과 같은 것을 제공합니다:

어떤 채팅 기반 AI 도구에도 복사해서 붙여넣을 수 있는 준비된 프롬프트(part1‑deepresearch.md, part2‑prd‑mvp.md, …).
자신의 프로젝트 폴더 내에서 필요한 "에이전트 파일"(AGENTS.md, MEMORY.md, agent_docs/…)을 스키마화하는 작은 CLI(npx vibeworkflow).
5단계를 단계별로 안내하는 상세한 문서:
1. 심층 리서치 – 시장 데이터로 아이디어의 타당성 검증.
2. 제품 요구사항(PR D) – MVP 범위 정의.
3. 기술 설계 – 스택, 배포 대상, AI 모델 선택.
4. 에이전트 파일 – AI가 따라야 할 지시사항 생성.
5. 빌드 – AI와 협업하여 반복적으로 코드 작성, 검토, 검증.
메모리 관리, 멀티에이전트 오케스트레이션, 모델 선택 매트릭스, AI 안전 체크리스트와 같은 고급 주제에 대한 안내.

또한 이 워크플로우를 사용해 구축된 실제 프로젝트들(예: vibeworkflow.app, moneyvisualiser.com)도 목록에 포함되어 있습니다.

누구에게 적합한가요

자신만의 프롬프트 엔지니어링 기반을 만들지 않고도 AI 보조 코딩을 반복 가능한 프로세스로 원하는 단독 개발자 또는 소규모 팀.
LLM 기반 IDE와의 상호작용 구조를 구체적으로 배우고 싶은 교육자 또는 학습자.
아이디어에서 코드로의 명확하고 문서화된 인수 인계가 필요한 프로덕트 매니저.

작동 방식(개요)

프롬프트 파일(예: part1-deepresearch.md)을 채팅 창에 복사.
AI가 몇 가지 확인 질문을 하고 연구 문서를 생성.
PRD와 기술 설계 프롬프트를 차례로 반복하며, 이전 출력을 컨텍스트로 제공.
npx vibeworkflow를 실행(또는 "에이전트 파일" 프롬프트를 붙여넣기)하여 AI의 "계약서" 역할을 하는 마크다운 파일 집합(AGENTS.md, MEMORY.md 등)을 생성.
AI 지원 IDE에서 AI에게 AGENTS.md를 읽고, 기능별로 MVP를 단계적으로 구축하도록 지시하고, 각 청크 후 검토를 중단하도록 지시.

리포지토리에 포함된 내용

항목	목적
`part*.md` 파일	각 계획 단계용 프롬프트 템플릿.
`AGENTS.md` (생성됨)	프로젝트 전반에서 AI의 행동 방식을 지시하는 중심 지시사항.
`MEMORY.md` (생성됨)	채팅 컨텍스트를 과부하시키지 않는 파일 기반의 지속적 메모리.
`agent_docs/` (생성됨)	AI가 참조할 수 있는 인간이 읽을 수 있는 문서(기술 스택, 테스트 전략 등).
`npx vibeworkflow` CLI	작은 Node 기반 도우미로, `docs/`에 있는 PRD/기술설계를 기반으로 위 파일들을 자동 생성.
`README.md` (이 파일)	전체 안내, 도구 추천, 안전 지침, 예제 프로젝트 링크 포함.

왜 유용할 수 있을까

일관성 – 계획 및 인수 인계 단계를 코드화함으로써 AI가 "이탈"하거나 초기 결정을 잊는 위험을 줄임.
도구 독립성 – 어떤 채팅 기반 LLM(Claude, Gemini, ChatGPT)과도 호환되며, 다양한 IDE 확장(예: Cursor, VS Code Copilot, Claude Code 등)과도 작동.
안전 우선 – 모델 선택, 비용 제한, 프롬프트 인젝션 보호, 아티팩트 우선 메모리 체크리스트 포함으로 책임감 있는 AI 사용을 장려.
빠른 프로토타이핑 – 몇 시간 내에 완료할 수 있도록 설계되어 해커톤이나 빠른 MVP 개발에 적합.

시작하기 (빠른 단계)

Node가 설치되어 있지 않다면 설치.
새 폴더를 앱용으로 생성.
AI 지원 IDE에서 npx vibeworkflow를 실행(또는 프롬프트를 수동으로 복사). CLI가 docs/와 agent_docs/ 스키마를 생성.
part1‑deepresearch.md 프롬프트를 선택한 AI 채팅에 붙여넣고 상호작용을 따르세요.
파트 2와 3도 반복하여 출력물을 docs/에 저장.
npx vibeworkflow doctor를 실행하여 생성된 에이전트 파일을 검증.
AI에게 첫 번째 명령어를 주세요 (예: "AGENTS.md를 읽고 1단계 계획을 제안하고 승인을 기다린 후 구축"). 반복적으로 진행하세요.

제한 사항

리포지토리는 완성된 코드베이스를 제공하지 않습니다. 여전히 AI를 통해 실제 애플리케이션 코드를 작성하거나 생성해야 합니다.
성공은 기반 LLM의 능력과 입력하는 프롬프트의 품질에 달려 있습니다.
웹 또는 경량 앱 프로젝트에 적합하며, 안전이 중요한 시스템이나 엄격한 규제를 받는 시스템에는 명시적으로 권장되지 않습니다.

라이선스 및 기여

MIT 라이선스 하에 제공.
풀 리퀘스트를 환영합니다. 저자는 프롬프트와 문서의 커뮤니티 주도 개선을 장려합니다.

요약하면: vibe‑coding‑prompt‑template 리포지토리는 AI 보조 소프트웨어 개발을 오케스트레이션하는 실용적이고 오픈소스의 가이드이자 CLI이며, 반복 가능하고 안전의식이 높은 워크플로우를 통해 고수준의 아이디어를 구체적인 MVP로 전환합니다.