Slack → GitHub 역방향 봇 설계

개요

슬랙에서 @봇이름 [요청]으로 멘션하면, AI가 요청을 해석해서 rogue-docs 레포에 문서 커밋/수정/미팅노트 생성 등을 수행하고 결과를 슬랙에 회신.

아키텍처

Slack 멘션 → Slack Event API (HTTP POST)
  → Vercel Function (API Route)
    → 스레드 컨텍스트 수집 (Slack API)
    → Claude 호출 (Anthropic 직접)
    → GitHub API로 커밋/수정
    → Slack에 결과 회신

핵심 결정

항목	선택	이유
런타임	Vercel Functions	서버리스, 관리 부담 없음
AI 모델	Anthropic 직접 (Claude)	Vercel 카드 미등록
GitHub 인증	PAT	간단, 팀 규모에 적합
코드 위치	4-프로젝트/기본 업무 환경 구축/slack-bot/	모노레포 정책
Slack 연동	Event API + app_mention	상시 프로세스 불필요

봇 액션 범위

1. 문서 커밋 — 스레드 논의를 정리해서 적절한 프로젝트 폴더에 커밋
2. 문서 수정 — 기존 문서 업데이트 요청 처리
3. 미팅노트 생성 — 논의 내용을 3-미팅/ 형식으로 생성
4. 자유 요청 — AI가 의도 파악해서 적절한 액션 매핑

필요한 환경변수

• SLACK_BOT_TOKEN — Slack Bot OAuth Token
• SLACK_SIGNING_SECRET — 요청 검증용
• ANTHROPIC_API_KEY — Claude API
• GITHUB_PAT — 레포 커밋용

비고

• 기존 GitHub → Slack (doc-notify.yml)과 독립적으로 운영
• Next.js API Route 기반, Vercel에 별도 프로젝트로 배포