@elyun/bylane 1.0.0

package/skills/notify-agent.md

@@ -0,0 +1,75 @@
+---
+name: bylane-notify-agent
+description: 워크플로우 완료 또는 개입 필요 시 Slack/Telegram으로 알림을 보낸다.
+---
+
+# Notify Agent
+
+## 입력
+
+- `type`: `completed` | `escalated` | `error`
+- `summary`: 결과 요약 텍스트
+- `url`: 관련 GitHub URL (PR, Issue 등)
+
+## 실행 전 상태 기록
+
+```bash
+node -e "import('./src/state.js').then(({writeState})=>writeState('notify-agent',{status:'in_progress',startedAt:new Date().toISOString(),progress:0,retries:0,log:[]}))"
+```
+
+## 실행 흐름
+
+`.bylane/bylane.json`에서 알림 설정 로드.
+
+### 터미널 출력 (항상 실행)
+
+```
+[byLane] ✅ 완료: TITLE
+PR: PR_URL
+소요 시간: ELAPSED
+```
+
+에러/에스컬레이션 시:
+```
+[byLane] ⚠️ 개입 필요: TITLE
+이유: REASON
+확인: 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
+  ```
+
+### Telegram 알림 (notifications.telegram.enabled: true)
+
+```bash
+curl -s -X POST "https://api.telegram.org/bot$TELEGRAM_BOT_TOKEN/sendMessage" \
+  -d "chat_id=$TELEGRAM_CHAT_ID&text=MESSAGE&parse_mode=Markdown"
+```
+
+## 출력
+
+`.bylane/state/notify-agent.json`:
+```json
+{
+  "agent": "notify-agent",
+  "status": "completed",
+  "progress": 100,
+  "notifiedChannels": ["terminal", "slack"]
+}
+```
+
+## 수동 실행
+
+`/bylane notify` → 가장 최근 워크플로우 결과로 알림 발송

package/skills/orchestrator.md

@@ -0,0 +1,70 @@
+---
+name: bylane-orchestrator
+description: byLane 메인 오케스트레이터. 자연어 의도를 파싱해 에이전트 파이프라인을 실행한다.
+---
+
+# byLane Orchestrator
+
+## 역할
+
+사용자의 자연어 입력을 파싱하여 어떤 에이전트를 어떤 순서로 실행할지 결정한다.
+
+## 실행 전 체크
+
+1. `.bylane/bylane.json` 로드. 없으면 즉시 `bylane-setup` 스킬 실행.
+2. `.bylane/state/` 디렉토리 확인. 없으면 생성.
+
+## 의도 파싱 규칙
+
+입력을 분석하여 아래 중 하나로 분류:
+
+| 패턴 | 실행할 에이전트 체인 |
+|---|---|
+| "구현", "만들어", "추가해", 이슈 없음 | issue-agent → code-agent → test-agent → commit-agent → pr-agent → review-agent → notify-agent |
+| "issue #N 구현", "이슈 #N 작업" | issue-agent(분석) → code-agent → test-agent → commit-agent → pr-agent → review-agent → notify-agent |
+| "PR #N 리뷰", "리뷰해줘" | review-agent(PR번호 전달) |
+| "리뷰 #N 반영", "리뷰 수락" | respond-agent(PR번호, 모드=accept 전달) |
+| "리뷰 #N 반박" | respond-agent(PR번호, 모드=rebut 전달) |
+| "커밋해줘" | commit-agent |
+| "PR 만들어줘" | pr-agent |
+| "테스트해줘" | test-agent |
+
+## 에이전트 실행 방법
+
+각 에이전트를 순서대로 Agent 도구로 호출한다. 이전 에이전트의 출력을 다음 에이전트의 입력으로 전달한다.
+
+상태 기록 (각 에이전트 시작 전):
+```bash
+node -e "
+import('./src/state.js').then(({writeState}) => {
+  writeState('AGENT_NAME', {
+    status: 'in_progress',
+    startedAt: new Date().toISOString(),
+    progress: 0,
+    currentTask: 'TASK_DESCRIPTION',
+    retries: 0,
+    log: []
+  })
+})
+"
+```
+
+## 피드백 루프
+
+test-agent가 FAIL을 반환하면:
+1. `.bylane/state/test-agent.json`에서 `failureDetails` 읽기
+2. `.bylane/state/orchestrator.json`에서 `retries` 값 읽기
+3. `retries < config.workflow.maxRetries`이면 code-agent를 재실행 (실패 피드백 포함, retries+1)
+4. `retries >= maxRetries`이면 notify-agent에 "개입 필요" 메시지 전송 후 중단
+
+respond-agent가 "수정 필요"를 반환하면 동일 로직 적용.
+
+## 완료 처리
+
+모든 에이전트 완료 후:
+1. 각 에이전트 state를 `status: "completed"`로 업데이트
+2. notify-agent 실행하여 최종 결과 전송
+
+## 수동 실행
+
+`/bylane [자연어]` 또는 자연어 감지 시 자동 실행

