테넌트 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.yamlsites, 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"

워크플로우 및 안전 가드레일

  1. topic-radar: 공개 웹 검색으로 sites·keywords 매칭 스레드를 탐색하고, HTML 주석 마커 <!-- mm-radar:... -->로 중복 수집을 방지(dedup)한다.
  2. comment-draft: 팩토리 내부 티켓에만 2–5문장 분량의 소프트 멘션(soft-mention) 초안을 작성한다.
  3. 금지 사항 (Non-goals):
    • 외부 사이트 자동 댓글·자동 포스트 게시 금지(사람 검토 후 수동 게시).
    • 로그인이 필요한 크롤링·스크래퍼 구현 금지.

agents.yaml 배선 및 스케줄

  • 예제 설정: deploy/agents.yaml.example에 mm 세션·repo_ids와 주간 스케줄 mm-topic-radar (0 4 * * 1 UTC)를 등록한다.
  • 프로비저닝: 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.

🔗 관련 문서