mrstack 1.1.0__py3-none-any.whl

mrstack/__init__.py

@@ -0,0 +1,4 @@
+"""Mr.Stack — Proactive AI Butler for Claude Code."""
+
+__version__ = "1.1.0"
+__app_name__ = "Mr.Stack"

mrstack/_data/config/com.mrstack.claude-telegram.plist

@@ -0,0 +1,25 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>Label</key>
+    <string>com.mrstack.claude-telegram</string>
+    <key>ProgramArguments</key>
+    <array>
+        <string>/bin/bash</string>
+        <string>$HOME/claude-telegram/start-daemon.sh</string>
+    </array>
+    <key>RunAtLoad</key>
+    <true/>
+    <key>KeepAlive</key>
+    <true/>
+    <key>ThrottleInterval</key>
+    <integer>30</integer>
+    <key>StandardOutPath</key>
+    <string>$HOME/claude-telegram/logs/daemon-stdout.log</string>
+    <key>StandardErrorPath</key>
+    <string>$HOME/claude-telegram/logs/daemon-stderr.log</string>
+    <key>WorkingDirectory</key>
+    <string>$HOME/claude-telegram</string>
+</dict>
+</plist>

mrstack/_data/config/mcp-config.example.json

@@ -0,0 +1,23 @@
+{
+  "mcpServers": {
+    "google-calendar": {
+      "type": "http",
+      "url": "https://gcal.mcp.claude.com/mcp"
+    },
+    "notion": {
+      "command": "npx",
+      "args": ["-y", "@notionhq/notion-mcp-server"],
+      "env": {
+        "OPENAPI_MCP_HEADERS": "{\"Authorization\": \"Bearer YOUR_NOTION_API_KEY\", \"Notion-Version\": \"2022-06-28\"}"
+      }
+    },
+    "playwright": {
+      "command": "npx",
+      "args": ["-y", "@playwright/mcp"]
+    },
+    "applescript": {
+      "command": "npx",
+      "args": ["-y", "@peakmojo/applescript-mcp"]
+    }
+  }
+}

mrstack/_data/config/start-daemon.sh

@@ -0,0 +1,53 @@
+#!/bin/bash
+# Daemon startup script for launchd (foreground execution)
+# Use start.sh for manual/tmux execution instead
+
+cd "$HOME/claude-telegram"
+
+# Load environment variables
+set -a
+source .env
+set +a
+
+# Ensure claude CLI and other tools are in PATH
+export PATH="$HOME/.local/bin:/opt/homebrew/bin:/usr/local/bin:$PATH"
+
+# Sleep prevention: only on AC power
+# Bot always runs; caffeinate runs alongside only when on AC.
+# A background loop checks power state every 60s and toggles caffeinate.
+
+CAFF_PID=""
+
+cleanup() {
+    [ -n "$CAFF_PID" ] && kill "$CAFF_PID" 2>/dev/null
+    kill "$BOT_PID" 2>/dev/null
+    wait
+    exit 0
+}
+trap cleanup SIGTERM SIGINT
+
+is_on_ac() {
+    pmset -g batt | grep -q "AC Power"
+}
+
+# Start the bot in background
+claude-telegram-bot &
+BOT_PID=$!
+
+# Power monitor loop
+while kill -0 "$BOT_PID" 2>/dev/null; do
+    if is_on_ac; then
+        if [ -z "$CAFF_PID" ] || ! kill -0 "$CAFF_PID" 2>/dev/null; then
+            caffeinate -s -i -w "$BOT_PID" &
+            CAFF_PID=$!
+        fi
+    else
+        if [ -n "$CAFF_PID" ] && kill -0 "$CAFF_PID" 2>/dev/null; then
+            kill "$CAFF_PID" 2>/dev/null
+            CAFF_PID=""
+        fi
+    fi
+    sleep 60
+done
+
+wait "$BOT_PID"

mrstack/_data/config/start.sh

