AI 제품 개발 툴킷

AI 어시스턴트(Claude Code 또는 Codex 등)를 사용하여 웹 앱을 구조적으로 기획, 구축 및 출시하도록 돕는 프롬프트, 지침 및 명령형 스킬 모음입니다.

이 프로젝트는 MIT 라이선스를 따르며 크게 네 부분으로 구성됩니다.

---

1. 기획 프롬프트

(모든 AI 채팅 도구에서 사용 가능한) 6개의 대화형 프롬프트 세트입니다. 이 프롬프트들은 추측으로 가득 찬 문서를 즉시 작성하는 대신 먼저 사용자에게 인터뷰를 진행합니다. 몇 가지 타겟팅된 질문을 하고, 사용자와 가정을 확인한 후, 동의를 얻은 후에만 계획을 초안으로 작성합니다. 각 단계는 다음 단계의 기반이 됩니다.

단계	프롬프트 → 결과물
1	사용자 조사 설문지 → PRD를 위한 증거 기반 연구 요약
2	PRD 생성 → 제품 요구사항 문서(목표, 사용자, 요구사항, 제약 조건)
3	UX 및 사용자 흐름 → 사용자 여정, 화면, 인터페이스 요구사항
4	MVP 범위 → 핵심 가설, 우선 해결할 문제, 간결한 기능 목록
5	MVP 구축 계획 → 전체 개발 계획 또는 간소화된 "초경량" 빌드 사양
6	테스트 계획 → 테스트 범위, 테스트 유형, 환경, 진입/종료 기준

사용 방법: 프롬프트 텍스트를 복사하고( "Copy raw content" 버튼 사용), 괄호 안의 자리 표시자를 채운 뒤, AI 채팅에 붙여넣고 질문에 답하세요. 대부분 2단계부터 시작하지만, 잠재 사용자를 인터뷰할 수 있다면 1단계부터 시작하세요. 어느 단계에서든 시작할 수 있습니다.

---

2. AI 앱 스타터

아이디어부터 출시까지 Next.js + Supabase + Vercel 웹 앱을 함께 단계별로 구축하기 위해 코딩 에이전트가 따르는 지침(코드가 아님)입니다. 전체 과정을 알 필요는 없습니다. 에이전트가 안내하고 사용자는 평이한 언어로 대답하기만 하면 됩니다.

• 이 스타터는 100% 지침으로 구성됩니다: 단계별 절차, 권한 규칙, 테스트/CI 요구사항이 포함됩니다. 에이전트가 앱, 테스트, 검사 코드를 직접 작성합니다.
• 설정: Claude Code(데스크톱 또는 터미널)나 Codex에서 새 빈 폴더를 열고, 한 줄의 클론 명령어를 붙여넣은 뒤 "what's next?"와 "continue"라고 말하세요.
• 이미 PRD나 MVP 범위가 있는 경우, 스타터가 이를 요청하고 인터뷰 단계를 건너뜁니다.

안전 및 워크플로우 기능

• 운영 환경에 직접 접근 불가 — 로컬 데이터베이스와 가상의 결제/이메일 서비스를 사용하여 사용자의 컴퓨터에서만 작동합니다. 호스팅된 키(테스트 키 포함)를 보관하지 않으며, 배포 푸시와 시작은 사용자가 직접 수행합니다.
• 평이한 언어로 안내 — 다음 작업에 필요한 것만 묻고, 모든 로컬 단계를 직접 수행하며, 나머지는 명령어 한 줄이나 몇 번의 클릭으로 해결하게 합니다.
• 체계적인 유지 — 하나의 계획, 하나의 결정 파일, 하나의 알려진 문제 목록; 새로운 아이디어는 작업을 방해하지 않고 계획에 통합됩니다.

요구사항

• 시작 전: Node.js, Git, Docker.
• 앱 출시 후: GitHub, Vercel, Supabase 계정.
• 테스트 완료: Claude Code 데스크톱으로 웹 샵의 초기 부분까지, 그리고 호스팅된 스테이징/운영 환경이 있는 라이브 사이트에서 테스트 완료.
• 미테스트: Codex 및 전체 출시 과정.

---

3. 스킬

Claude Code 또는 Codex를 사용하는 경우, 기획 프롬프트, AI 앱 스타터, 비디오 메이커를 명명된 명령어(예: /prd, /ux, /mvp-scope, /nextjs-supabase-vercel)로 설치할 수 있습니다. 에이전트에 한 줄을 붙여넣으면 모두 설치됩니다(이름을 지정하여 일부만 설치할 수도 있습니다).

스킬	명령어	기능
사용자 조사	/user-research	설문지를 계획하고 응답을 PRD 입력으로 변환
PRD	/prd	인터뷰 후 제품 요구사항 초안 작성
UX 및 사용자 흐름	/ux	PRD에서 화면과 흐름 매핑
MVP 범위	/mvp-scope	구축할 가치가 있는 최소한의 첫 버전 선택
MVP 구축 계획	/mvp-plan	전체 또는 초경량 구축 계획
테스트 계획	/test-plan	테스트 범위 및 진입/종료 기준 초안 작성
AI 앱 스타터	/nextjs-supabase-vercel	스타터가 포함된 빈 폴더 설정
비디오	/remotion-video	아이디어와 스토리보드 승인 후 코드(Remotion)로 짧은 제품 영상 제작

참고:

• Codex에서는 / 대신 $를 사용하세요(예: $prd).
• 스킬은 호출할 때만 실행됩니다. 각 기획 스킬은 해당 기획 프롬프트를 그대로 실행합니다.
• 비디오 스킬은 Node.js(보통 사운드용 Python 포함)가 필요합니다. 계획을 승인하면 Remotion이 자동으로 설치됩니다. README에 데모 영상이 포함되어 있습니다.
• 스킬을 업데이트하려면 동일한 설치 명령어를 다시 붙여넣으세요.

---

4. 에이전트 설정

Anthropic 문서를 기반으로 한 Claude Code용 즉시 사용 가능한 작업 지침으로, 사용자의 설정에 병합하여 사용하는 것을 목적으로 합니다(대체용이 아님):

설정	추가 내용
Claude Sonnet 5.5 규칙 (최신)	Opus 5.5 파일 + 3가지 짧은 추가 사항: 요청하지 않은 추가 작업 금지, 계획 제시 후 중단, 완료라고 말하기 전 실제 검사 실행.
Claude Opus 5.5 규칙	명확한 범위, 간결한 답변, 최신 문서 조회(무료 문서 도구 Context7 사용)를 위한 CLAUDE.md.
Claude Opus 5 규칙	Opus 5를 위해 작성된 동일한 개념.

---

참고 사항 (README에서)

• AI 출력은 초안입니다 — 의존하기 전에 요구사항, 계획, 코드를 검토하세요.
• AI 도구에 필요 없는 개인 정보는 붙여넣지 마세요.
• 피드백은 GitHub Issues(사용된 프롬프트/스킬/스타터 선택), 질문은 Discussions, 기여는 CONTRIBUTING을 통해 환영합니다.