vibe-mod — 수상가능성 최적화 통합 계획

1. Executive Summary

1.1 한 줄 정의 (Doumont locked)

"Write a moderation rule. In English. It works."

1.2 한 문장 정의 (judge-facing)

For head-mods who know what rule they want but won't write YAML, vibe-mod turns plain-English moderation intent into a live, reversible rule in under a minute — without an LLM in the hot path.

1.3 수상 확률 추정

1.4 메인 metric (Drucker locked)

Time from typed sentence to active rule. Target: under 60 seconds. 데모에서 스톱워치 표시.

1.5 절대 변경 불가 (4 expert hard locks)

1. LLM은 build-time only — 룰 evaluate 시 0 LLM 호출. Devvit 트리거에서 결정론 평가.
2. Action whitelist 하드코딩: report/flair/remove/lock/modqueue만 LLM-permitted. ban/permaban/mute는 명시적 2단계 확인.
3. Dry-run preview 강제: Activate 전 last-24h 시뮬레이션 필수.
4. Shadow mode default ON: 24시간 강제. 그 후 promote.
5. 30-day rollback: 모든 액션 1-click undo.
6. LLM은 Reddit 콘텐츠를 보지 않음: 모드의 자연어만 처리. compliance 핵심.
7. v0.1은 영어만. KR/JP는 v0.2.

2. Positioning & Pitch (Business Panel 합의)

2.1 경쟁 매트릭스

2.2 Christensen Jobs-to-be-Done

핵심 JTBD: "문제 발견한 오후에 룰을 ship하고, 틀리면 undo한다" — 이건 non-consumption. 모드들은 AutoMod vs ContextMod 선택이 아니라 "YAML 쓸까 / 안 쓸까"에서 80%가 "안 씀"을 선택. 그게 우리 시장.

2.3 Porter 차별화 전략

Focused differentiator — time-to-first-rule axis for non-technical mods. 기술적 moat는 4일 안에 불가능. 대신:

• Rule library effect: 매 룰이 shareable template (v0.1.1+ 가능성 시그널, v1에서 starter pack 5개 큐레이션)
• Trust artifacts: audit log + rollback — AutoMod에도 없는 wedge
• Distribution inside the jury: 모더레이터 패널이 심사위원 → 사전 5+ 실제 sub 설치 = jury pool에 installed base

2.4 Godin Remarkability

"Rollback is the demo, not creation." 모드가 자신이 방금 만든 룰을 자신있게 1초 만에 삭제하는 장면이 입소문의 hero shot.

2.5 Voice & Visual Locked