@@ -0,0 +1,29 @@
+#!/bin/bash
+cd "$HOME/claude-telegram"
+
+# Load env for webhook secret
+set -a
+source .env
+set +a
+
+export PATH="$HOME/.local/bin:$PATH"
+
+# Start bot in background, wait for health check, then notify
+claude-telegram-bot &
+BOT_PID=$!
+
+# Wait for API server to be ready (max 30 seconds)
+for i in $(seq 1 30); do
+  if curl -s http://localhost:8080/health >/dev/null 2>&1; then
+    # Send startup notification via webhook
+    curl -s -X POST http://localhost:8080/webhooks/system \
+      -H "Authorization: Bearer $WEBHOOK_API_SECRET" \
+      -H "Content-Type: application/json" \
+      -d '{"event": "bot_started", "message": "Bot online and ready."}' >/dev/null 2>&1
+    break
+  fi
+  sleep 1
+done
+
+# Wait for bot process
+wait $BOT_PID

mrstack/_data/schedulers/manage-jobs.sh

@@ -0,0 +1,87 @@
+#!/bin/bash
+# Manage scheduled jobs in the bot's SQLite database
+DB="$HOME/claude-telegram/data/bot.db"
+
+usage() {
+  echo "Usage: $0 {list|add|remove|toggle|update-cron}"
+  echo ""
+  echo "  list                          List all registered jobs"
+  echo "  add <name> <cron> <prompt>    Add a new job"
+  echo "  remove <job-name>             Remove a job by name"
+  echo "  toggle <job-name>             Toggle job active/inactive"
+  echo "  update-cron <job-name> <cron> Update a job's cron expression"
+  echo ""
+  echo "Note: Restart bot after changes for scheduler to reload."
+}
+
+case "${1:-}" in
+  list)
+    echo "=== Scheduled Jobs ==="
+    sqlite3 -header -column "$DB" \
+      "SELECT job_name, cron_expression, is_active,
+              substr(prompt, 1, 50) || '...' as prompt_preview
+       FROM scheduled_jobs
+       ORDER BY job_name"
+    echo ""
+    echo "Total: $(sqlite3 "$DB" "SELECT COUNT(*) FROM scheduled_jobs") jobs"
+    echo "Active: $(sqlite3 "$DB" "SELECT COUNT(*) FROM scheduled_jobs WHERE is_active=1") jobs"
+    ;;
+
+  add)
+    if [ $# -lt 4 ]; then
+      echo "Usage: $0 add <name> <cron> <prompt>"
+      exit 1
+    fi
+    JOB_NAME="$2"
+    CRON="$3"
+    PROMPT="$4"
+    JOB_ID=$(python3 -c "import uuid; print(uuid.uuid4())")
+    NOW=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+
+    sqlite3 "$DB" "INSERT INTO scheduled_jobs
+      (job_id, job_name, cron_expression, prompt, target_chat_ids, working_directory, is_active, created_at, updated_at)
+      VALUES ('$JOB_ID', '$JOB_NAME', '$CRON', '$PROMPT', 'YOUR_CHAT_ID', '$HOME', 1, '$NOW', '$NOW')"
+    echo "Created: $JOB_NAME ($CRON) -> $JOB_ID"
+    echo "Restart bot to apply."
+    ;;
+
+  remove)
+    if [ $# -lt 2 ]; then
+      echo "Usage: $0 remove <job-name>"
+      exit 1
+    fi
+    JOB_NAME="$2"
+    sqlite3 "$DB" "DELETE FROM scheduled_jobs WHERE job_name='$JOB_NAME'"
+    echo "Removed: $JOB_NAME"
+    echo "Restart bot to apply."
+    ;;
+
+  toggle)
+    if [ $# -lt 2 ]; then
+      echo "Usage: $0 toggle <job-name>"
+      exit 1
+    fi
+    JOB_NAME="$2"
+    sqlite3 "$DB" "UPDATE scheduled_jobs SET is_active = NOT is_active WHERE job_name='$JOB_NAME'"
+    STATUS=$(sqlite3 "$DB" "SELECT CASE WHEN is_active THEN 'ACTIVE' ELSE 'INACTIVE' END FROM scheduled_jobs WHERE job_name='$JOB_NAME'")
+    echo "$JOB_NAME -> $STATUS"
+    echo "Restart bot to apply."
+    ;;
+
+  update-cron)
+    if [ $# -lt 3 ]; then
+      echo "Usage: $0 update-cron <job-name> <new-cron>"
+      exit 1
+    fi
+    JOB_NAME="$2"
+    NEW_CRON="$3"
+    sqlite3 "$DB" "UPDATE scheduled_jobs SET cron_expression='$NEW_CRON' WHERE job_name='$JOB_NAME'"
+    echo "$JOB_NAME cron -> $NEW_CRON"
+    echo "Restart bot to apply."
+    ;;
+
+  *)
+    usage
+    exit 1
+    ;;
+esac

