product-marketing-context

product-marketing-context 스킬 개요

product-marketing-context가 하는 일

product-marketing-context 스킬은 .agents/product-marketing-context.md에 팀이 함께 참조할 수 있는 제품 마케팅 소스 파일을 만들고 유지하도록 도와줍니다. 역할은 단순하지만 실무적으로 매우 유용합니다. 제품 개요, 타깃 고객, 포지셔닝, 주요 이의 제기, 신뢰 근거, 메시지의 기본 뼈대를 한 번 정리해 두면, 이후 다른 마케팅 워크플로가 같은 기초 질문을 매번 다시 하지 않고 이 문서를 재사용할 수 있습니다.

이 스킬이 잘 맞는 사용자

이 스킬은 리포지토리나 클라이언트 프로젝트 전반에서 AI 기반 마케팅 작업을 반복 가능하게 운영해야 하는 창업자, 제품 마케터, 그로스 리드, 에이전시에 특히 잘 맞습니다. 포지셔닝, ICP 정리, 랜딩 페이지 초안, 캠페인 기획, 세일즈 활성화 콘텐츠처럼 메시지 일관성이 중요한 작업에서 특히 효과적입니다.

이 스킬이 실제로 해결하는 일

대부분의 팀에 필요한 것은 “카피를 더 많이” 만드는 일이 아닙니다. 모델이 어떤 글을 쓰기 전에 먼저 참조할 수 있는 안정적인 컨텍스트 레이어가 필요합니다. product-marketing-context skill은 바로 그 선행 설정 단계에 맞춰 설계되었습니다. 먼저 재사용 가능한 마케팅 컨텍스트 문서를 만들고, 이후 다른 스킬이 그 위에서 작업하도록 돕습니다.

일반 프롬프트보다 나은 이유

일반 프롬프트로도 포지셔닝을 요청할 수는 있지만, 대개는 일회성 답변으로 끝납니다. product-marketing-context는 다음과 같은 운영 흐름을 전제로 구조화되어 있습니다.

• 먼저 기존 컨텍스트 파일이 있는지 확인
• 바뀐 섹션만 업데이트
• 코드베이스 기반 자동 초안 또는 처음부터 시작하는 가이드형 플로우 제공
• 다른 스킬이 참조할 수 있도록 예측 가능한 파일 경로에 결과 저장

그래서 단순한 “메시징 좀 도와줘” 프롬프트보다 훨씬 운영 친화적입니다.

잘 맞는 경우와 잘 맞지 않는 경우

잘 맞는 경우:

• 아직 메시지 기반이 없는 신규 제품
• 여러 AI 마케팅 스킬을 함께 사용할 리포지토리
• 출시, 가격 변경, 타깃 고객 변화 이후 포지셔닝을 업데이트하는 팀

잘 맞지 않는 경우:

• 지속적으로 유지할 컨텍스트 없이 일회성 카피 작업만 필요한 경우
• 확인할 수 있는 리포지토리나 제품 자료가 거의 없는 경우
• 이 스킬만으로 깊이 있는 시장조사까지 기대하는 팀

product-marketing-context 스킬 사용 방법

설치 컨텍스트와 파일 저장 위치

환경에서 Skills 설치를 지원한다면, 상위 리포지토리를 추가한 뒤 그 안의 product-marketing-context 스킬을 사용하면 됩니다. 이 스킬의 핵심 산출물 파일은 다음 경로에 저장됩니다.

/.agents/product-marketing-context.md

이 스킬은 이전 구성에서 사용하던 .claude/product-marketing-context.md도 확인하며, 필요하면 그 내용을 새 경로로 옮기는 작업도 도와줍니다.

먼저 기존 컨텍스트 파일부터 확인하세요

새로 만들기 전에, 의도된 워크플로는 먼저 다음 파일이 있는지 확인하는 것입니다.

• .agents/product-marketing-context.md
• .claude/product-marketing-context.md

이미 컨텍스트 파일이 있다면 올바른 접근은 “전부 다시 쓰기”가 아닙니다. 먼저 읽고, 이미 어떤 내용이 잡혀 있는지 요약한 뒤, 사용자의 변경 사항에 영향받는 섹션만 업데이트해야 합니다.

상황에 맞는 시작 경로를 고르세요