• Voice: Stripe-clean + Linear-direct. 짧은 문장. 동사 > 명사. "powerful"·"seamless"·"AI-powered" 금지.
• Visual palette: Reddit 다크 네이티브 (#0B1416 bg, #46D160 accent for live state, #0079D3 CTA)
• BIG NO: "AI-powered" 헤드라인 금지 (Doumont). 1,227 entries 모두 AI 헤드라인이라 noise. outcome으로 lead.

2.6 Top 3 메시징 리스크

1. "AI"로 헤드 리드 → 모든 entry가 그렇게 함. "10초 안에 live 룰"로 리드.
2. AutoMod 부속물처럼 보임 → 새 카테고리 "moderation rules at the speed of conversation"로 프레이밍.
3. 대시보드 과잉 설명 → README 2-door split: "I'm a moderator" / "I'm a developer". 같은 제품, 두 입구.

3. 기술 아키텍처 (System Architect 합의)

3.1 Component Diagram

3.2 Devvit Primitives (실제 검증된 API)

3.3 LLM 선택: Claude Haiku 4.5 (Opus 아님)

• 비용: 800 in + 400 out ≈ $0.0028/edit (Opus 25× 비쌈, 불필요)
• 모드 100 컴파일 × 1000 sub = $280 (운영자 부담 OK)
• Cost containment: per-install 50 compiles/day Redis 카운터 → 초과 시 BYOK 안내
• Anthropic prompt caching으로 시스템 프롬프트 cache hit

3.4 Rule Schema (자체 DSL, AutoMod YAML importer 곁들임)

{
  "schemaVersion": "1.0.0",
  "rules": [{
    "id": "r_new_account_fast_post",
    "sourceNL": "If a new account (<24h) posts within 3 hours of joining...",
    "on": ["PostSubmit"],
    "when": {
      "all": [
        {"fact": "author.accountAgeHours", "op": "lt", "value": 24},
        {"fact": "author.subJoinAgeHours", "op": "lt", "value": 3}
      ]
    },
    "then": [
      {"action": "modqueue", "params": {"note": "new-account-fast-post"}}
    ],
    "rollbackable": true,
    "enabled": true
  }]
}

3.5 성능 예산

4. UX & Rule Bar 디자인 (Frontend Architect 합의)

4.1 First-install 6-screen journey

1. App Directory listing — Hero "Write a rule. It works. Undo anytime." + 3 screenshots + permissions preview (collapsed)
2. Scope consent — 한 줄씩 평이한 설명 ("modmail은 default OFF" 명시)
3. Zero state — 5개 클릭 가능한 예제 룰 ("blank page" 문제 해소)
4. Rule Bar 첫 사용 — 200ms 타입라이터로 예제 prefill, parse chip 등장
5. Activation moment — Shadow mode 사전선택, "Activate live"는 tertiary 처리
6. First action triggered — Recognition. "Oh, it just worked." 모드의 reaction이 디자인 타깃

4.2 Rule Bar (핵심 화면) 레이아웃

4.3 Killer micro-interactions

• Typing → 250ms debounce → parse. 2px progress bar (no spinner — spinner says "I'm working", progress bar says "you can see").
• Ghost-text suggestions: "new accounts" → 인라인으로 (under 7 days old?) Tab 수락. Dropdown 금지 (flow 죽임).
• Dry-run modal: "47 posts would have fired. Tap any to see why" + footer 3 버튼: "47 looks right" / "Too aggressive — refine rule" / "Cancel". "Too aggressive"는 모달 닫지 않고 cursor를 Rule Bar 끝에 두기 — refinement는 conversation.
• Conflict resolution: 활성화 시점에만 경고. Approve always wins (false negative recoverable, false positive trust 파괴).
• Activate split button: 메인 탭 → shadow, caret → "Activate live" / "Schedule (soon)".
• Success state: confetti·체크마크 금지. 보상은 룰이 거기 존재하는 것. border flash green 300ms + toast "Rule active. Watching r/{sub}." 끝.

4.4 Action Log + Rollback

• [Undo] 버튼은 모든 row에 항상 visible — 메뉴 뒤 숨김 금지. 신뢰 빠르게 빌드.
• Undo에 confirmation 없음 — 안전 방향 액션은 double-check 안 함. 대신 4초 toast "Restored. [Undo undo]"로 reverse 가능.
• 30-day window 명시 — 25일째 amber dot. 30일째 "window closed" 표시 (숨기지 말고 boundary를 보여줘야 신뢰).
• "Why?" 인라인 확장 — modal 대신 row 안에서 펼침. 조건별 매치 값을 표로 → "No black boxes" trust 빌드.

4.5 The opinionated calls

1. No dashboard. No overview. 룰은 룰 옆에, 액션은 액션 옆에. Aggregation = 발명된 metric.
2. No team features. Reddit mod permissions를 상속만.
3. Shadow mode 24h hard-coded. configurable은 v3.
4. 영어만 launch.
5. 데모 비디오 BGM 없음 ← 가장 contrarian 결정. 다른 entries는 synthwave/lofi 깔 것. 침묵 + 깔끔한 voiceover가 더 confident하게 들림.

5. 60초 데모 storyboard

6. 17일 실행 일정 (오늘 2026-05-11 → 마감 2026-05-27 18:00 PT)

6.1 Week 1: Foundation + Architecture (5/11~5/17)

6.2 Week 2: Polish + Demo + Submission (5/18~5/27)

7. 리스크 매트릭스 (Metis pre-mortem 합의)

8. Day-0 Critical Actions (오늘 진행 권장)

8.1 검증 스크립트 (오늘 1-2시간)

# 1. Devvit CLI 설치 + 신규 throwaway 앱
npm install -g @devvit/cli
devvit login
devvit new vibemod-fetch-test --template blocks-typescript

cd vibemod-fetch-test

# 2. devvit.yaml에 http allowlist
# (또는 main.ts의 Devvit.configure 안에)
# Devvit.configure({
#   http: { domains: ['api.anthropic.com'] },
#   redis: true,
#   redditAPI: true
# })

# 3. menu action에 fetch 테스트 추가
# Devvit.addMenuItem({
#   location: 'subreddit',
#   label: 'Test Anthropic fetch',
#   onPress: async (_, context) => {
#     try {
#       const r = await fetch('https://api.anthropic.com/v1/messages', {
#         method: 'POST',
#         headers: {
#           'x-api-key': '<test-key>',
#           'anthropic-version': '2023-06-01',
#           'content-type': 'application/json',
#         },
#         body: JSON.stringify({
#           model: 'claude-haiku-4-5-20251001',
#           max_tokens: 100,
#           messages: [{role: 'user', content: 'hello'}]
#         })
#       });
#       const data = await r.json();
#       context.ui.showToast({text: `HTTP ${r.status}: ${JSON.stringify(data).slice(0,80)}`});
#     } catch (e) {
#       context.ui.showToast({text: `FAIL: ${e.message}`});
#     }
#   }
# });

# 4. upload + install on test sub
devvit upload
devvit install r/your_test_sub

8.2 결과 분기

8.3 병행 액션 (대기 시간 활용)

• 200-member 미만 데모용 sub 생성 (오늘) — invite only, 팀 계정 5명만
• Anthropic API 키 발급 + 일일 $5 ceiling 설정
• vibe-mod GitHub repo 생성 (private → 마감 후 public)
• 5 실제 모드 후보 명단 작성 + Tier A 6 작자에게 written permission 요청은 일단 보류 (Reddit Mod Tools은 New 트랙이므로 불필요)

9. 제출 패키지 체크리스트

9.1 Devpost 제출 양식 (필수)

• ☐ App listing 링크: developers.reddit.com/apps/vibe-mod
• ☐ 참가자 Reddit username 전원
• ☐ Tool overview: 기능 설명 (Stripe-clean voice, Doumont's 3-clause sentence 포함)
• ☐ Project impact: 1-3 communities (예: r/{partner-sub-1}, r/{partner-sub-2}, r/{partner-sub-3}) + 측정 가능한 시간 절감
• ☐ 200-member 미만 sub 데모 포스트 (심사 기간 끝까지 free access)
• ☐ 1분 이하 데모 비디오 (YouTube/Vimeo 공개 호스팅)

9.2 Optional but recommended

• ☐ 공개 GitHub repo (MIT 라이선스, OSS 신호)
• ☐ 5+ 실제 모드 sub에 install 증거 (Moderator's Choice 영향력)
• ☐ Developer satisfaction survey

9.3 README 2-door split

vibe-mod
========

Write a moderation rule. In English. It works.

I'm a moderator → [→ install + 5 example rules + 60s video]
I'm a developer → [→ architecture, schema, opt-in BYOK]

9.4 마감 임박 timing

• 2026-05-27 09:00 PT (KST 27 01:00): 최종 빌드 freeze. 모든 metadata 더블체크.
• 2026-05-27 10:00 PT (KST 27 02:00): 제출 (8시간 buffer).
• 2026-05-27 18:00 PT (KST 28 10:00): 마감.

10. 전문가 보고서 원문 (참고)

이 통합 계획은 4명 전문가 에이전트의 병렬 출력을 종합한 것입니다. 각 에이전트의 원본 분석은 다음과 같습니다:

• Metis Pre-Analysis: 7 hidden requirements, 7 AI failure patterns, 6 Devvit policy landmines, 5 demo failure modes, 6 competitive blindspots, 3-scenario pre-mortem
• Business Panel (Christensen+Godin+Porter+Doumont+Drucker): JTBD, remarkability, competitive position, message clarity, customer definition + synthesis
• System Architect: 9-component diagram, Devvit API surface (verified), Claude Haiku 4.5 rationale, custom DSL schema, performance bounds, 4-day MVP cut, 10 risks ranked
• Frontend Architect: 6-screen install journey, Rule Bar detailed UX, Action Log + Rollback patterns, 5-cut 60s storyboard, voice + visual system, WCAG 2.2 AA validation, 5 opinionated calls

관련 자료

• 26-card Gallery (PreviewDD 결과)
• 소유권 규정 심층 분석 (이전 보고서)
• Reddit Mod Tools and Migrated Apps Hackathon — Devpost
• 공식 Rules
• Devvit GitHub

Generated by 4 expert agents (Metis · Business Panel · System Architect · Frontend Architect) + synthesis · 2026-05-11 KST