오버셰어링 중단은(는) 무엇을 하나요?
빌더 프롬프트는 비공개 컨텍스트이며 결코 고객 카피가 아닙니다. 고객 인터페이스는 인간 프로덕트 팀이 작성한 것처럼 읽혀야 합니다: 내부 정보 누출 제로, 불필요한 부제목 제로, AI 카피라이팅 특유의 표현 제로.
적용 범위
- 엄격: UI 컴포넌트, 랜딩 페이지, 가격, 온보딩, 설정, 폼, 모달, 빈 상태, 토스트, 로더, 오류 메시지, 스토어 목록, SEO 메타데이터.
- 차분하고 사실 중심:
/privacy,/terms,/security,llms.txt, SDK 문서, 체인지로그 (기술적 사실은 허용되지만, 과장된 표현, "대체하기 위해 추가됨"과 같은 메타 서술, AI 클리셰는 금지). - 예외: 코드 주석, 커밋 메시지, 풀 리퀘스트, 내부 문서, 관리자 뷰.
1. 오디언스 게이트
UI 카피를 작성하기 전에 프롬프트의 모든 사실을 분류하세요:
- 제거 (UI에서 0 단어): 검토 큐 (
in review,TestFlight,pending approval), KYC 또는 DNS 차단, 스토리지 및 데이터베이스 관련 (localStorage,IndexedDB,SQLite,Redis, 벡터 DB, 모델 이름), 호스팅 비용 동기, 키 저장소, 패키지 또는 스토어 ID, 서명 관련 변명. - 변환: 빌더 컨텍스트를 차분한 고객 언어로 다시 작성하세요:
| 내부 컨텍스트 | 절대 쓰지 말 것 | 대신 쓸 것 |
|---|---|---|
| 앱 또는 확장 프로그램 검토 중 | In App Store review, Pending approval | Coming soon (로드맵 배지만) |
| 오프라인 또는 브라우저 저장소 | Stored in IndexedDB, No backend | 0 단어 (또는 히어로에 Works offline) |
| AI 검색 및 대체 LLM | Querying Pinecone vectors via Haiku fallback... | Ask your docs / Searching... |
| 결제 또는 SSO 차단 | Stripe KYC pending, SAML blocked | 출시된 경로 명시 (Subscribe in app) |
| 서명되지 않은 데스크톱 빌드 | Notarization pending; right-click Open | Direct download · macOS and Windows |
| 암호화 파이프라인 | Military-grade encryption outside DB | Encrypted sync (명세는 /privacy) |
| 앱 또는 번들 식별자 | com.acme.app, id1234567890 | 본문에서 생략; 스토어 배지 링크만 |
- 유지: 오늘 작동하는 것과 다음 동작. references/translations.md 및 references/leak-patterns.md 참조.
2. 밀도 계약 및 제목 반복 금지 규칙
헤딩이나 레이블을 반복하는 도움말 텍스트를 삭제하세요 (Notifications -> "Configure how you receive notifications"). 보이는 레이아웃을 서술하지 마세요 ("The table below compares...", "Use the form below to..."). 빈 카드를 패딩하지 마세요.
| 슬롯 | 상한선 | 규칙 |
|---|---|---|
| 히어로 부제목 | 1문장, <= 18 단어 | 결과 및 지원 플랫폼 |
| 상태 배지 | 1~3 단어 | Live는 기본값; 배지는 Coming soon만 |
| 요금제 불릿 | <= 6 단어 | 출시된 기능만 |
| 카드 부제목 | <= 10 단어 (또는 0) | 헤딩과 버튼으로 충분하면 생략 |
| 설정 또는 폼 도움말 | 0 단어 기본값 | 비자명한 형식에만 <= 10 단어 |
| 빈 상태 | <= 6 단어 + 1 버튼 | 데이터베이스, 테이블, 쿼리 명사 제로 |
| 토스트 | 1~4 단어, ! 없음 | Saved, Copied, Invite sent |
| 로딩 상태 | 1~3 단어 | Searching..., Generating... |
| 오류 | 실패한 내용 + 다음 단계 | HTTP 코드, 경로, 비율 창 제로 |
3. 반-편집증 규칙
요청받지 않은 부인을 자발적으로 제공하지 마세요 ("Never leaves your computer", "Zero servers", "100% local", "Military-grade"). 데이터 처리는 /privacy에서 차분하게 공개하세요.
4. 인간적인 목소리
내부 정보 누출과 함께 인공적인 AI 카피라이팅 특유의 표현을 제거하세요:
- "Not X, just Y" 대조 금지: 부정적인 설정을 제거하세요 ("Not just a note app, it's...", "Built for speed, not bloat", "No fluff, just..."). 제품이 하는 일을 직접 서술하세요.
- 억지 3박자 또는 단문 슬로건 금지: 세 개의 박자로 된 조각을 제거하세요 ("Fast. Simple. Powerful.", "Plan. Track. Ship."). 세 쌍 ("design, collaborate, and scale")을 하나의 구체적인 기능이나 숫자로 대체하세요.
- UI 카피에서 엠 대시(
—) 또는 공백--금지: 마침표, 쉼표, 콜론을 사용하거나 두 번째 절을 제거하세요. - 상용 AI 유행어 또는
-ing꼬리 금지:seamless,seamlessly,effortless,effortlessly,supercharge,unleash,elevate,empower,streamline,cutting-edge,next-generation,game-changing,robust,tailored,delve,tapestry,pivotal,reimagining,crafted for modern teams및 덧붙여진 분사 ("...ensuring effortless sync")를 금지합니다.serves as또는boasts보다는 평이한 동사 (is,has,syncs,exports)를 선호하세요. - 장식적인 포맷팅 금지: 헤딩, 카드 레이블 및 버튼은 문장형 대소문자로 쓰세요 (고유 명사와 요금제 이름만 제목형 대소문자 유지). 기능 목록이나 헤딩에 이모지 불릿 (
🚀,✨,⚡,🔒,💡,🎉)을 절대 넣지 마세요. 기능 목록 전체에**Bold Label:** 설명을 반복하지 마세요. - 챗봇 또는 가짜 활기찬 마이크로카피 금지: 연출된 오프너 ("Let's dive in", "Here's what you need to know"), 과장된 칭찬 ("You're all set!", "Awesome!"), 가식적인 사과 ("Oops! Something went wrong"), 일상적인 UI 상태의 느낌표를 제거하세요.
5. 감사 모드 및 위험 신호
python3 scripts/audit.py src/ app/를 사용하여 소스 트리를 스캔한 후, 플래그가 지정된 카피를 단어 동의어 교체 대신 구체적인 사실을 중심으로 다시 작성하세요. references/examples.md 참조.
즉시 재작성이 필요한 위험 신호: in review, pending approval, localStorage, local storage, IndexedDB, no backend, vector embeddings, fallback model, rate limit, KYC, notarization, never leaves your, military-grade, 패키지 ID(본문 내), 반복된 설정 부제목, "has been successfully saved", seamless, effortless, supercharge, unleash, not just a, 단문 3단어 슬로건, 이모지 기능 불릿, 괄호 엠 대시, "Oops! Something went wrong", "You're all set!".