리포지토리에는 실무적으로 두 가지 진입 경로가 제시되어 있습니다.

1. 코드베이스에서 자동 초안 생성
   README.md, 랜딩 페이지 카피, 문서, package.json, 앱 내 제품 카피처럼 활용 가능한 신호가 리포지토리에 있을 때 권장됩니다.

2. 처음부터 시작
   리포지토리 정보가 빈약하거나, 코드보다 비공개 자료가 더 중요하거나, 제품 정의 자체가 아직 진행 중일 때 더 적합합니다.

이 점은 product-marketing-context guide에서 가장 중요한 도입 판단 기준 중 하나입니다. 보유한 근거의 품질에 맞는 경로를 골라야 결과도 훨씬 좋아집니다.

product-marketing-context에 필요한 입력

쓸 만한 결과를 얻으려면 최소한 다음 정보는 제공하는 것이 좋습니다.

• 제품이 무엇인지
• 누구를 위한 제품인지
• 해결하는 핵심 문제가 무엇인지
• 대안과 비교해 무엇이 다른지
• 현재 가지고 있는 신뢰 근거나 제약이 무엇인지
• 이번 작업이 첫 초안인지, 기존 문서 업데이트인지

추가로 있으면 유용한 입력:

• 가격제 변경 사항
• 새 페르소나
• 수주/실주 패턴
• 통화 기록이나 리뷰에서 나온 고객 표현
• 브랜드 보이스 선호
• 세일즈 이의 제기
• 출시 목표 또는 분기 목표

이 스킬이 구성하려는 섹션

리포지토리의 eval과 워크플로를 보면, product-marketing-context usage 흐름은 보통 다음과 같은 섹션을 다루게 됩니다.

• Product Overview
• Target Audience
• Personas
• Problems You Solve
• Competitive Landscape
• Differentiation
• Objections
• Switching Dynamics
• Customer Language
• Brand Voice
• Proof Points
• Goals

이 구조가 중요한 이유는, 단순히 포지셔닝 문단 하나를 만드는 것이 아니라 오래 쓸 수 있는 컨텍스트 파일을 만들기 때문입니다.

막연한 요청을 강한 프롬프트로 바꾸는 법

약한 예:

Help me with product marketing.

더 나은 예:

Use the product-marketing-context skill. Check whether .agents/product-marketing-context.md already exists. If not, auto-draft a V1 from the repo and website copy. Capture product overview, ICP, personas, key pain points, differentiation, objections, proof points, customer language, and brand voice. Flag assumptions clearly so I can review them.

업데이트 작업에 가장 좋은 예:

Use the product-marketing-context skill to update our existing context. We added an enterprise tier and now sell to VP of Engineering in addition to Product Managers. Read .agents/product-marketing-context.md, tell me which sections need revision, then update only those sections and preserve everything still valid.

추측을 줄여 주는 실전 워크플로

실무에서는 다음 순서로 진행하면 좋습니다.

1. 기존 컨텍스트 파일이 있는지 확인한다.
2. 자동 초안으로 갈지, 가이드형 인터뷰로 갈지 결정한다.
3. 섹션별로 컨텍스트 파일을 작성하거나 업데이트한다.
4. 가정과 근거 부족 영역을 표시한다.
5. 사용자와 함께 검토하며 수정한다.
6. .agents/product-marketing-context.md에 저장한다.
7. 이후 마케팅 작업에서 이 파일을 재사용한다.

프로젝트 초기에 product-marketing-context install을 해두면 반복되는 설정 작업을 크게 줄일 수 있는 이유가 바로 여기에 있습니다.

먼저 읽어볼 리포지토리 파일

빠르게 평가하려면 다음 파일부터 보는 것이 좋습니다.

• skills/product-marketing-context/SKILL.md
• skills/product-marketing-context/evals/evals.json

SKILL.md에는 실제 운영 워크플로가 설명되어 있습니다. evals/evals.json은 특히 유용한데, 제품 변경 이후 업데이트 사례를 포함해 현실적인 프롬프트에서 “올바른 사용 방식”이 어떤 모습인지 보여주기 때문입니다.

결과 품질을 실질적으로 높이는 요소

좋은 결과는 희망사항이 아니라 근거에서 나옵니다. 더 강한 컨텍스트 문서를 원한다면, 스킬이 다음 자료를 보도록 해주세요.

