프롬프트 대백과

도구별 프롬프트 가이드

우리 반 모둠활동 타이머 웹앱을 만들어줘.

원칙: 프로젝터 화면에서 교실 뒤에서도 보이는 큰 타이포, 조작은 3클릭 이내.
제약: 외부 의존성 최소화(순수 HTML/JS 선호), 오프라인 동작.
완료 기준: 시간 설정 → 시작 → 종료 알림음까지 브라우저에서 직접 확인 완료.
응답은 간결하게, 최종 요약은 8줄 이내.

우리 반 모둠활동 타이머 웹앱을 만들어줘. 교실 프로젝터에 띄웠을 때 뒤에서도 잘 보이고, 수업 흐름을 끊지 않는 담백한 도구 느낌이 핵심이야.
완료 기준: 시간 설정 → 시작 → 종료 알림까지 브라우저에서 바로 동작. 스택과 구조는 네가 최적이라 판단하는 대로.

안티그래비티 마이크로매니징 플레이북

원칙은 하나다 — 모델의 자율 설계에 맡기지 말고, 하네스를 먼저 세운 뒤 그 안에서 일을 시킨다. 하네스는 md 파일로 세우고, 세션은 5단계 루프로 운영한다.

폴더 + md 파일 기반 하네스 구축

안티그래비티는 프로젝트 루트의 GEMINI.md(또는 AGENTS.md)를 자동 참조한다. 여기에 docs/ 폴더의 문서 3종을 더해 "에이전트의 헌법 + 설계도 + 작업대장 + 결정 기록" 4층 구조를 만든다.

my-project/
├── GEMINI.md              ← ① 헌법: 스택·버전, 규칙, 금지사항, 검증 명령, 완료 정의
├── docs/
│   ├── ARCHITECTURE.md    ← ② 설계도: 폴더 구조, 모듈 경계, 데이터 흐름(단방향 등)
│   ├── TASKS.md           ← ③ 작업대장: 체크박스 백로그 — 한 턴에 한 항목씩
│   └── DECISIONS.md       ← ④ 결정 기록: 무엇을 왜 택했는지 2줄씩 (다음 세션의 기억)
├── src/
│   ├── engine/  (핵심 로직 — UI와 분리)
│   ├── components/  (UI)
│   ├── store/  (상태 관리 — 한 곳에서만)
│   └── data/  (콘텐츠 JSON — 코드와 분리)
└── tests/  (검증 스크립트)

GEMINI.md에 반드시 넣을 6가지 — 이 파일의 밀도가 곧 결과물의 품질이다.