package/skills/pr-agent.md

@@ -0,0 +1,73 @@
+---
+name: bylane-pr-agent
+description: 현재 브랜치의 커밋들로 GitHub Pull Request를 생성한다.
+---
+
+# PR Agent
+
+## 입력
+
+- `.bylane/state/commit-agent.json`의 `branchName`, `commitSha`
+- `.bylane/state/issue-agent.json`의 `spec.title`, `issueNumber`
+
+## 실행 전 상태 기록
+
+```bash
+node -e "import('./src/state.js').then(({writeState})=>writeState('pr-agent',{status:'in_progress',startedAt:new Date().toISOString(),progress:0,retries:0,log:[]}))"
+```
+
+## 실행 흐름
+
+1. 원격 브랜치 푸시:
+   ```bash
+   git push -u origin BRANCH_NAME
+   ```
+
+2. PR 제목/본문 생성:
+   - 제목: 스펙 제목 (70자 이내)
+   - 본문:
+     ```
+     ## Summary
+     - [변경 요약]
+
+     ## Test Plan
+     - [ ] 변경된 기능 동작 확인
+     - [ ] 기존 테스트 통과 확인
+
+     Closes #ISSUE_NUMBER
+     ```
+
+3. GitHub MCP로 PR 생성:
+   - `title`: 생성된 제목
+   - `body`: 생성된 본문
+   - `head`: 현재 브랜치명
+   - `base`: main
+
+4. 상태 업데이트:
+   ```bash
+   node -e "
+   import('./src/state.js').then(({writeState})=>writeState('pr-agent',{
+     status:'completed',
+     progress:100,
+     prNumber:'PR_NUMBER',
+     prUrl:'PR_URL'
+   }))
+   "
+   ```
+
+## 출력
+
+`.bylane/state/pr-agent.json`:
+```json
+{
+  "agent": "pr-agent",
+  "status": "completed",
+  "progress": 100,
+  "prNumber": 45,
+  "prUrl": "https://github.com/owner/repo/pull/45"
+}
+```
+
+## 수동 실행
+
+`/bylane pr`

package/skills/respond-agent.md