• 홈페이지 또는 랜딩 페이지 카피
• 제품 문서와 온보딩 텍스트
• 데모 녹취 메모
• 가격 및 플랜 설명
• 고객 인터뷰 인용문
• 실제로 사용하는 경쟁사 비교 자료
• 세일즈 콜에서 나온 이의 제기
• 기존 브랜드 가이드라인

이런 자료가 없으면 초안이 아예 못 쓰는 수준은 아닐 수 있지만, 더 일반적인 가정이 많이 들어갈 가능성이 높습니다.

첫 초안에서 기대할 수 있는 것

product-marketing-context로 만든 V1은 최종본이 아니라 작업용 문서로 보는 것이 맞습니다. 가장 유용한 초안은 다음 특징을 갖습니다.

• 확인된 사실과 추론된 포지셔닝을 분리한다
• 신뢰 근거 부족이나 타깃 고객 정의의 공백을 드러낸다
• 이후 AI 마케팅 작업이 일관성을 유지할 수 있을 만큼 충분한 구조를 제공한다

전략 메시지까지 다듬어진 결과를 원한다면, 초기 파일 생성 후 최소 한 번의 검토 라운드는 예상하는 것이 좋습니다.

product-marketing-context 스킬 FAQ

product-marketing-context는 초보자에게도 괜찮나요?

네. 초보자에게도 비교적 친화적입니다. 워크플로가 명확하기 때문입니다. 기존 파일 확인, 자동 초안 또는 가이드형 설정 선택, 그리고 정해진 섹션 채우기 순서로 진행하면 됩니다. 정식 PMM 프레임워크를 잘 몰라도 실무에 쓸 수 있는 첫 버전을 만들 수 있습니다.

일반 프롬프트 대신 언제 product-marketing-context를 써야 하나요?

여러 작업에서 재사용할 컨텍스트가 필요할 때 쓰는 것이 좋습니다. 랜딩 페이지 헤드라인 하나만 필요하다면 일반 프롬프트로도 충분할 수 있습니다. 하지만 여러 산출물 전반에서 메시지 일관성을 유지하려는 목적이라면, product-marketing-context for Product Marketing이 훨씬 좋은 기반이 됩니다.

기존 컨텍스트를 다시 만들지 않고 업데이트만 할 수 있나요?

네. 그것이 핵심 동작 중 하나입니다. 이 스킬은 기존 .agents/product-marketing-context.md를 읽고, 이미 정리된 내용을 요약한 뒤, 새 정보의 영향을 받는 섹션만 수정하도록 설계되어 있습니다.

시장조사까지 대신해 주나요?

그 정도는 아닙니다. 리포지토리와 제품 자료를 바탕으로 많은 것을 추론할 수는 있지만, 고객 조사 자체를 대체하지는 못합니다. 근거가 약하면 결과물은 구조적으로는 도움이 되더라도 전략적으로는 얕아질 수 있습니다.

리포지토리에 마케팅 카피가 거의 없으면 어떻게 하나요?

처음부터 시작하는 경로를 택하고, 대화형으로 질문에 답하는 편이 좋습니다. 고객, 이의 제기, 구매 맥락에 대한 정보가 거의 드러나지 않는 빈약한 코드베이스에서 억지로 자동 초안을 만드는 것보다 이 방식이 더 낫습니다.

product-marketing-context는 이 리포지토리 생태계 안에서만 유용한가요?

.agents/product-marketing-context.md를 참조하는 다른 마케팅 스킬과 함께 쓸 때 가장 가치가 크지만, 파일 자체는 이식 가능합니다. 전체 스킬 생태계 밖에서도 표준 PMM 브리프로 사용할 수 있습니다.

어떤 경우에는 이 스킬이 별로인가요?

다음 경우라면 생략하는 편이 낫습니다.

• 단일한 카피 결과물 하나만 필요할 때
• 팀이 공유 컨텍스트 파일을 유지할 계획이 없을 때
• 제품 정의가 아직 너무 모호해서 기본적인 타깃 고객과 문제조차 답하기 어려울 때

product-marketing-context 스킬을 더 잘 활용하는 방법

목표만 말하지 말고 근거를 주세요

