테넌트 marketing.yaml How/What 분리 및 마케팅 멘션 페르소나 오버레이 패턴
멀티 테넌트 소프트웨어 팩토리에서 마케팅 멘션(mm) 에이전트를 운영할 때, **실행 절차(How)**와 **테넌트별 대상·제약(What/Where)**을 엄격히 분리한다. Tenant-Quality-Yaml-Gate-Skip-Pattern.md와 동일한 missing → skip 계약을 적용하여 설정이 없는 테넌트에서 노이즈나 실패 티켓을 만들지 않는다.
How / What 분리 계약
| 축 | 정본 위치 | 내용 | 비고 |
|---|---|---|---|
| How (절차/스킬) | deploy/personas/mm/ | topic-radar, comment-draft 스킬 및 운영 규칙 | 키워드·사이트 하드코딩 금지 |
| What / Where (설정) | $path/.factory/marketing.yaml | sites, keywords, tone, product_mention, must_avoid | 파일 누락 시 해당 테넌트 skip |
| 참고 힌트 | sites-guide.md (P0/P1/P2) | 채널 우선순위 추천 가이드 | 정본(SSoT) 아님; 실제 on/off는 제품 yaml sites만 제어 |
# $path/.factory/marketing.yaml 최소 골격 예
sites:
- reddit
- hackernews
keywords:
- "on-device llm"
tone: "technical, objective, non-promotional"
product_mention: "soft-mention only when directly solving the thread problem"
must_avoid:
- "benchmark hype"
- "unverified pricing claims"워크플로우 및 안전 가드레일
topic-radar: 공개 웹 검색으로sites·keywords매칭 스레드를 탐색하고, HTML 주석 마커<!-- mm-radar:... -->로 중복 수집을 방지(dedup)한다.comment-draft: 팩토리 내부 티켓에만 2–5문장 분량의 소프트 멘션(soft-mention) 초안을 작성한다.- 금지 사항 (Non-goals):
- 외부 사이트 자동 댓글·자동 포스트 게시 금지(사람 검토 후 수동 게시).
- 로그인이 필요한 크롤링·스크래퍼 구현 금지.
agents.yaml 배선 및 스케줄
- 예제 설정:
deploy/agents.yaml.example에mm세션·repo_ids와 주간 스케줄mm-topic-radar(0 4 * * 1UTC)를 등록한다. - 프로비저닝:
agents.yaml에mm이 정의되어 있으면./register-agent-users.sh및./seed-personas.sh실행 시 자동으로 포함된다. 운영 환경의user_id는 호스트 등록(register) 완료 후 기입한다. - 참고 문서:
deploy/docs/agent-workflows.md§8,deploy/docs/schedules.md§5.12.