hit-skill

name	hit-skill
version	1
description	히트 패턴 아키텍처 3층(인간메커니즘·자극설계·전파구조) 기반 범용 변환 엔진. 진단·설계·변환 3모드. 작업물을 통과시키면 히트패턴이 반영된 결과물로 탈바꿈. 트리거: 히트스킬, hit skill, 히트패턴, 히트분석, 자극설계, 인간메커니즘, 히트변환, 히트진단, 반응설계, 전파구조, 바이럴설계, 히트공식, 반응공식, 주목설계, 히트콘텐츠, 바이럴콘텐츠, 반응콘텐츠, 히트마케팅, 히트기획, 히트제품, 히트캠페인, 히트카피, 히트스킬 통과. NOT: 일반리서치(→research-skill), 재무모델(→financial-model), UI설계(→ui-designer), 순수 행동인과분석·예측(→human-skill), 카피생성(→copywriting-skill).

Hit Skill — 히트 패턴 아키텍처 변환 엔진

인간이 왜 반응하는지(L1), 무엇을 어떻게 던져야 하는지(L2), 왜 퍼지는지(L3)의 3층 프레임워크를 적용하여 작업물·고민·초안을 변환하는 실행 도구.

Skill Boundaries

• 하는 것 — 히트 패턴 아키텍처 3층(인간메커니즘·자극설계·전파구조) 기반 범용 변환 엔진.
• 안 하는 것 — 일반리서치(→research-skill), 재무모델(→financial-model), UI설계(→ui-designer), 순수 행동인과분석·예측(→human-skill), 카피생성(→copywriting-skill).

---

When to Use

• 사용자가 "히트스킬 통과", "히트 관점으로", "반응하게 만들어", "변환해줘", "진단해줘" 같은 표현으로 발동
• 콘텐츠·기획·제품이 반응을 못 얻을 때, 바이럴 설계가 필요할 때, 캠페인 히트 전략 수립시.
• 안 쓸 때 — 일반리서치(→research-skill), 재무모델(→financial-model), UI설계(→ui-designer), 순수 행동인과분석·예측(→human-skill), 카피생성(→copywriting-skill).

Prerequisites

#	체크	미충족 시
1	대상·입력 명확 (스킬 발동 의도 확인)	1줄 확인 후 진입
2	references/ 폴더 접근 가능	inline fallback
3	scripts/ 실행 권한	권한 보정 후 재시도

⛔ 절대 규칙

#	규칙
1	스포크 없이 기억으로 실행 금지 — 해당 공식/축의 상세가 필요하면 반드시 @uses 레퍼런스 로드
2	전제조건(V) 체크 생략 금지 — 6공식 적용 전 V1·V2·V3·V5 반드시 판정. 미충족 시 공식 무효
3	모드별 필수 스포크 최소셋만 로드 — §4 테이블의 "필수 스포크 최소셋" 참조. 비활성 축/공식의 스포크는 로드 금지

---

§1. 모드 자동 판별

입력 유형	모드	판별 기준
완성된 작업물	진단	문서·카피·기획서·제품 등 구체적 산출물이 존재
목표·고민만	설계	산출물 없이 "이걸 히트시키려면?" "어떻게 만들어야?"
초안 + 의도	변환	초안이 있고 "이걸 히트 관점에서 바꿔줘" 요청

애매한 경우: 형에게 "진단/설계/변환 중 어느 모드로 진행할까요?" 확인. 복합 시 진단→설계→변환 순서 파이프라인 가능.

---

§2. 1차 스크리닝 (3모드 공통)

입력물을 3층 프레임워크로 빠르게 스캔. 각 항목 = 1줄 판정. 전수 분석이 아님.

⚠️ 근거 인용 필수: 각 축/공식의 활성·비활성 판정 시, 입력물의 구체적 단어·구절·맥락을 직접 인용하여 근거를 제시하라. 일반론("이 도메인에서는 보통~")이나 인용 없는 판정 금지. 예: "'무료 체험 14일'이 축A(호혜)를 활성화 — 선행 호의 구조".

L3 우선 분기: 범용 도메인(정치·공공·교육·투자자설득 등 6대 도메인 밖)에서는 L3(전파구조)가 L2(자극설계)를 압도하는 경우가 빈번. 범용 도메인 진입 시 L3 5축을 먼저 스캔 → L3 축이 2개+ 강활성이면 L3→L2→L1 역순 파이프라인 허용. 이유: 정치 슬로건·공공 캠페인 등은 "어떻게 퍼지는가"가 "무엇을 던지는가"보다 성패를 결정하므로, 전파 구조를 먼저 확정한 뒤 자극을 그 구조에 맞게 설계하는 것이 효율적. 상세는 references/domain-universal.md §범용 도메인 L3 우선 스크리닝 참조.