• 기술 스택 + 정확한 버전 — "Vite 7 + React 19 + Zustand 5, 변경 금지"처럼 버전까지 못 박는다. (예시의 버전은 작성 시점 기준 — 프로젝트에 맞게 교체)
• 파일 배치 규칙 — 로직은 /src/engine, UI는 /src/components, 콘텐츠는 /src/data/*.json 식으로 새 파일이 갈 곳을 정해둔다.
• 금지사항 — "승인 없는 신규 의존성 설치 금지", "한 파일 300줄 초과 금지", "/src/data 스키마 임의 변경 금지"
• 검증 명령 — npm run test, npm run build처럼 에이전트가 스스로 돌릴 수 있는 명령. 테스트가 없다면 "테스트 블록부터 작성"을 규칙으로.
• 완료 정의(DoD) — "테스트 통과 + 빌드 성공 + 브라우저 시나리오 확인 + 콘솔 에러 0건"
• 수정 프로토콜 — "구조 변경·의존성 추가는 실행하지 말고 제안 후 대기"

세션 운영 — 5단계 마이크로매니징 루프

1. 하네스 셋업 (첫 세션)폴더와 md 파일만 만들게 하고 멈춘다. 기능 코드는 한 줄도 금지.
2. 계획 아티팩트작업 1건의 구현 계획을 아티팩트로 받고, 인라인 코멘트로 수정 후 승인.
3. 작업 단위 실행한 턴에 TASKS.md 한 항목. @경로로 대상 지정, "그 외 파일 수정 금지"로 범위 봉쇄.
4. 검증 루프테스트 실행 → 실패 시 수정 반복 → 브라우저 시나리오 수행 + 스크린샷 검증.
5. 기록 갱신TASKS.md 체크, DECISIONS.md에 결정 2줄 추가. 그리고 2단계로 복귀.

단계별 복붙 프롬프트 — 그대로 붙여넣고 대괄호만 바꾼다.

새 프로젝트의 하네스만 먼저 구축한다. 이번 턴에서는 기능 코드를 한 줄도 작성하지 마.

1. 다음 구조로 폴더를 생성해: /src/engine, /src/components, /src/store, /src/data, /tests, /docs
2. 프로젝트 루트에 GEMINI.md를 작성해. 반드시 포함:
   - 기술 스택과 버전: [Vite 7 + React 19 + Zustand 5] (변경 금지)
   - 파일 배치 규칙: 로직은 /src/engine, UI는 /src/components, 콘텐츠 데이터는 /src/data/*.json
   - 금지사항: 승인 없는 신규 의존성 설치 금지, 한 파일 300줄 초과 금지, /src/data 스키마 임의 변경 금지
   - 검증 명령: npm run test, npm run build
   - 완료 정의: 테스트 통과 + 빌드 성공 + 브라우저 시나리오 확인 + 콘솔 에러 0건
   - 수정 프로토콜: 구조 변경·의존성 추가는 제안만 하고 대기
3. /docs/ARCHITECTURE.md에 모듈 경계와 데이터 흐름(엔진 → 스토어 → 컴포넌트 단방향)을 텍스트 다이어그램으로 작성해.
4. /docs/TASKS.md에 [프로젝트 목표]를 작업 단위로 쪼갠 체크박스 백로그를 작성해.
여기까지 하고 멈춰. 내가 md 파일들을 검토한다.

@docs/TASKS.md 의 [1번] 항목을 구현하기 전에, 구현 계획을 아티팩트로 먼저 작성해.
계획에 포함: 수정·생성할 파일 목록, 각 파일의 변경 요지, 검증 방법.
내가 계획을 승인하기 전에는 코드를 작성하지 마.

승인한 계획대로 @src/engine/[TurnManager.ts] 만 구현해.
계획에 없는 파일은 수정 금지. 새 의존성이 필요하면 설치하지 말고 제안만 하고 멈춰.

구현이 끝났으면:
1. npm run test 실행 → 실패하면 원인 분석 후 수정, 통과할 때까지 반복
2. npm run dev로 띄운 뒤 브라우저에서 [카드 3장을 드래그해서 내는] 시나리오를 직접 수행하고 스크린샷으로 검증해
3. 콘솔 에러 0건 확인. 실패 항목이 남으면 보고하고 멈춰.

@docs/TASKS.md 에서 방금 완료한 항목을 체크하고,
@docs/DECISIONS.md 에 이번 턴의 기술 결정(무엇을·왜)을 2줄 이내로 추가해.

프롬프트 문장 수칙 10

• 1. 절차는 번호로. 실행 순서를 모델 판단에 맡기지 않는다.
• 2. 파일은 @경로로 정확히. "그 파일" 같은 대명사 금지.
• 3. 한 프롬프트 = 한 작업 단위. "그 외 파일 수정 금지"를 습관처럼 붙인다.
• 4. 라이브러리는 이름 + 버전까지. "적당한 차트 라이브러리" 금지 → "Recharts 3.x".
• 5. 패턴을 명명한다. 싱글톤, 단방향 데이터 흐름, 커스텀 훅 — 이름을 불러야 그 형태로 짠다.
• 6. 각 단계 끝에 정지점 또는 검증점. "여기까지 하고 멈춰" / "확인 후 보고해".
• 7. 시각 문제는 스크린샷·영상 첨부. 말로 묘사한 UI 버그는 절반만 전달된다.
• 8. 수정은 재프롬프트 대신 인라인 코멘트. 언급하지 않은 부분이 보존된다.
• 9. 구조 변경·의존성 추가는 "제안 후 대기". 되돌리기 힘든 결정은 사람이 승인한다.
• 10. 상태는 md에 남긴다. 세션은 휘발되지만 TASKS.md와 DECISIONS.md는 남는다.

같은 요청, 다른 결과

멋진 물리 퀴즈 앱 만들어줘. 구조는 알아서 잘 잡아줘.

물리 퀴즈 앱을 만든다. 순서대로:
1. quiz.json 스키마(id, unit, question, choices, answer, explanation)를 아티팩트로 제시하고 내 승인 대기
2. 승인 후 /src/components에 QuizCard·ProgressBar, /src/hooks/useQuizSession.ts 구현. 문항은 /src/data/quiz.json에서만 로드, 임의 생성 금지
3. 브라우저에서 10문항 풀이 시나리오를 직접 수행하고 스크린샷으로 검증. 콘솔 에러 0건.
규칙은 GEMINI.md 참조. 1~3 외 작업 금지.

모델 배분 전략

• 계획·설계·대규모 분석 → Gemini 3.1 Pro. 1단계(하네스 셋업)와 2단계(계획 아티팩트), 긴 코드베이스 리뷰에 투입.
• 실행·반복 수정 → Gemini 3.7 Flash. 3~5단계 루프의 손발. 8/13부터 기본 에이전트 모델이며, 3.6 대비 코딩 벤치마크가 크게 올랐다(DeepSWE v1.1 49.0%→65.3%).
• 예약 작업(Scheduled Tasks)은 Gemini 3.5 Flash 고정 — 야간 자동 점검 등을 걸어둘 때 참고.

결과물 유형별 프롬프트

같은 과제를 3사 스타일로 병렬 비교한다. 카드의 대괄호 [ ]는 자기 프로젝트에 맞게 바꿔 쓰는 자리다.

다크 판타지 톤의 웹 덱빌딩 로그라이크를 만들어줘. 체력이 곧 카드 비용이라 매 선택이 절박하게 느껴지는 게 핵심 감성이고, 타격감 있는 연출이 있어야 해.
완료 기준: 브라우저에서 바로 열어 1개 전투를 처음부터 끝까지 플레이할 수 있고, 흔들림 없는 60fps. 스택과 프로젝트 구조는 네가 최적이라 판단하는 대로 세팅해.

웹 기반 덱빌딩 로그라이크 게임을 구축해줘.

아키텍처 원칙:
- 게임 엔진(턴·전투 로직)과 콘텐츠(카드 데이터)를 완전히 분리. 카드는 /src/data/cards.json에서 로드하고, 나중에 500장으로 늘려도 코드 수정이 없어야 함
- 상태와 렌더링은 단방향으로 분리, 렌더링은 Canvas
- 코어 메커니즘: 체력을 카드 비용으로 사용

완료 기준: 카드 5종으로 1개 전투를 끝까지 플레이 가능, 60fps 유지, 테스트 통과, 브라우저에서 직접 확인 완료.
서브에이전트는 독립적으로 병렬화되는 작업에만 사용해. 응답은 간결하게, 최종 요약은 10줄 이내.

덱빌딩 게임의 코어를 구축한다. 이번 턴은 1~3번까지만.
1. [Vite 7 + React 19 + Zustand 5] 프로젝트 생성, /src/engine·/src/store·/src/components·/src/data로 분리
2. /src/engine/TurnManager.ts를 싱글톤으로 구현 — 페이즈: draw → main → enemy → cleanup
3. /src/data/cards.json 스키마와 샘플 카드 5장을 작성한 뒤, 다음 단계 구현 계획을 아티팩트로 만들어 내 검토 대기
승인 후: Card 렌더 컴포넌트 구현 → 브라우저에서 카드 1장을 내는 시나리오를 직접 수행하고 스크린샷으로 검증. 계획 외 파일 수정 금지.

학생이 매일 아침 5분씩 푸는 [물리] 퀴즈 PWA를 만들어줘. 문항은 첨부한 quiz.json만 사용해(임의 생성·수정 금지). 정답을 맞힐 때마다 성취감이 확 오는 가볍고 경쾌한 연출이 감성 포인트야.
완료 기준: 10문항 세션 + 즉시 정오답 피드백 + 진행도 저장, 모바일에서 깨짐 없음.

고등학생용 [물리] 개념 퀴즈 웹앱을 만들어줘.

제약 조건(위반 금지):
- 문항·정답·해설은 내가 제공하는 /src/data/quiz.json만 사용, 임의 생성·수정 금지
- 오프라인 우선 동작, 새로고침해도 진행도 유실 없음
- 웹 접근성(a11y) 준수, 모바일 우선 레이아웃

완료 기준: 10문항 세션 완주 → 즉시 정오답 피드백 → 오답노트 화면까지, 모바일 뷰포트 브라우저에서 시나리오 확인 완료. 최종 요약은 8줄 이내.

[물리] 퀴즈 앱을 만든다. 순서대로:
1. quiz.json 스키마를 아티팩트로 제시하고 내 승인 대기 — 필드: id, unit, question, choices, answer, explanation
2. 승인 후 /src/components에 QuizCard·ProgressBar·ResultView, /src/hooks/useQuizSession.ts 구현. 문항은 /src/data/quiz.json에서만 로드, 임의 생성 금지
3. 브라우저에서 10문항 풀이 시나리오(정답 7·오답 3)를 직접 수행하고 스크린샷으로 검증. 콘솔 에러 0건.
규칙은 GEMINI.md 참조. 1~3 외 작업 금지.

매일 아침 매출·재고를 한눈에 보는 SPA 대시보드를 만들어줘. 여백 많고 미니멀한 다크 모드 감성.
완료 기준: 첨부한 샘플 CSV가 업로드 즉시 차트 3종(막대·라인·요약 카드)으로 렌더되고, 모바일에서도 레이아웃이 유지됨. 스택은 알아서.

CSV를 올리면 매출·재고를 보여주는 대시보드를 셋업해줘.

설계 원칙:
- 대용량(10만 행) 렌더 시 메모리 누수 방지에 초점
- 차트 컴포넌트는 데이터·설정 props만 받는 재사용 구조 — 새 차트 추가 시 기존 코드 수정 없어야 함
- 색약 대응 팔레트

완료 기준: 샘플 CSV 로드 → 막대·라인·요약 카드 렌더, 10만 행에서 인터랙션 지연 체감 없음, 브라우저 확인 완료.

Vite + React 대시보드를 세팅한다.
1. papaparse와 Recharts만 설치 — 다른 의존성 추가 금지
2. /src/utils/parseCsv.ts에 파싱·검증 로직(빈 값 처리, 숫자 형변환, 실패 행 리포트) 구현
3. /src/components/charts에 BarChart·LineChart를 분리 구현, 로딩 중 스켈레톤 UI 필수
4. 샘플 CSV로 브라우저 렌더를 직접 확인하고 스크린샷으로 검증. 1~4 외 작업 금지.

행사 접수용 대기번호 키오스크 웹앱. 입력 → 출력 예시:
- 접수 화면에서 [접수] 클릭 → "037번" 크게 표시
- 관리자 화면에서 [다음 호출] → 대기 표시 화면에 "037번 → 1번 창구" + 알림음
완료 기준: 위 두 흐름이 실제로 동작하고, 새로고침해도 번호가 이어지며, 연타해도 중복 발급이 없음.

행사 접수용 대기번호 키오스크 웹앱을 만들어줘.

스펙: 접수 화면 [접수] 버튼 → 001부터 번호 발급 / 관리자 화면에서 호출 → 대기 표시 화면에 번호 + 알림음.
엣지케이스: 새로고침해도 번호 연속성 유지, 999 초과 시 다음 회차로 리셋, 연속 클릭 시 중복 발급 방지.
완료 기준: 브라우저 창 2개(접수·관리자)로 발급 → 호출 흐름 확인 완료.

대기번호 키오스크 앱을 만든다.
1. /src/pages에 Kiosk.tsx(접수)·Admin.tsx(호출)·Display.tsx(대기 표시) 3화면 생성
2. 번호 상태는 /src/store/queue.ts 한 곳에서만 관리, BroadcastChannel로 창 간 동기화
3. 엣지케이스 처리: 새로고침 복원, 발급 후 1초 잠금으로 중복 클릭 방지, 999 초과 시 회차 리셋
4. 브라우저 창 2개를 띄워 발급 → 호출 시나리오를 직접 수행하고 스크린샷으로 검증. 1~4 외 작업 금지.

한 장 요약

페르소나 공식

• 코덱스 = 시니어 CTO에게 맡기듯. 목표·감성·완료 기준만. 수단을 지시하는 순간 손해.
• 클로드코드 = 수석 아키텍트에게 원칙을 주듯. 설계 원칙·제약 조건·완료 기준. 재검증 지시는 삭제.
• 안티그래비티 = 시공 파트너에게 설계도를 주듯. 구조·순서·검증점을 번호로. 계획 아티팩트로 합 맞추고 시작.

만능 골격 3종

[무엇을 만들지 — 도착점 한 문단]
[감성/느낌 한 줄]
완료 기준: [~가 실제로 동작하면 완료]. 스택과 구조는 네가 최적이라 판단하는 대로.

[무엇을 만들지 한 문단]

원칙/제약(위반 금지):
- [아키텍처 원칙 1~3개]
- [절대 제약 1~2개]

완료 기준: [테스트/브라우저 확인 포함]. 응답은 간결하게, 최종 요약은 [N]줄 이내.

[프로젝트]를 만든다. 순서대로:
1. [구조/스키마/계획] 을 아티팩트로 제시하고 내 승인 대기
2. 승인 후 [@정확한/파일/경로] 에 [무엇] 구현 — [라이브러리 이름+버전], [패턴 이름] 사용
3. [검증 명령 실행 → 통과까지 반복] + 브라우저에서 [시나리오] 수행, 스크린샷 검증
규칙은 GEMINI.md 참조. 1~3 외 작업 금지.

Do / Don't

상황별 모델 선택

출처 및 기준

본 문서는 2026년 6~8월 각 사가 공개한 공식 문서를 1차 근거로 작성했다. 기준일: 2026-08-23(최초 작성 2026-08-09).

공식 문서

• Anthropic — Prompting Claude Opus 5 · Prompting best practices
• OpenAI — GPT-5.6 Model guidance · Codex Prompting Guide · GPT-5.6 Sol 모델 문서 · GPT-5.6 August Updates (PDF)
• Google — Antigravity Best Practices · Gemini 3.7 Flash in Antigravity · What's new in 3.7 Flash · Gemini 3 개발자 가이드 · 3.7 Flash 모델 카드 · Gemini 3.6 Flash 발표

보조 자료

• GPT-5.6 출시·티어 해설 (Vellum, AWS Bedrock 블로그, 2026.07)
• Claude Sonnet 5 (2026.06.30) · Opus 5 (2026.07.24) 출시 보도 및 리뷰
• Antigravity 2.0 기능 해설 (Google I/O 2026, 커뮤니티 가이드)