@elyun/bylane 1.31.0 → 1.33.0

package/README.md

@@ -28,7 +28,7 @@ GitHub Issues에서 시작해 코드 구현, 테스트, 커밋, PR 생성, 리
 - [Claude Code](https://claude.ai/code) CLI
 - Node.js 20+
 - GitHub MCP (Claude Code 기본 제공) / `gh` CLI / `GITHUB_TOKEN` 중 하나
-- Slack MCP 또는 Telegram (알림 사용 시, 선택사항)
+- Slack Incoming Webhook URL 또는 Telegram Bot Token (알림 사용 시, 선택사항)
 - Figma MCP (디자인 연동 사용 시, 선택사항)
 
 ---
@@ -443,7 +443,7 @@ respond-loop    독립: 5분 주기 리뷰 코멘트 감지
     "linear": { "enabled": false, "apiKey": "" }
   },
   "notifications": {
-    "slack": { "enabled": true, "channel": "#dev-alerts" },
+    "slack": { "enabled": true, "webhookUrl": "https://hooks.slack.com/services/T.../B.../..." },
     "telegram": { "enabled": false, "chatId": "" }
   },
   "workflow": {
@@ -486,6 +486,54 @@ respond-loop    독립: 5분 주기 리뷰 코멘트 감지
 }
 ```
 
+### Slack 웹훅 설정 (Workflow Builder)
+
+**1. Workflow 생성**
+
+Slack → **Automations** → **New Workflow** → **Start from scratch**
+트리거: **Webhook**
+
+**2. 변수 스키마 정의**
+
+웹훅 트리거 설정에서 아래 변수를 추가:
+
+| 변수명 | 타입 |
+|--------|------|
+| `title` | 텍스트 |
+| `status` | 텍스트 |
+| `url` | 텍스트 |
+| `elapsed` | 텍스트 |
+| `reason` | 텍스트 |
+
+**3. 메시지 단계 추가**
+
+"Send a message" 단계에서 변수 참조:
+```
+{{title}} — {{status}}
+{{url}}
+{{elapsed}}{{reason}}
+```
+
+**4. Workflow 게시 후 Webhook URL 복사**
+
+URL 형식: `https://hooks.slack.com/workflows/...`
+
+**5. `.bylane/bylane.json`에 입력**
+
+```json
+"notifications": {
+  "slack": {
+    "enabled": true,
+    "webhookUrl": "https://hooks.slack.com/workflows/..."
+  }
+}
+```
+
+알림이 발송되는 시점:
+- ✅ PR 생성/머지 완료
+- ⚠️ 테스트 실패로 개입 필요
+- ❌ 파이프라인 오류
+
 ### 브랜치 네이밍 토큰
 
 | 토큰 | 설명 |

package/commands/bylane-notify-agent.md

@@ -38,18 +38,44 @@ PR: PR_URL
 
 ### Slack 알림 (notifications.slack.enabled: true)
 
-Slack MCP `slack_send_message` 도구 사용:
-- 채널: `config.notifications.slack.channel`
-- 완료 메시지:
-  ```
-  [byLane] ✅ 완료: TITLE
-  PR: PR_URL | 소요 시간: ELAPSED
-  ```
-- 개입 필요 메시지:
-  ```
-  [byLane] ⚠️ 개입 필요: TITLE
-  이유: REASON | 확인: PR_URL
-  ```
+Slack Workflow Builder 웹훅으로 POST한다.
+Workflow에 정의된 변수 스키마와 페이로드 키가 일치해야 한다.
+
+```bash
+# 완료 (type: completed)
+curl -s -X POST "$SLACK_WEBHOOK_URL" \
+  -H "Content-Type: application/json" \
+  -d "{
+    \"title\": \"TITLE\",
+    \"status\": \"completed\",
+    \"url\": \"PR_URL\",
+    \"elapsed\": \"ELAPSED\",
+    \"reason\": \"\"
+  }"
+
+# 개입 필요 (type: escalated / error)
+curl -s -X POST "$SLACK_WEBHOOK_URL" \
+  -H "Content-Type: application/json" \
+  -d "{
+    \"title\": \"TITLE\",
+    \"status\": \"escalated\",
+    \"url\": \"PR_URL\",
+    \"elapsed\": \"\",
+    \"reason\": \"REASON\"
+  }"
+```
+
+Workflow Builder에서 정의해야 할 변수 스키마:
+
+| 변수명 | 타입 | 설명 |
+|--------|------|------|
+| `title` | 텍스트 | 작업 제목 |
+| `status` | 텍스트 | `completed` / `escalated` / `error` |
+| `url` | 텍스트 | GitHub PR/Issue URL |
+| `elapsed` | 텍스트 | 소요 시간 (완료 시) |
+| `reason` | 텍스트 | 실패/에스컬레이션 이유 |
+
+`webhookUrl`이 비어 있으면 Slack 알림을 건너뛴다.
 
 ### Telegram 알림 (notifications.telegram.enabled: true)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elyun/bylane",
-  "version": "1.31.0",
+  "version": "1.33.0",
   "description": "Frontend development harness for Claude Code",
   "type": "module",
   "bin": {

package/src/config.js

@@ -8,7 +8,7 @@ export const DEFAULT_CONFIG = {
     linear: { enabled: false, apiKey: '' }
   },
   notifications: {
-    slack: { enabled: false, channel: '' },
+    slack: { enabled: false, webhookUrl: '' },
     telegram: { enabled: false, chatId: '' }
   },
   team: {