→ 스캔 체크 테이블(L1 16축·L2 6공식·V 전제조건·L3 5축): references/screening-tables.md 로드

본 스캔은 빠르게 훑어 "활성/잠재/비활성" 1줄 판정만 확정하는 단계. 각 축·공식의 상세 정의·적용례는 로드되는 스포크(L1·L2·L3·rx-*)에서 다룬다.

---

§2.5. 도메인 어댑터 라우팅

Python 라우터 우선 (토큰 절약)

# 도메인+세부도메인 판별
python scripts/domain_router.py "게임" "VR"

# 6대 도메인+33세부도메인 목록
python scripts/domain_router.py --list

# 접경지대 14건 판별 기준
python scripts/domain_router.py --border

# 스크리닝 결과→로드할 스포크 매핑
python scripts/domain_router.py --spokes L1 공식① E전파

폴백 (Python 불가 시)

→ references/domain-routing.md 로드 (6대 도메인 판별 → 33개 세부도메인 → 어댑터 파라미터 세팅 → 하이브리드/트리플 판별 → E 전파 가속 → 스크리닝 재해석)

1차 스크리닝 직후 실행. 세팅된 어댑터 가중치가 §3~§5 전체를 좌우한다.

출력 필수 — 도메인 어댑터 판별 결과를 반드시 리포트에 기재하라:

• 도메인(6대 중 어디): [A~F]
• 세부도메인(33개 중 어디): [코드+이름]
• 킬러 공식: [어떤 공식이 이 도메인에서 킬러인지]
• V 등급: [V2·V5 등 도메인별 강조 V]
• 위치: 3층 데이터 접힘에 "도메인 어댑터" 항목으로 포함

---

§3. 상세 로딩 — 스포크 라우팅

⚠️ 동시 로드 상한: 한 턴에 rx-* 2개 + L1·L2·L3 각 1개 이내. 초과 필요 시 §2.5 Python 라우터로 분기 판별 후 재요청. 과부하 시 컨텍스트 오염·판단 지연 발생.

→ references/domain-routing.md §3 참조 (스크리닝 결과별 로드할 스포크 22건 매핑 테이블)

원칙: 필요한 스포크만 로드. 6개 처방카드를 한 번에 전부 로드하지 않는다. 세부도메인 어댑터도 해당 1개만 로드.

---

§4. 모드별 실행

3모드 공통 ⓪: 도메인·세부도메인 판별 + 어댑터 세팅 (§2.5)

3모드 공통 파이프라인 (§2→§2.5→§3→§4.5): ①1차 스크리닝(§2) → ②도메인 어댑터(§2.5) → ③필요 스포크만 로드(§3) → ④모드별 분석(아래) → ⑤리포트 변환(§4.5)

모드	④ 모드별 분석 (공통 파이프 ①~③ 이후)	필수 스포크 최소셋
진단	강점 Top 3 → 약점(킬러 우선) → 처방카드 → V 위반 경고 → L3 취약점	L1 활성축 스포크 + 킬러공식 rx + domain-routing
설계	목표·타겟 → L1 공략 2~3개 → L2 공식+V체크 → L3 전파+시대정신 → 프리모르템 → 액션	L1 공략축 스포크 + 선택 L2 rx + L3 해당축
변환	변환 포인트 → 처방카드 적용 → 리라이팅 → Before/After → V 체크	활성 rx만 (비활성 rx 로드 금지)

---

§4.5. 리포트 변환 (3모드 공통 후처리)

§4 분석 완료 후, 데이터 시트형 산출물을 그대로 출력하지 않는다. 아래 리포트 템플릿에 맞춰 재구성한다. 분석 엔진(§2~§4)은 "분석", 이 단계는 "표현" — 역할 분리.

변환 규칙

#	규칙	이유
1	§2~§4 실행 과정을 2층 본문에 노출하지 않는다 — 3층 데이터 접힘으로 이동. 변환 모드 특칙: "설계 원리", "변환 설명", "변환 이유(메커니즘)" 등 분석 해설 블록은 반드시 3층 접힘(> [!info]- 변환 설계 원리)에 배치. 2층의 "무엇이 왜 바뀌었는가" 서사에서 공식명·축명은 문장 끝 괄호 레이블만 허용. → references/report-template.md 변환 모드 템플릿을 정확히 따르라	과정 ≠ 산출물
2	본문은 3층 구조(1층 원페이저 → 2층 서사 해설 → 3층 데이터 접힘)	읽는 사람이 "그래서 뭘 해야 하는가"에 도달하는 최단 경로
3	2층 각 블록은 최소 3문장 서술형 — 표·리스트 단독 블록 금지	서사 강제. 표는 서술 뒤 보조로만

→ references/report-template.md 로드 (3층 구조 정의 + 2층 서사 규칙 + 모드별 차이 + .md 템플릿)