@@ -0,0 +1,55 @@
+---
+name: bylane-respond-agent
+description: PR 리뷰 코멘트에 반박하거나 코드를 수정하여 반영한다.
+---
+
+# Respond Agent
+
+## 입력
+
+- PR 번호
+- 모드: `accept` (반영) 또는 `rebut` (반박)
+
+## 실행 전 상태 기록
+
+```bash
+node -e "import('./src/state.js').then(({writeState})=>writeState('respond-agent',{status:'in_progress',startedAt:new Date().toISOString(),progress:0,retries:0,log:[]}))"
+```
+
+## 실행 흐름
+
+### accept 모드
+
+1. GitHub MCP로 미해결 리뷰 코멘트 로드
+2. 각 코멘트별 수정 사항 결정
+3. 코드 수정 (code-agent 서브 실행)
+4. test-agent로 검증
+5. commit-agent로 수정 커밋 (`fix: address review comments`)
+6. GitHub MCP로 각 코멘트에 "반영 완료" 답글 작성
+
+### rebut 모드
+
+1. GitHub MCP로 미해결 리뷰 코멘트 로드
+2. 각 코멘트에 대해 근거를 기술한 반박 답글 작성:
+   - 의도적 설계 결정인 경우: 배경 설명
+   - 성능 트레이드오프: 구체적 수치 근거 제시
+   - 스펙 요구사항과 일치하는 경우: 이슈 링크 첨부
+3. GitHub MCP로 반박 답글 게시
+
+## 출력
+
+`.bylane/state/respond-agent.json`:
+```json
+{
+  "agent": "respond-agent",
+  "status": "completed",
+  "progress": 100,
+  "mode": "accept",
+  "resolvedComments": 3,
+  "needsMoreWork": false
+}
+```
+
+## 수동 실행
+
+`/bylane respond #45` → accept/rebut 선택 프롬프트 표시

package/skills/review-agent.md

@@ -0,0 +1,65 @@
+---
+name: bylane-review-agent
+description: PR의 diff를 분석하여 코드 리뷰 코멘트를 작성한다.
+---
+
+# Review Agent
+
+## 입력
+
+PR 번호 (`.bylane/state/pr-agent.json`에서 자동 로드, 또는 수동 전달)
+
+## 실행 전 상태 기록
+
+```bash
+node -e "import('./src/state.js').then(({writeState})=>writeState('review-agent',{status:'in_progress',startedAt:new Date().toISOString(),progress:0,retries:0,log:[]}))"
+```
+
+## 실행 흐름
+
+1. GitHub MCP로 PR diff 로드
+2. 변경된 파일별 분석:
+   - 버그 가능성 (null check, 경계값 등)
+   - 타입 오류 (TypeScript)
+   - 성능 이슈 (불필요한 리렌더링, 메모이제이션 누락)
+   - 코딩 컨벤션 위반
+   - 테스트 커버리지 누락
+
+3. 리뷰 코멘트 심각도:
+   - **CRITICAL**: 즉시 수정 필요 (버그, 보안)
+   - **HIGH**: 수정 강력 권장
+   - **MEDIUM**: 개선 권장
+   - **LOW**: 선택적 개선
+
+4. GitHub MCP로 리뷰 제출:
+   - CRITICAL/HIGH 없으면 → `approve`
+   - CRITICAL/HIGH 있으면 → `request_changes`
+
+5. 상태 업데이트:
+   ```bash
+   node -e "
+   import('./src/state.js').then(({writeState})=>writeState('review-agent',{
+     status:'completed',
+     progress:100,
+     approved:APPROVED_BOOL,
+     commentCount:COMMENT_COUNT
+   }))
+   "
+   ```
+
+## 출력
+
+`.bylane/state/review-agent.json`:
+```json
+{
+  "agent": "review-agent",
+  "status": "completed",
+  "progress": 100,
+  "approved": true,
+  "commentCount": 3
+}
+```
+
+## 수동 실행
+
+`/bylane review #45`

package/skills/setup.md