mrstack/_data/schedulers/morning-briefing.sh

@@ -0,0 +1,29 @@
+#!/bin/bash
+export PATH="$HOME/.local/bin:/opt/homebrew/bin:$PATH"
+
+set -a
+source "$HOME/claude-telegram/.env"
+set +a
+
+# Use Claude Code to generate briefing
+CLAUDECODE= claude --print --output-format text "
+You are DD's personal assistant. Generate a morning briefing.
+Check:
+1. Today's calendar events (if Google Calendar MCP available)
+2. Unread important emails (if Gmail MCP available)
+3. Pending issues/tasks (if Linear/Jira MCP available)
+4. Unread Slack mentions (if Slack MCP available)
+5. Latest AI news from ~/claude-telegram/scrapers/threads/output/
+
+Format as a concise Telegram message in Korean.
+Start with: 🌅 오전 브리핑 (date)
+" 2>/dev/null > /tmp/morning-briefing.txt
+
+# Send via Telegram
+MSG=$(cat /tmp/morning-briefing.txt)
+if [ -n "$MSG" ]; then
+  curl -s -X POST "https://api.telegram.org/bot${TELEGRAM_BOT_TOKEN}/sendMessage" \
+    -H "Content-Type: application/json" \
+    -d "{\"chat_id\":\"${NOTIFICATION_CHAT_IDS}\",\"text\":$(echo "$MSG" | python3 -c 'import sys,json; print(json.dumps(sys.stdin.read()))')}" \
+    > /dev/null
+fi

mrstack/_data/schedulers/register-jobs.py

