당신의 vibe-coded 프로젝트가 정체되어 있나요?_

Vibe coding 도구들은 시작을 쉽게 만들어 주었지만, 계획 단계를 건너뛰게 만들었고, 당신은 그 대가로 80% 지점에서 막히게 됩니다.

그들은 시작을 쉽게 만들었습니다. 하지만 아무도 끝내는 것을 쉽게 만들지 않았습니다.

VibeScaffold는 AI 도구가 제품 출시(shipped)까지 완주하는 데 필요한 사양(spec)을 생성합니다. 즉, 명확한 요구사항(requirements), 지속적인 컨텍스트(persistent context), 그리고 정의된 수락 기준(acceptance criteria)을 제공합니다.

작동 방식

완전한 사양(spec)을 위한 3단계

아이디어 설명하기

무엇을 만들고 싶은지 평이한 영어로 말씀해 주세요.

채팅으로 정교화하기

AI가 빈틈을 채우기 위해 적절한 질문을 던집니다.

4개의 문서 다운로드

어떤 AI 코딩 도구에도 바로 붙여넣을 수 있는 사양(spec) 파일들을 받으세요.

80%의 문제

AI가 80%까지는 해줍니다. 그러다 벽에 부딪히죠.

명확한 사양(spec)의 부재

• • 모호한 사용자 스토리(user stories), 누락된 예외 케이스(edge cases)
• • AI가 빈틈을 환각(hallucinated)된 기본값으로 채움

ONE_PAGER.md + DEV_SPEC.md

대상 사용자, MVP 범위, 인증(auth), 데이터 모델(data model)에 대한 결정을 사전에 강제합니다.

파편화된 컨텍스트(Context)

• • 채팅 기록 여기저기에 흩어진 아이디어들
• • 에이전트(Agent)가 프로젝트 전체를 메모리에 유지할 수 없음

4개의 문서 모두가 서로를 보완함

AI 에이전트가 매 세션마다 참조할 수 있는 단일 진실 공급원(Single source of truth)을 제공합니다.

정의되지 않은 '완료'

• • 테스트 케이스(test cases) 없음, 수락 기준(acceptance criteria) 없음
• • 수정할 때마다 다른 부분이 망가짐

PROMPT_PLAN.md + AGENTS.md

TDD 체크박스와 수락 기준(acceptance criteria)이 포함된 단계별 프롬프트(prompts)를 제공합니다.

얻게 되는 것

네 개의 문서. 무엇이 들어있는지 확인해 보세요.

Photo Captioner 앱을 위해 VibeScaffold가 생성한 실제 결과물입니다.

Photo Captioner - One-Pager

목적

가벼운 모바일 앱으로, 일상적인 소셜 미디어 공유자들이 정확하고 공유하기 좋은 텍스트를 빠르게 작성할 수 있도록 사진에 대한 매력적인 캡션(caption)을 생성해 줍니다.

문제

소셜 미디어 사용자들은 사진에 어울리는 짧고 매력적인 캡션을 찾는 데 종종 어려움을 겪습니다. 이들은 적절한 어조(tone)나 문구를 고민하며 시간을 소비하지 않고, 빠르고 창의적인 텍스트를 원합니다.

타겟 오디언스 (Target audience)

• 주요 대상: 일상적인 소셜 공유자
  • 소셜 플랫폼에 사진을 게시하는 일반 사용자 (친구, 가족, 라이프스타일 게시물)
• 목표: 최소한의 마찰로 빈번하게 게시하기, 사진을 더 매력적으로 만들기, 노력 없이 자연스럽고 재미있게 들리기

핵심 사용자 흐름 (Core user flow, MVP)

1. 앱 열기 (MVP 단계에서는 계정 불필요)
2. 사진 업로드 / 새 사진 촬영
3. 프리셋에서 어조(tone) 선택: 재미있는(Funny), 진심 어린(Heartfelt), 위트 있는(Witty)
4. "Generate" 탭 → 진행 상황 표시
5. 세 가지 캡션 제안 표시
6. 사용자가 선택한 캡션의 "Copy" 탭

Photo Captioner - 개발자 사양 (Developer Specification, MVP)

1. 요약 및 목표

---

