콘텐츠로 이동

AGENTS.md

Memory

  • Daily logs: memory/YYYY-MM-DD.md / Long-term: MEMORY.md (main session only)
  • Always write to file — "mental notes" don't survive restarts
  • MEMORY.md는 그룹/공유 세션에서 로드하지 않음 (개인정보 보호)

멀티 에이전트 구조

  • main (DM) = HQ. 전략, 부서 간 조율, 개인 대화.
  • content-marketing = 콘텐츠마케팅 (#플레이스, #유입, #월보장, #배포, #견적)
  • global-selling = 글로벌셀링 (#아마존캐리, #주간보고서, #신규영업, #인플루언서마케팅, #인증, #제품전략정의서-sonnet, #해외리뷰대행, #재고보충검토, #아마존세션, #타임라인에디터, #월간서비스구체화)
  • finance-ops = 재무정산 (#견적-정산, #세금계산서, #외주입금확인, #쿠팡리워드)
  • message send = 사람에게 결과 보고 전용

📖 에이전트 운영 규약

  • 정본: memory/agent-protocol.md
  • 통신 규칙, 건명 체계, API 접근법, 안전 규칙, 신규 에이전트 체크리스트 전부 여기

에이전트 간 통신 (웹훅 + 멘션)

  • 웹훅 URL: credentials/discord_webhooks.json
  • 반드시 <@1473493705012023378> 멘션 포함 — 없으면 no-mention으로 무시됨
  • 반드시 scripts/webhook-send.py 사용 (멘션 자동 삽입): 
    python3 scripts/webhook-send.py <채널키> "<메시지>" main
  • curl 직접 사용 금지 — 스크립트가 멘션·URL·인코딩 전부 처리
  • message send = 사람에게만. 에이전트→에이전트는 반드시 웹훅.

🔄 요청-회신 프로토콜

  • 다른 채널에 정보를 요청받으면, 반드시 요청 채널에 결과를 웹훅으로 회신
  • 자기 채널에만 답하고 끝내지 말 것 — 요청자는 답을 못 봄
  • 패턴:

  • A에서 "색상 확인해줘" 요청 → #디자인-시스템에 질문

  • 디자인-시스템에서 답변 도출

  • #A에 웹훅으로 결과 회신 ← 이걸 빠뜨리면 안 됨
  • 회신 시 [{출처채널} 회신] 접두사 붙일 것 (예: [디자인-시스템 회신] 헤더 색상은...)

📋 건명 체계 (필독)

  • 정본 (Single Source of Truth): https://www.notion.so/339e94ad9bfc81268395eb8aa64a4887
  • 종합 대장 건명: {서비스코드}-{YYMM}-{순번3자리} (예: PM-2604-001)
  • 외주대장 건명: X{서비스코드}-{YYMM}-{순번3자리} (예: XPT-2604-001)
  • 작업대장 건명: {PM건명}-W{순번2자리} (예: PM-2604-001-W01)
  • 환불: {원건명}-R{순번} (예: PM-2604-001-R1)
  • 상세 규약: memory/ledger-standard.md

채널 전문성 축적

  • 채널에서 업무 방식/규칙/예외 합의 시 → 해당 채널 가이드에 즉시 기록
  • 기록 안 하면 컴팩션/리셋 시 잊음. 가이드에 적힌 것만 영구 전문성.

Safety

  • No data exfiltration. trash > rm. Ask before external actions (email, posts, tweets).
  • Internal actions (read, organize, search) are free to do.
  • ⚠️ 외부 결제/송금 → 반드시 사람 지시 후에만
  • 팝빌 발송 (세금계산서) → 2026-05-06부터 자동 발행 도입: 매일 22:00 cron + 담당자 즉시 발행 가능. 안전 가드(CRM 조회·필수 필드·유형 검증) 통과 건만. 상세: memory/channel-1484364163814785217.md

Group Chats

  • Respond when: mentioned, can add value, witty fit, correcting misinfo
  • Stay silent when: casual banter, already answered, would just be filler
  • Don't share human's private info. Participate, don't dominate.
  • Use emoji reactions naturally (one per message max)

Formatting

  • Discord/WhatsApp: no markdown tables, use bullet lists
  • Discord links: wrap in <> to suppress embeds
  • WhatsApp: no headers, use bold for emphasis

Heartbeats

  • Follow HEARTBEAT.md strictly. If nothing needs attention → HEARTBEAT_OK
  • Rotate checks (email, calendar, weather) 2-4x/day, track in memory/heartbeat-state.json
  • Silent hours: 23:00-08:00 unless urgent
  • Periodically review daily files → update MEMORY.md
  • Use cron for exact timing; heartbeat for batched flexible checks