product-marketing-context skill 품질을 가장 크게 끌어올리는 요소는 더 나은 원본 자료입니다. “포지셔닝을 더 강하게 만들고 싶다”만으로는 부족합니다. 다음과 같은 원자료를 제공하세요.

• 홈페이지 텍스트
• 고객 통화 메모
• 세일즈에서 자주 나오는 이의 제기
• 고객이 갈아타는 이유
• 기능이 어떤 효익으로 이어지는지에 대한 설명
• 숫자로 뒷받침되는 신뢰 근거

이렇게 해야 모델이 근거에 기대어 주장할 수 있고, 없는 내용을 지어내지 않게 됩니다.

무엇이 바뀌었는지 명확히 말하세요

업데이트 작업에서는 실제로 두 가지만 바뀌었는데 문서 전체를 넓게 새로 손보라고 요청하지 마세요. 무엇이 새로워졌는지 정확히 적는 것이 좋습니다.

• 새로운 가격제 티어
• 확장된 ICP
• 변경된 카테고리 명칭
• 더 강해진 엔터프라이즈 집중도
• 새롭게 커진 경쟁 압박

이렇게 해야 아직 유효한 메시지를 약화시키지 않고, 필요한 섹션만 정확히 업데이트할 수 있습니다.

가정은 표시해 달라고 요청하세요

흔한 실패 패턴 중 하나는 숨은 추측입니다. 결과 품질을 높이려면 모델에게 다음 항목을 명시적으로 구분해 달라고 요청하세요.

• 확인된 사실
• 그럴듯한 추론
• 누락된 입력
• 검토가 필요한 질문

이렇게 하면 첫 초안을 승인하고 다듬기가 훨씬 쉬워집니다.

더 나은 최종 결과를 위해 섹션별로 검토하세요

문서 전체를 마지막에 한 번에 검토하지 마세요. 초기에 우선 검증할 가치가 큰 섹션은 다음과 같습니다.

• Target Audience
• Problems You Solve
• Differentiation
• Objections
• Proof Points

이 부분이 틀리면, 이후 이 파일을 기반으로 생성되는 다른 메시지도 함께 어긋나기 쉽습니다.

고객 언어 수집을 더 강하게 만드세요

자주 약해지는 지점은 지나치게 일반적인 표현입니다. 실무에서 product-marketing-context guide의 품질을 높이려면, 고객이 실제로 쓰는 표현을 다음 출처에서 넣어 주세요.

• 인터뷰
• 지원 티켓
• 리뷰 사이트
• 세일즈 콜
• 온보딩 피드백

실제 고객 언어는 이후 생성되는 카피의 적합도를 크게 높여 줍니다.

이런 흔한 실패 패턴을 주의하세요

대표적인 문제는 다음과 같습니다.

• 포지셔닝처럼 보이지만 사실은 기능 목록에 불과한 내용
• 지나치게 넓은 ICP
• 모호한 “경쟁사”를 상대로 한 약한 차별화
• 예시 없는 이상론적 브랜드 보이스
• 근거가 아니라 주장에 머무는 proof point

이런 문제가 보이면, 다시 쓰기를 요청하기 전에 먼저 입력 자료 자체를 보강하는 편이 더 낫습니다.

전체 재작성보다 후속 프롬프트를 정밀하게 쓰세요

첫 초안 이후에는 전체를 다시 쓰라고 하기보다, 다음처럼 초점을 좁힌 프롬프트를 사용하는 편이 훨씬 효과적입니다.

• “Narrow the ICP to the most likely first buyer.”
• “Rewrite objections based on enterprise procurement concerns.”
• “Separate direct competitors from status-quo alternatives.”
• “Turn proof points into evidence-backed bullets only.”

이처럼 타깃이 분명한 반복 작업이 문서를 훨씬 빠르게 개선합니다.

product-marketing-context를 살아 있는 파일로 유지하세요

product-marketing-context를 장기적으로 가장 잘 활용하는 방법은 한 번 설정해 두고 끝내는 것이 아니라 계속 관리하는 것입니다. 제품, 타깃 고객, 가격, 카테고리, 세일즈 모션이 바뀔 때마다 이 파일을 다시 점검하세요. 그래야 이후의 모든 마케팅 작업이 오래된 가정이 아니라 현재의 실제 상황에 맞춰 정렬됩니다.