• 모바일: React Native (Expo) + TypeScript
• 백엔드 (Backend): Node.js (18+) + TypeScript + Fastify
• 추론 (Inference): OpenAI gpt-5-nano (멀티모달, multimodal)
• 인증 (Auth): Firebase Authentication (비밀번호 없는 이메일 방식)
• 스토리지 (Storage): Google Cloud Storage (6시간 TTL)

2. 상위 수준 아키텍처 (High-level architecture)

---

시퀀스:

1. 클라이언트가 Firebase ID 토큰과 함께 /presign-upload 요청
2. 백엔드가 사전 서명된(presigned) PUT URL과 objectPath를 반환
3. 클라이언트가 GCS로 이미지를 직접 업로드
4. 클라이언트가 objectPath + tone과 함께 /generate 호출
5. 백엔드가 검증을 수행하고 Vision SafeSearch 실행
6. OpenAI gpt-5-nano 호출 → 3개의 캡션 반환
7. 모더레이션(moderation)을 실행하여 안전하지 않은 콘텐츠 필터링
8. 최대 3개의 안전한 캡션 반환

6. API 규약 (API contract)

---

POST /generate
요청 (Request): { objectPath, tone: "funny"|"heartfelt"|"witty" }
응답 (Response): { suggestions: [{ id, text, safety_flags }] }

Prompt Plan - Photo Captioner (MVP) 전체 단계 구분 -----------------------

Stage A - 프로젝트 스캐폴딩 (Project scaffolding)
Stage B - 핵심 백엔드 및 인증 (Core backend & auth)
Stage C - 미디어 처리 및 안전성 (Media processing & safety)
Stage D - 모델 오케스트레이션 (Model orchestration)
Stage E - 속도 제한이 적용된 /generate 엔드포인트 (/generate endpoint with rate limiting)
Stage F - 관리자 흐름 (Admin flows)
Stage G - 클라이언트 + CI/CD + 배포 (Client + CI/CD + deployment)

Prompt 0 - Repo 스캐폴딩 (Repo scaffolding) ---------------------------
할 일 체크리스트 (Todo checklist):

• 스크립트가 포함된 package.json 생성
• tsconfig.json, jest.config.js 추가
• /health 경로가 포함된 src/index.ts 구현
• test/health.test.ts 추가
• Dockerfile 스켈레톤 (skeleton) 추가

Prompt 2 - Firebase 인증 검증 (Firebase Auth verification) -------------------------------------
할 일 체크리스트 (Todo checklist):

• src/services/authService.ts 생성
• verifyFirebaseToken 미들웨어 추가
• 모킹(mocked)된 Firebase Admin을 사용한 단위 테스트(unit tests) 작성
• /presign-upload 및 /generate 경로 보호

AGENTS.md

목적 (Purpose) -------
이 파일은 자동화된 에이전트(Codex, Claude Code, CI bots)가 저장소 워크플로우와 책임 사항을 파악하도록 안내합니다.

에이전트 책임 (Agent responsibility) --------------------

• 어떤 단계든 완료한 후에는 즉시 prompt_plan.md의 TODO 체크리스트를 업데이트할 것
• 테스트가 통과(green)될 때까지 작업을 "완료"된 것으로 간주하지 말 것
• 코드 변경 사항과 함께 항상 prompt_plan.md를 커밋할 것

테스트 정책 (Testing policy) (협상 불가) -------------------------------

• 테스트는 반드시 구현 중인 기능을 커버해야 함
• 테스트 출력 결과를 절대 무시하지 말 것
• 로그에는 중요한(CRITICAL) 정보가 포함되어 있음
• 구현 전(TDD)에 테스트를 작성할 것

가드레일 (Guardrails) ----------

• 테스트를 통과하는 가장 작은 단위의 변경만 수행할 것
• 문제를 우회하기 위해 파일을 중복 생성하지 말 것
• 파일을 열 수 없는 경우, 이를 알리고 중단할 것

이것은 짧은 발췌본입니다. 전체 문서는 100~800줄의 상세 사양으로 구성되어 있습니다.

샘플 팩 다운로드 (Download Sample Pack (ZIP)) Photo Captioner 앱을 위한 4개의 완전한 문서

무료. 계정이 필요하지 않습니다.

이미 사용 중인 도구들과 함께 작동합니다

Claude Code • Cursor • Codex CLI • Windsurf • Copilot

다음과도 작동합니다: Lovable, Bolt, v0, Replit, 그리고 마크다운 컨텍스트(markdown context)를 수용하는 모든 도구