🚨 MUST cascade → paper-engine (절대규칙)

리포트 산출 = paper-engine 허브 MUST 경유. 이 스킬 단독 md/html 출력 = FAIL.

• 진입점: §4.5(또는 §3.5/§Phase 6) 리포트 변환 직후 paper-engine 발동
• paper-engine이 결정: MODE_S/M/L · NYT구조 · 3패스삭제 · 4항밀도QC · design-skill cascade
• 산출 포맷: 기본 순수 md (div·style ✗). 사용자가 "HTML로·박스로·벤토로·시각화·카드로" 명시시에만 예외
• 위반 감지: md 파일에 <div style>·<span style> 삽입 = FAIL → 재작성

---

§5~§7. 프리모르템 + 시너지맵 + 정량모델 + Gotchas

→ references/execution-guide.md 로드 (프리모르템 체크리스트 + 공식 시너지맵 5건 + 정량 모델 계산기 + 16건 안티패턴)

생략 불가 핵심:

• §5 프리모르템: 3모드 공통 종료 단계. V1~V5 위반 가능성 + 치명 리스크 Top 3 + 하이브리드 추가 검증
• §6 시너지맵: ①+③, ③+④, ②+⑥, ④+⑤, ①+② 5대 조합
• §7 정량모델: scripts/quant_models.py 우선 사용 (LLM 인라인 계산 ✗)

---

§INV NO_WORK_LABEL (산출물·대화 본질 보호)

항목	정의
RULE	산출물·대화 = 인간 언어. 작업 라벨 ZERO. (1만 페이지 1단어 = FAIL)
판정	"이 단어, 이 대화 밖 사람이 사전 없이 읽을 수 있나?" NO → 작업 라벨 → 금지
ALLOW	업계 전문용어(CTR·CTA·UX·NPS·바이럴) · 고유명사(밈·브랜드 사례) · 법조문
CONVERT	라벨 발견 → 실명·평문 풀어쓰기. 예) "3층 아키텍처(인간메커니즘·자극설계·전파구조)·진단·설계·변환 3모드" → 결과만 노출(층 라벨 ✗·내용만)
SELF_CHECK	진단·설계·변환 결과물 출력 직전에서 자체 스캔. 1개라도 발견 = 차단·재작성. paper-engine cascade 경유 시 INV 13 자동 적용

---

Output Path

산출물	경로
주 산출물	mnt/outputs/hit-skill_{topic}_{YYYY-MM-DD}.md
형식	진단결과로, 설계안으로, 변환결과로, .md로.
리서치 결과 (해당 시)	{VAULT}/_skills research/hit-skill/{YYYY-MM-DD}_{topic}.md

Reference Index

파일	내용	언제
references/cross-domain-matrix.md	cross domain matrix	해당 단계 진입 시
references/domain-routing.md	domain routing	해당 단계 진입 시
references/domain-universal.md	domain universal	해당 단계 진입 시
references/e-propagation-model.md	e propagation model	해당 단계 진입 시
references/execution-guide.md	execution guide	해당 단계 진입 시
references/fandom-acceleration.md	fandom acceleration	해당 단계 진입 시
references/irr-calibration.md	irr calibration	해당 단계 진입 시
references/l2l3-delay-model.md	l2l3 delay model	해당 단계 진입 시
references/layer1-mechanism.md	layer1 mechanism	해당 단계 진입 시
references/layer2-formulas.md	layer2 formulas	해당 단계 진입 시
references/layer3-propagation.md	layer3 propagation	해당 단계 진입 시
references/multi-channel-propagation.md	multi channel propagation	해당 단계 진입 시
references/post-doctor-notes.md	post doctor notes	해당 단계 진입 시
references/report-template.md	report template	해당 단계 진입 시
references/rx-absence.md	rx absence	해당 단계 진입 시

Next Phase

본 스킬 작업 후 자연스럽게 이어지는 흐름:

• 후속 작업 → research-skill
• 후속 작업 → financial-model
• 후속 작업 → ui-designer
• 후속 작업 → human-skill
• 후속 작업 → copywriting-skill

Failure Modes (Gotchas) (허브 요약)

함정	원인 → 결과
V 체크 없이 공식 적용	전제조건 미충족 공식 = 오발동 → 반대 효과·정체성 침범
6공식 전부 적용	과부하·메시지 희석 → 수용자 판단 마비(V3 위반)
스포크 전체 로드	컨텍스트 오염·토큰 폭식 → 핵심 스포크 신호 약화

→ 상세 16건 안티패턴: references/execution-guide.md

❌ WRONG vs ✅ CORRECT

❌ WRONG: 트리거 단어만 보고 발동 — 본질·범위 확인 ✗ → 오발동·범위 이탈
✅ CORRECT: Skill Boundaries·When to Use 확인 후 발동 → 본질 작업만 수행