@@ -0,0 +1,182 @@
+#!/usr/bin/env python3
+"""Register scheduled jobs into the bot's SQLite database."""
+
+import sqlite3
+import uuid
+from datetime import datetime
+
+import os
+
+DB_PATH = os.path.expanduser("~/claude-telegram/data/bot.db")
+CHAT_ID = os.environ.get("NOTIFICATION_CHAT_IDS", "YOUR_CHAT_ID")
+WORKING_DIR = os.path.expanduser("~")
+
+# Model routing:
+#   "sonnet" — simple lookups, status checks, no creative work
+#   "opus"   — complex analysis, writing, multi-step reasoning
+#   None     — inherit CLI default (opus)
+
+JOBS = [
+    {
+        "job_name": "morning-briefing",
+        "cron_expression": "0 8 * * 1-5",
+        "model": "sonnet",
+        "prompt": """아침 브리핑:
+1. 오늘 날짜/요일
+2. Google Calendar MCP로 오늘 일정
+3. ~/claude-telegram/memory/ 어제 daily 요약 + pending
+4. ~/claude-telegram/scrapers/threads/output/ 최신 AI 뉴스 (1파일)
+5. 오늘 할 일 제안
+
+~/claude-telegram/templates/morning-briefing.md 템플릿 참고.""",
+    },
+    {
+        "job_name": "evening-summary",
+        "cron_expression": "0 21 * * *",
+        "model": "opus",
+        "prompt": """일일 요약 작성 + 저장:
+1. 오늘 대화 핵심 정리
+2. 결정사항, 완료 작업, 새 정보
+3. 내일 할 일
+4. ~/claude-telegram/memory/daily/YYYY-MM-DD.md 저장
+5. decisions/log.md 업데이트 (있으면)
+6. projects/ 해당 파일 업데이트 (있으면)
+7. [Coach] ~/claude-telegram/memory/patterns/interactions.jsonl 분석:
+   - 총 요청 수, 유형 분포, 피크 시간대
+   - 디버깅 비율 지적, 컨텍스트 전환 패턴
+   - 코칭 포인트 2-3개 (interactions.jsonl 없으면 건너뛰기)
+
+파일 저장 후 텔레그램으로 요약 전송. ~/claude-telegram/templates/morning-briefing.md 형식 참고.""",
+    },
+    {
+        "job_name": "weekly-review",
+        "cron_expression": "0 18 * * 5",
+        "model": "opus",
+        "prompt": """주간 회고:
+1. ~/claude-telegram/memory/daily/ 이번 주 파일들
+2. 성과 요약
+3. 주요 결정사항 + 이유
+4. 배운 것 / 개선점
+5. 다음 주 계획
+
+~/claude-telegram/templates/weekly-review.md 템플릿 참고.""",
+    },
+    {
+        "job_name": "calendar-check",
+        "cron_expression": "0 9,12,15,18 * * 1-5",
+        "model": "haiku",
+        "prompt": """Google Calendar MCP로 3시간 내 일정 확인.
+있으면: 시간, 제목, 장소, 준비사항.
+없으면 빈 응답.""",
+    },
+    {
+        "job_name": "threads-notify",
+        "cron_expression": "30 8,20 * * *",
+        "model": "sonnet",
+        "prompt": """~/claude-telegram/scrapers/threads/output/ 최신 JSON 분석:
+1. 최근 1파일의 AI/테크 포스트 요약 (최대 5개)
+2. 포스트별: 주제, 핵심 1-2줄, 링크
+3. 트렌드 한줄 요약
+4. Notion MCP → "AI 업무 로그" DB(data_source_id: 14e322c2-110e-4cce-9a22-f2c529abb54e) 저장:
+   제목: "[Threads] YYYY-MM-DD 오전/오후 AI 뉴스", 카테고리: "학습"
+   (Notion 불가시 건너뛰기)
+
+새 파일 없거나 이미 브리핑한 파일이면 빈 응답.""",
+    },
+    {
+        "job_name": "memory-sync",
+        "cron_expression": "0 */3 * * *",
+        "model": "sonnet",
+        "prompt": """메모리 동기화 — 최근 대화에서 추출:
+- 새 사람 → ~/claude-telegram/memory/people/{name}.md
+- 프로젝트 → projects/{name}.md
+- 선호도 → preferences/
+- 지식 → knowledge/
+- 결정 → decisions/log.md""",
+    },
+    {
+        "job_name": "notion-sync",
+        "cron_expression": "0 22 * * *",
+        "model": "sonnet",
+        "prompt": """오늘 중요 대화/결정을 Notion 저장:
+1. 기술 결정, 진행상황, 학습 내용 추출
+2. Notion MCP → "AI 업무 로그" DB(data_source_id: 14e322c2-110e-4cce-9a22-f2c529abb54e)
+3. properties: 제목, 카테고리(결정/진행/학습/이슈/아이디어), 날짜, 요약
+4. Notion 불가시 ~/claude-telegram/memory/daily/ 기록 + 상태 알림""",
+    },
+    {
+        "job_name": "github-check",
+        "cron_expression": "0 */2 * * *",
+        "model": "haiku",
+        "prompt": """`gh api notifications` 로 읽지 않은 알림 확인.
+새 PR/이슈/코멘트 요약. PR review, 멘션, CI 실패 강조.""",
+    },
+    {
+        "job_name": "token-check",
+        "cron_expression": "0 10 * * *",
+        "model": "haiku",
+        "prompt": """~/.claude/.credentials.json 토큰 확인.
+만료 7일 이내면 경고. 만료/파일없음이면 "claude CLI 실행하여 갱신" 알림.""",
+    },
+]
+
+
+def register():
+    conn = sqlite3.connect(DB_PATH)
+    cursor = conn.cursor()
+
+    for job in JOBS:
+        # Check if job already exists
+        cursor.execute(
+            "SELECT job_id FROM scheduled_jobs WHERE job_name = ?",
+            (job["job_name"],),
+        )
+        existing = cursor.fetchone()
+
+        if existing:
+            # Update existing job
+            cursor.execute(
+                """UPDATE scheduled_jobs
+                   SET cron_expression = ?, prompt = ?, target_chat_ids = ?,
+                       working_directory = ?, model = ?, is_active = 1, updated_at = ?
+                   WHERE job_name = ?""",
+                (
+                    job["cron_expression"],
+                    job["prompt"],
+                    CHAT_ID,
+                    WORKING_DIR,
+                    job.get("model"),
+                    datetime.now().isoformat(),
+                    job["job_name"],
+                ),
+            )
+            print(f"Updated: {job['job_name']} ({job['cron_expression']}) model={job.get('model', 'default')}")
+        else:
+            # Insert new job
+            job_id = str(uuid.uuid4())
+            cursor.execute(
+                """INSERT INTO scheduled_jobs
+                   (job_id, job_name, cron_expression, prompt, target_chat_ids,
+                    working_directory, model, is_active, created_at, updated_at)
+                   VALUES (?, ?, ?, ?, ?, ?, ?, 1, ?, ?)""",
+                (
+                    job_id,
+                    job["job_name"],
+                    job["cron_expression"],
+                    job["prompt"],
+                    CHAT_ID,
+                    WORKING_DIR,
+                    job.get("model"),
+                    datetime.now().isoformat(),
+                    datetime.now().isoformat(),
+                ),
+            )
+            print(f"Created: {job['job_name']} ({job['cron_expression']}) model={job.get('model', 'default')} -> {job_id}")
+
+    conn.commit()
+    conn.close()
+    print(f"\nDone. {len(JOBS)} jobs registered.")
+
+
+if __name__ == "__main__":
+    register()