@@ -0,0 +1,101 @@
+---
+name: bylane-setup
+description: byLane 하네스 최초 설치 및 설정 위자드. /bylane setup 으로 실행.
+---
+
+# byLane Setup Wizard
+
+사용자에게 단계별로 질문하여 `.bylane/bylane.json`을 생성한다.
+ALWAYS complete all 6 steps before saving. NEVER skip steps.
+
+## 실행 전 준비
+
+1. `.bylane/` 디렉토리가 없으면 생성:
+   ```bash
+   mkdir -p .bylane/state
+   ```
+
+2. 기존 bylane.json 있으면 현재 설정을 로드해 기본값으로 사용.
+
+## Step 1/6 — 이슈 트래커
+
+사용자에게 묻는다:
+
+> 주 이슈 트래커를 선택하세요:
+> 1. GitHub Issues (권장)
+> 2. Linear
+> 3. 둘 다
+
+- `1` → `trackers.primary = "github"`, `linear.enabled = false`
+- `2` → `trackers.primary = "linear"`, Linear API Key 입력 요청
+- `3` → `trackers.primary = "both"`, Linear API Key 입력 요청
+
+Linear API Key는 환경변수명(`LINEAR_API_KEY`)으로 저장. 실제 키값은 저장하지 않는다.
+
+## Step 2/6 — 알림 채널
+
+> 완료 알림을 받을 채널을 선택하세요:
+> 1. Slack
+> 2. Telegram
+> 3. 둘 다
+> 4. 건너뜀
+
+- Slack 선택 시: 채널명 입력 (예: `#dev-alerts`)
+- Telegram 선택 시: Chat ID 입력 방법 안내 후 입력받기
+- 건너뜀 → 알림 비활성화
+
+## Step 3/6 — 팀 모드
+
+> 팀 모드를 활성화하시겠습니까? (y/n)
+
+- `y` → 팀원 GitHub 핸들 입력 (쉼표 구분, 예: `@alice, @bob`)
+  - 리뷰 할당 방식 질문: `1. round-robin  2. random`
+- `n` → `team.enabled = false`
+
+## Step 4/6 — 권한 범위
+
+> Claude가 자동으로 수행할 수 있는 작업 범위를 선택하세요:
+> 1. read-only  (분석/리뷰만, 코드 변경 없음)
+> 2. write      (코드 작성 + PR 생성, 머지 제외) ← 권장
+> 3. full       (머지까지 포함)
+
+`permissions.scope`에 저장.
+
+## Step 5/6 — 고급 설정
+
+> 고급 설정을 변경하시겠습니까? (Enter = 기본값 사용)
+
+각 항목을 순서대로 묻는다. Enter 입력 시 기본값 유지:
+- `maxRetries` (기본: 3): 에이전트 재시도 최대 횟수
+- `loopTimeoutMinutes` (기본: 30): 루프 타임아웃 (분)
+- Figma MCP 활성화? (y/n, 기본: n)
+
+## Step 6/6 — 브랜치 네이밍
+
+> 브랜치 네이밍 패턴을 선택하세요:
+> 1. {tracker}-{issue-number}              예) issues-32
+> 2. {tracker}-{issue-number}-{custom-id}  예) issues-32-C-12
+> 3. {type}/{issue-number}-{title-slug}    예) feature/32-add-dark-mode
+> 4. 직접 입력
+
+사전 정의 패턴 선택 시 해당 토큰 기본값 확인:
+- `tracker` 기본값: `issues`
+- `type` 기본값: `feature`
+
+직접 입력 시 사용 가능한 토큰 목록 안내:
+`{tracker}`, `{type}`, `{issue-number}`, `{custom-id}`, `{title-slug}`, `{date}`, `{username}`
+
+## 저장
+
+모든 설정 수집 후:
+1. `.bylane/` 디렉토리 확인 및 생성:
+   ```bash
+   mkdir -p .bylane/state
+   ```
+2. 수집된 설정을 `.bylane/bylane.json`에 JSON 형식으로 저장
+3. 설정 요약을 사용자에게 출력한다.
+4. `bylane-monitor` 실행 방법 안내:
+   ```
+   모니터 대시보드: npm run monitor (byLane 디렉토리에서)
+   또는: /bylane monitor
+   ```

package/skills/test-agent.md

