@elyun/bylane 1.0.0

package/CLAUDE.md

@@ -0,0 +1,73 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## 프로젝트 개요
+
+byLane — Claude Code용 프론트엔드 개발 자동화 하네스.
+오케스트레이터 + 워커 에이전트 패턴으로 GitHub 이슈 생성부터 PR 머지까지 자동화.
+
+## 커맨드
+
+```bash
+# 의존성 설치
+npm install
+
+# 전체 테스트 실행
+npm test
+
+# 모니터 대시보드 실행
+npm run monitor
+
+# 테스트용 더미 상태 생성
+node -e "import('./src/state.js').then(({writeState})=>writeState('code-agent',{status:'in_progress',progress:50,retries:0,startedAt:new Date().toISOString(),log:[]}))"
+```
+
+## 아키텍처
+
+- `src/state.js` — `.bylane/state/*.json` 읽기/쓰기 유틸 (writeState, readState, clearState, listStates, appendLog)
+- `src/config.js` — `.bylane/bylane.json` 로드/저장/검증 (loadConfig, saveConfig, validateConfig, DEFAULT_CONFIG)
+- `src/branch.js` — 브랜치명 패턴 엔진 (buildBranchName, buildBranchNameFromConfig)
+- `src/monitor/` — blessed 기반 TUI 대시보드 (2열 그리드, 1초 폴링)
+- `skills/` — Claude Code 에이전트 skill 파일들
+- `hooks/` — 외부 이벤트 자동 감지 훅
+- `commands/` — `/bylane` 슬래시 커맨드 정의
+
+## 에이전트 파이프라인
+
+```
+orchestrator → issue-agent → code-agent → test-agent → commit-agent
+            → pr-agent → review-agent → respond-agent → notify-agent
+```
+
+각 에이전트는 `.bylane/state/{name}.json`에 상태 기록. 모니터가 1초마다 폴링.
+
+## 상태 파일 스키마
+
+```json
+{
+  "agent": "code-agent",
+  "status": "in_progress | completed | failed | idle",
+  "startedAt": "ISO8601",
+  "progress": 0,
+  "retries": 0,
+  "log": [{ "ts": "ISO8601", "msg": "string" }]
+}
+```
+
+## 브랜치 네이밍 토큰
+
+`{tracker}`, `{type}`, `{issue-number}`, `{custom-id}`, `{title-slug}`, `{date}`, `{username}`
+
+빈 토큰은 자동으로 제외됨:
+- `{tracker}-{issue-number}-{custom-id}` + custom-id 없음 → `issues-32`
+- `{tracker}-{issue-number}-{custom-id}` + custom-id=C-12 → `issues-32-C-12`
+
+## 테스트 구조
+
+```
+tests/
+├── state.test.js   — writeState, readState, clearState, listStates, appendLog
+├── config.test.js  — loadConfig, saveConfig, validateConfig, DEFAULT_CONFIG
+└── branch.test.js  — buildBranchName (5개 패턴 케이스)
+```

package/README.md