mrstack/_data/schedulers/run-threads-briefing.sh

@@ -0,0 +1,36 @@
+#!/bin/bash
+export PATH="$HOME/.local/bin:/opt/homebrew/bin:$PATH"
+cd "$HOME/claude-telegram/scrapers/threads"
+
+# Source env
+set -a
+source "$HOME/claude-telegram/.env"
+set +a
+
+# Run scraper
+node scraper.js 2>&1 | tee -a "$HOME/claude-telegram/logs/threads.log"
+
+# Get latest output file
+LATEST=$(ls -t output/*.json 2>/dev/null | head -1)
+
+if [ -n "$LATEST" ]; then
+  POST_COUNT=$(python3 -c "import json; print(len(json.load(open('$LATEST'))))" 2>/dev/null || echo "0")
+
+  # Send to bot's webhook API for Claude-powered analysis
+  WEBHOOK_RESULT=$(curl -s -o /dev/null -w "%{http_code}" \
+    -X POST http://localhost:8080/webhooks/threads \
+    -H "Authorization: Bearer $WEBHOOK_API_SECRET" \
+    -H "Content-Type: application/json" \
+    -d "{\"file\": \"$LATEST\", \"count\": $POST_COUNT}" 2>/dev/null)
+
+  if [ "$WEBHOOK_RESULT" = "200" ] || [ "$WEBHOOK_RESULT" = "202" ]; then
+    echo "Webhook sent successfully (HTTP $WEBHOOK_RESULT)" | tee -a "$HOME/claude-telegram/logs/threads.log"
+  else
+    echo "Webhook failed (HTTP $WEBHOOK_RESULT), falling back to direct briefing" | tee -a "$HOME/claude-telegram/logs/threads.log"
+    # Fallback: direct briefing
+    node briefing.js "$LATEST" 2>&1 | tee -a "$HOME/claude-telegram/logs/threads.log"
+  fi
+
+  # Save to Notion via Claude Code
+  bash "$HOME/claude-telegram/scrapers/threads/save-to-notion.sh" "$LATEST" 2>&1 | tee -a "$HOME/claude-telegram/logs/threads.log"
+fi

mrstack/_data/schedulers/weekly-review.sh

@@ -0,0 +1,26 @@
+#!/bin/bash
+export PATH="$HOME/.local/bin:/opt/homebrew/bin:$PATH"
+
+set -a
+source "$HOME/claude-telegram/.env"
+set +a
+
+CLAUDECODE= claude --print --output-format text "
+You are DD's personal assistant. Generate a weekly review.
+Check:
+1. This week's completed tasks and accomplishments
+2. Next week's scheduled events from Google Calendar
+3. AI trends summary from ~/claude-telegram/scrapers/threads/output/ (this week's files)
+4. Any pending items that need attention
+
+Format as a concise Telegram message in Korean.
+Start with: 📊 주간 회고 (date range)
+" 2>/dev/null > /tmp/weekly-review.txt
+
+MSG=$(cat /tmp/weekly-review.txt)
+if [ -n "$MSG" ]; then
+  curl -s -X POST "https://api.telegram.org/bot${TELEGRAM_BOT_TOKEN}/sendMessage" \
+    -H "Content-Type: application/json" \
+    -d "{\"chat_id\":\"${NOTIFICATION_CHAT_IDS}\",\"text\":$(echo "$MSG" | python3 -c 'import sys,json; print(json.dumps(sys.stdin.read()))')}" \
+    > /dev/null
+fi

mrstack/_data/templates/DESIGN-GUIDE.md

@@ -0,0 +1,160 @@
+# Mr.Stack Message Design Guide
+
+Mr.Stack 텔레그램 봇의 메시지 디자인 시스템 규칙.
+
+---
+
+## 1. 메시지 구조
+
+### 헤더/푸터 구분선
+- 상단: `━━━ Mr.Stack {제목} ━━━`
+- 하단: `━━━━━━━━━━━━━━━━━━━━` (━ x 20)
+- 문자: ━ (U+2501, BOX DRAWINGS HEAVY HORIZONTAL)
+- Jarvis 알림은 구분선 없이 `[Mr.Stack]` prefix만 사용
+
+### 섹션 prefix
+- `▸` (U+25B8, BLACK RIGHT-POINTING SMALL TRIANGLE)
+- 섹션 제목 앞에 사용: `▸ 오늘 일정`
+- 텔레그램 HTML: `<b>▸ 섹션 제목</b>`
+
+### 들여쓰기
+- 섹션 내용은 공백 2칸 들여쓰기
+- 일정/태스크 항목 정렬 유지
+
+---
+
+## 2. 프로그레스 바
+
+### 기본 규칙
+- 총 10칸 고정
+- 채워진 칸: █ (U+2588, FULL BLOCK)
+- 빈 칸: ░ (U+2591, LIGHT SHADE)
+
+### 변환 공식
+```
+filled = round(value / max_value * 10)
+empty = 10 - filled
+bar = "█" * filled + "░" * empty
+```
+
+### 예시
+| 값 | 바 | 표기 |
+|---|---|---|
+| 0% | ░░░░░░░░░░ | 0/10 |
+| 30% | ███░░░░░░░ | 3/10 |
+| 50% | █████░░░░░ | 5/10 |
+| 80% | ████████░░ | 8/10 |
+| 100% | ██████████ | 10/10 |
+
+### 용도별
+- **생산성 스코어**: value=score, max=10
+- **시간 분석**: value=hours, max=total_working_hours
+- **프로젝트 비율**: value=percentage, max=100
+
+---
+
+## 3. 상태 이모지 매핑
+
+| 기호 | 의미 | 용도 |
+|------|------|------|
+| ✓ | 완료/성공 | 완료된 태스크, 성공한 작업 |
+| ✗ | 실패/에러 | 실패한 빌드, 에러 발생 |
+| ◻ | 미완료/대기 | Pending 태스크, 체크리스트 |
+| · | 정보/항목 | 뉴스, 리스트 아이템, 일반 나열 |
+| — | 없음/구분 | "일정 없음", 설명 구분 |
+
+### 알림 등급 이모지
+
+| 이모지 | 등급 | 사용 상황 |
+|--------|------|-----------|
+| 🔴 | 긴급 | 즉시 조치 (서비스 장애, 보안 이슈, 배터리 < 10%) |
+| 🟡 | 주의 | 확인 필요 (성능 저하, 이상 패턴, 배터리 < 30%) |
+| 🟢 | 정보 | 참고용 (작업 완료, 상태 변경) |
+| ⚪ | 시스템 | 내부 상태 (토큰 갱신, 동기화, 메모리 업데이트) |
+
+### 카테고리 이모지
+
+| 이모지 | 용도 |
+|--------|------|
+| 📅 | 날짜, 일정 |
+| 📊 | 통계, 분석, 리포트 |
+| 💡 | 코칭, 인사이트, 팁 |
+| 🏷️ | 키워드, 태그 |
+
+---
+
+## 4. Jarvis 선제 알림 포맷
+
+### 구조
+```
+[Mr.Stack] {메시지}
+```
+
+### 규칙
+- prefix: 반드시 `[Mr.Stack]`으로 시작
+- 길이: 한 줄, 최대 100자
+- 조치 필요 시: `—` (em dash) 뒤에 구체적 행동 제안
+- 존댓말 사용, 간결하게
+- 이모지 사용 금지 (prefix가 브랜딩 역할)
+
+### 텔레그램 HTML
+```html
+<b>[Mr.Stack]</b> {메시지}
+```
+
+강조가 필요한 수치:
+```html
+<b>[Mr.Stack]</b> 배터리 <b>12%</b> — 저장하시고 충전하세요.
+```
+
+### 알림음 정책
+- 긴급 (배터리 < 10%, 장애): `disable_notification=false`
+- 일반 (정보, 상태): `disable_notification=true`
+
+---
+
+## 5. 텔레그램 HTML 호환 태그
+
+텔레그램 Bot API `parse_mode=HTML`에서 지원하는 태그:
+
+| 태그 | 용도 | 예시 |
+|------|------|------|
+| `<b>text</b>` | 굵게 | 섹션 제목, 강조 수치 |
+| `<i>text</i>` | 기울임 | 코칭 라인, 키워드 |
+| `<code>text</code>` | 인라인 코드 | 변수명, 명령어, 브랜치명 |
+| `<pre>text</pre>` | 코드 블록 | 멀티라인 코드 |
+| `<a href="url">text</a>` | 링크 | 외부 URL |
+| `<s>text</s>` | 취소선 | 취소된 항목 |
+| `<u>text</u>` | 밑줄 | 특별 강조 (절제해서 사용) |
+| `<tg-spoiler>text</tg-spoiler>` | 스포일러 | 숨김 처리 |
+| `<blockquote>text</blockquote>` | 인용 | 인용문 |
+
+### 주의사항
+- `<`, `>`, `&` 문자는 반드시 이스케이프: `&lt;`, `&gt;`, `&amp;`
+- 지원하지 않는 태그 사용 시 메시지 전송 실패
+- 태그 중첩 가능하나 최소한으로 사용
+- Markdown 파싱 모드와 혼용 불가 — HTML 모드만 사용
+
+---
+
+## 6. 템플릿 목록
+
+| 파일 | 용도 | 발송 시점 |
+|------|------|-----------|
+| morning-briefing.md | 모닝 브리핑 | 평일 08:00 |
+| evening-summary.md | 데일리 리포트 | 매일 21:00 |
+| weekly-review.md | 주간 회고 | 금요일 18:00 |
+| alert.md | 시스템/서비스 알림 | 이벤트 발생 시 |
+| jarvis-alert.md | Jarvis 선제 알림 | ContextEngine 트리거 시 |
+
+---
+
+## 7. 일반 원칙
+
+1. **일관성**: 모든 정기 메시지는 구분선 + 섹션 prefix 패턴 사용
+2. **간결성**: 불필요한 수식어 제거, 데이터 중심
+3. **실행 가능성**: 알림에는 반드시 구체적 행동 제안 포함
+4. **연결성**: evening-summary의 "내일 제안" → morning-briefing의 "코칭" 라인으로 이어짐
+5. **한국어 기본**: 기술 용어, 브랜치명, 코드는 영어 유지
+6. **최대 길이 준수**: 각 템플릿별 글자 수 제한 엄수
+7. **이모지 절제**: 카테고리 이모지만 사용, 장식용 이모지 금지