@@ -0,0 +1,63 @@
+---
+name: bylane-test-agent
+description: 변경된 코드의 테스트를 실행하고 결과를 반환한다.
+---
+
+# Test Agent
+
+## 입력
+
+`.bylane/state/code-agent.json`의 `changedFiles` 배열
+
+## 실행 전 상태 기록
+
+```bash
+node -e "import('./src/state.js').then(({writeState})=>writeState('test-agent',{status:'in_progress',startedAt:new Date().toISOString(),progress:0,retries:0,log:[]}))"
+```
+
+## 실행 흐름
+
+1. `.bylane/state/code-agent.json`에서 `changedFiles` 로드
+2. 관련 테스트 파일 탐지 (`*.test.ts`, `*.spec.ts`, `*.test.tsx`, `*.test.js`)
+3. 프로젝트 테스트 커맨드 확인 (`package.json` → `scripts.test`)
+4. 테스트 실행:
+   ```bash
+   npm test 2>&1
+   ```
+5. 결과 파싱:
+   - 모두 통과 → `status: "passed"` 저장
+   - 실패 있음 → `status: "failed"`, `failureDetails` 포함 저장
+
+## 출력
+
+`.bylane/state/test-agent.json`:
+```json
+{
+  "agent": "test-agent",
+  "status": "passed",
+  "progress": 100,
+  "totalTests": 12,
+  "passed": 12,
+  "failed": 0,
+  "failureDetails": []
+}
+```
+
+실패 시:
+```json
+{
+  "agent": "test-agent",
+  "status": "failed",
+  "progress": 100,
+  "totalTests": 12,
+  "passed": 10,
+  "failed": 2,
+  "failureDetails": [
+    { "test": "should render ThemeToggle", "error": "Cannot read property of undefined" }
+  ]
+}
+```
+
+## 수동 실행
+
+`/bylane test`

package/src/branch.js

@@ -0,0 +1,31 @@
+export function buildBranchName(pattern, tokens, caseStyle = null) {
+  let result = pattern
+  for (const [key, value] of Object.entries(tokens)) {
+    if (!value) {
+      // 빈 토큰과 앞의 구분자(-_/) 제거
+      result = result.replace(new RegExp(`[-_/]\\{${key}\\}`), '')
+      result = result.replace(new RegExp(`\\{${key}\\}[-_/]?`), '')
+    } else {
+      result = result.replace(new RegExp(`\\{${key}\\}`, 'g'), value)
+    }
+  }
+  // 잔여 미치환 토큰 제거
+  result = result.replace(/\{[^}]+\}/g, '')
+  // 중복 구분자 정리 (슬래시는 보존)
+  result = result.replace(/[-_]{2,}/g, '-').replace(/^[-_]|[-_]$/g, '')
+  // 선행/후행 슬래시 정리
+  result = result.replace(/^\/|\/$/g, '').replace(/\/{2,}/g, '/')
+  if (caseStyle === 'kebab-case') {
+    result = result.replace(/\s+/g, '-').toLowerCase()
+  }
+  return result
+}
+
+export function buildBranchNameFromConfig(config, issueNumber, extra = {}) {
+  const tokens = {
+    ...config.branch.tokens,
+    'issue-number': String(issueNumber),
+    ...extra
+  }
+  return buildBranchName(config.branch.pattern, tokens, config.branch.caseStyle)
+}

package/src/cli.js