@@ -0,0 +1,186 @@
+# byLane
+
+> Claude Code용 프론트엔드 개발 자동화 하네스
+
+GitHub Issues에서 시작해 코드 구현, 테스트, 커밋, PR 생성, 리뷰, 리뷰 반영까지 전체 개발 워크플로우를 에이전트 기반으로 자동화합니다.
+
+## 특징
+
+- **전체 워크플로우 자동화** — `/bylane 다크모드 토글 추가해줘` 한 줄로 이슈 생성부터 PR까지
+- **개별 실행 가능** — 각 에이전트를 단독으로 실행 가능
+- **실시간 모니터링** — 2열 그리드 터미널 TUI 대시보드
+- **피드백 루프** — 테스트 실패 시 자동 재시도 (설정 가능)
+- **Figma MCP 연동** — 이슈의 Figma 링크에서 스펙 자동 추출 (선택적)
+- **Slack / Telegram 알림** — 완료 또는 개입 필요 시 알림
+
+## 요구사항
+
+- [Claude Code](https://claude.ai/code) CLI
+- Node.js 20+
+- GitHub MCP (Claude Code 기본 제공)
+- Slack MCP / Telegram (알림 사용 시)
+- Figma MCP (디자인 연동 사용 시)
+
+## 설치
+
+### npx로 설치 (권장)
+
+```bash
+npx bylane
+```
+
+Skills, Commands, Hooks 파일을 `~/.claude/` 하위 디렉토리에 자동으로 복사합니다.
+
+심볼릭 링크로 설치하면 레포 업데이트 시 자동으로 반영됩니다:
+
+```bash
+npx bylane --symlink
+```
+
+### 수동 설치
+
+```bash
+git clone https://github.com/el-yun/byLane.git
+cd byLane
+npm install
+node src/cli.js install
+```
+
+### 셋업 위자드 실행
+
+Claude Code를 열고 프로젝트 디렉토리에서:
+
+```
+/bylane setup
+```
+
+6단계 인터랙티브 설정:
+1. 이슈 트래커 (GitHub Issues / Linear / 둘 다)
+2. 알림 채널 (Slack / Telegram / 둘 다)
+3. 팀 모드 설정
+4. 권한 범위 (read-only / write / full)
+5. 고급 설정 (재시도 횟수, 타임아웃, Figma MCP)
+6. 브랜치 네이밍 패턴
+
+## 사용법
+
+### 전체 워크플로우
+
+자연어로 작업 내용을 설명하면 오케스트레이터가 적절한 에이전트를 자동으로 실행합니다.
+
+```
+/bylane 다크모드 토글 버튼 추가해줘
+/bylane issue #123 구현해줘
+/bylane PR #45 리뷰해줘
+/bylane 리뷰 #45 반영해줘
+```
+
+### 개별 에이전트 실행
+
+```
+/bylane issue [#번호 | 텍스트]   이슈 생성/분석
+/bylane code [#번호]             코드 구현
+/bylane test                     테스트 실행
+/bylane commit                   커밋 생성
+/bylane pr                       PR 생성
+/bylane review [PR번호]          PR 리뷰
+/bylane respond [PR번호]         리뷰 반박/반영
+/bylane notify                   알림 발송
+/bylane status                   현재 상태 요약
+```
+
+### 모니터 대시보드
+
+```bash
+npm run monitor
+# 또는
+/bylane monitor
+```
+
+```
+╔══════════════════════════════════════════════════════════════════╗
+║  byLane Monitor   Issue #123: "Add dark mode"   4m 31s  17:32  ║
+╠═══════════════════════════╦══════════════════════════════════════╣
+║  AGENT PIPELINE           ║  AGENT LOG                 [LIVE]  ║
+║                           ║                                     ║
+║  issue-agent  [✓] 완료   ║  17:32:38 code-agent               ║
+║  code-agent   [▶] 67%    ║    → ThemeToggle.tsx 생성           ║
+║  test-agent   [○] 대기   ║  17:30:09 issue-agent              ║
+║  ...                      ║    → ✓ spec.json 저장됨             ║
+╠═══════════════════════════╬══════════════════════════════════════╣
+║  QUEUE                    ║  SYSTEM STATUS                      ║
+║  1  Issue #124  대기중    ║  GitHub    ✓ 연결됨                 ║
+║  2  PR #45  review        ║  Slack     ✓ #dev-alerts            ║
+╚═══════════════════════════╩══════════════════════════════════════╝
+  [q]종료  [p]일시정지  [↑↓]로그스크롤
+```
+
+## 브랜치 네이밍 패턴
+
+셋업 시 패턴을 정의하거나 `.bylane/bylane.json`에서 직접 설정:
+
+| 패턴 | 예시 |
+|---|---|
+| `{tracker}-{issue-number}` | `issues-32` |
+| `{tracker}-{issue-number}-{custom-id}` | `issues-32-C-12` |
+| `{type}/{issue-number}-{title-slug}` | `feature/32-add-dark-mode` |
+
+사용 가능한 토큰: `{tracker}`, `{type}`, `{issue-number}`, `{custom-id}`, `{title-slug}`, `{date}`, `{username}`
+
+빈 토큰은 자동으로 제외됩니다 (`{custom-id}` 없으면 `issues-32`).
+
+## 설정 파일 (`.bylane/bylane.json`)
+
+```json
+{
+  "version": "1.0",
+  "trackers": {
+    "primary": "github",
+    "linear": { "enabled": false, "apiKey": "" }
+  },
+  "notifications": {
+    "slack": { "enabled": true, "channel": "#dev-alerts" },
+    "telegram": { "enabled": false, "chatId": "" }
+  },
+  "workflow": {
+    "maxRetries": 3,
+    "loopTimeoutMinutes": 30,
+    "autoEscalate": true
+  },
+  "branch": {
+    "pattern": "{tracker}-{issue-number}",
+    "tokens": { "tracker": "issues", "type": "feature", "custom-id": "" },
+    "caseStyle": "kebab-case"
+  },
+  "extensions": {
+    "figma": { "enabled": false, "useAt": "issue-analysis" }
+  }
+}
+```
+
+## 에이전트 파이프라인
+
+```
+orchestrator
+  → issue-agent    (이슈 생성/분석, Figma 스펙 추출)
+  → code-agent     (코드 구현)
+  → test-agent     (테스트 실행, 실패 시 code-agent 재시도)
+  → commit-agent   (브랜치 생성 + 커밋)
+  → pr-agent       (PR 생성)
+  → review-agent   (자동 리뷰)
+  → respond-agent  (리뷰 반박 또는 반영)
+  → notify-agent   (Slack/Telegram 알림)
+```
+
+각 에이전트는 수동 단독 실행 가능하며, 타인의 PR/리뷰에도 대응합니다.
+
+## 개발
+
+```bash
+npm test        # 테스트 실행 (19개)
+npm run monitor # 모니터 대시보드
+```
+
+## 라이선스
+
+MIT

package/commands/bylane-monitor.md

@@ -0,0 +1,43 @@
+---
+name: bylane-monitor
+description: byLane 실시간 TUI 모니터 대시보드를 실행한다.
+---
+
+# /bylane monitor
+
+## 설명
+
+현재 진행 중인 모든 byLane 에이전트의 상태를 2열 그리드 TUI로 실시간 표시한다.
+`.bylane/state/*.json` 파일을 1초마다 폴링하여 갱신.
+
+## 실행
+
+```bash
+npm run monitor
+```
+
+또는:
+```bash
+node src/monitor/index.js
+```
+
+## 레이아웃
+
+```
+╔══════════════════════════════════════════════════════════╗
+║  byLane Monitor   [현재작업]   [경과시간]  [시각]         ║
+╠══════════════════╦═══════════════════════════════════════╣
+║  AGENT PIPELINE  ║  AGENT LOG                  [LIVE]   ║
+║  (좌상)          ║  (우상)                               ║
+╠══════════════════╬═══════════════════════════════════════╣
+║  QUEUE           ║  SYSTEM STATUS                        ║
+║  (좌하)          ║  (우하)                               ║
+╚══════════════════╩═══════════════════════════════════════╝
+```
+
+## 키보드 단축키
+
+| 키 | 동작 |
+|---|---|
+| `q` / `Ctrl+C` | 종료 |
+| `↑` / `↓` | 로그 패널 스크롤 |

package/commands/bylane.md

@@ -0,0 +1,61 @@
+---
+name: bylane
+description: byLane 메인 커맨드. 자연어로 전체 개발 워크플로우를 실행한다.
+---
+
+# /bylane
+
+## 사용법
+
+```
+/bylane [자연어 명령]   — 전체 워크플로우 자동 실행
+/bylane setup          — 셋업 위자드 (재실행 가능)
+/bylane monitor        — 실시간 TUI 대시보드
+/bylane issue [#번호 | 텍스트]
+/bylane code [#번호]
+/bylane test
+/bylane commit
+/bylane pr
+/bylane review [PR번호]
+/bylane respond [PR번호]
+/bylane notify
+/bylane status         — 현재 상태 한 줄 요약
+```
+
+## 실행 흐름
+
+첫 번째 인자가 서브커맨드인지 확인:
+
+| 서브커맨드 | 실행 스킬 |
+|---|---|
+| (없음 or 자연어) | `bylane-orchestrator` |
+| `setup` | `bylane-setup` |
+| `monitor` | 아래 참조 |
+| `issue` | `bylane-issue-agent` |
+| `code` | `bylane-code-agent` |
+| `test` | `bylane-test-agent` |
+| `commit` | `bylane-commit-agent` |
+| `pr` | `bylane-pr-agent` |
+| `review` | `bylane-review-agent` |
+| `respond` | `bylane-respond-agent` |
+| `notify` | `bylane-notify-agent` |
+| `status` | `.bylane/state/` 파일 읽어 한 줄 요약 출력 |
+
+## monitor 서브커맨드
+
+```bash
+npm run monitor --prefix PATH_TO_BYLANE
+```
+
+또는 byLane이 PATH에 설치된 경우:
+```bash
+bylane-monitor
+```
+
+## status 서브커맨드
+
+`.bylane/state/*.json` 파일을 읽어 각 에이전트의 현재 상태를 한 줄로 출력:
+
+```
+orchestrator: idle | issue-agent: completed | code-agent: in_progress(67%) | ...
+```