@@ -0,0 +1,67 @@
+#!/usr/bin/env node
+import { cpSync, mkdirSync, symlinkSync, existsSync, readdirSync } from 'fs'
+import { join, dirname } from 'path'
+import { fileURLToPath } from 'url'
+import { homedir } from 'os'
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+const ROOT = join(__dirname, '..')
+const CLAUDE_DIR = join(homedir(), '.claude')
+
+const args = process.argv.slice(2)
+const command = args[0] || 'install'
+const useSymlink = args.includes('--symlink')
+
+const TARGETS = [
+  { src: join(ROOT, 'skills'),   dest: join(CLAUDE_DIR, 'skills'),   label: 'Skills' },
+  { src: join(ROOT, 'commands'), dest: join(CLAUDE_DIR, 'commands'),  label: 'Commands' },
+  { src: join(ROOT, 'hooks'),    dest: join(CLAUDE_DIR, 'hooks'),     label: 'Hooks' },
+]
+
+function install() {
+  console.log('\n  byLane 설치 중...\n')
+
+  for (const { src, dest, label } of TARGETS) {
+    mkdirSync(dest, { recursive: true })
+
+    if (useSymlink) {
+      const files = readdirSync(src)
+      for (const file of files) {
+        const linkPath = join(dest, file)
+        const targetPath = join(src, file)
+        if (!existsSync(linkPath)) {
+          symlinkSync(targetPath, linkPath)
+        }
+        console.log(`  ✓ ${label}: ${file} → ${linkPath}`)
+      }
+    } else {
+      cpSync(src, dest, { recursive: true })
+      const files = readdirSync(src)
+      for (const file of files) {
+        console.log(`  ✓ ${label}: ${file}`)
+      }
+    }
+  }
+
+  console.log(`
+  ✅ byLane 설치 완료!
+
+  다음 단계:
+  1. Claude Code를 열고 프로젝트 디렉토리로 이동
+  2. 셋업 위자드 실행:
+
+     /bylane setup
+
+  3. 이후 사용:
+
+     /bylane 다크모드 토글 추가해줘
+`)
+}
+
+if (command === 'install') {
+  install()
+} else {
+  console.error(`알 수 없는 명령: ${command}`)
+  console.error('사용법: npx bylane [install] [--symlink]')
+  process.exit(1)
+}

package/src/config.js

@@ -0,0 +1,86 @@
+import { readFileSync, writeFileSync, existsSync } from 'fs'
+import { join } from 'path'
+
+export const DEFAULT_CONFIG = {
+  version: '1.0',
+  trackers: {
+    primary: 'github',
+    linear: { enabled: false, apiKey: '' }
+  },
+  notifications: {
+    slack: { enabled: false, channel: '' },
+    telegram: { enabled: false, chatId: '' }
+  },
+  team: {
+    enabled: false,
+    members: [],
+    reviewAssignment: 'round-robin'
+  },
+  permissions: {
+    scope: 'write',
+    allowMerge: false,
+    allowForceClose: false
+  },
+  workflow: {
+    maxRetries: 3,
+    loopTimeoutMinutes: 30,
+    autoEscalate: true
+  },
+  branch: {
+    pattern: '{tracker}-{issue-number}',
+    tokens: { tracker: 'issues', type: 'feature', 'custom-id': '' },
+    separator: '-',
+    caseStyle: 'kebab-case'
+  },
+  extensions: {
+    figma: { enabled: false, useAt: 'issue-analysis' }
+  }
+}
+
+export function loadConfig(dir = '.bylane') {
+  const path = join(dir, 'bylane.json')
+  if (!existsSync(path)) return { ...DEFAULT_CONFIG }
+  try {
+    const raw = JSON.parse(readFileSync(path, 'utf8'))
+    return deepMerge({ ...DEFAULT_CONFIG }, raw)
+  } catch {
+    return { ...DEFAULT_CONFIG }
+  }
+}
+
+function deepMerge(target, source) {
+  const result = { ...target }
+  for (const key of Object.keys(source)) {
+    if (
+      source[key] !== null &&
+      typeof source[key] === 'object' &&
+      !Array.isArray(source[key]) &&
+      typeof target[key] === 'object' &&
+      target[key] !== null
+    ) {
+      result[key] = deepMerge(target[key], source[key])
+    } else {
+      result[key] = source[key]
+    }
+  }
+  return result
+}
+
+export function saveConfig(config, dir = '.bylane') {
+  const path = join(dir, 'bylane.json')
+  writeFileSync(path, JSON.stringify(config, null, 2))
+}
+
+export function validateConfig(config) {
+  const errors = []
+  if (typeof config.workflow?.maxRetries !== 'number') {
+    errors.push('workflow.maxRetries must be a number')
+  }
+  if (!['github', 'linear', 'both'].includes(config.trackers?.primary)) {
+    errors.push('trackers.primary must be "github", "linear", or "both"')
+  }
+  if (!['read-only', 'write', 'full'].includes(config.permissions?.scope)) {
+    errors.push('permissions.scope must be "read-only", "write", or "full"')
+  }
+  return errors
+}