@elyun/bylane 1.16.0 → 1.18.0

package/commands/bylane-orchestrator.md

@@ -19,19 +19,11 @@ description: byLane 메인 오케스트레이터. 자연어 의도를 파싱해
 각 에이전트 실행 전 사용할 모델을 config에서 읽는다:
 
 ```bash
-node -e "
-import('./src/config.js').then(({loadConfig, getAgentModel}) => {
-  const config = loadConfig()
-  const agents = [
-    'orchestrator','issue-agent','code-agent','test-agent',
-    'commit-agent','pr-agent','review-agent','respond-agent','notify-agent'
-  ]
-  agents.forEach(a => console.log(a + ': ' + getAgentModel(config, a)))
-  // analyze-agent는 항상 opus 사용 (config 무관)
-})
-"
+npx @elyun/bylane models
 ```
 
+출력 형식: `AGENT_NAME=MODEL_ID` (한 줄씩)
+
 에이전트 호출 시 해당 모델을 `model` 파라미터로 전달한다.
 
 ## 의도 파싱 규칙
@@ -57,18 +49,7 @@ import('./src/config.js').then(({loadConfig, getAgentModel}) => {
 
 상태 기록 (각 에이전트 시작 전):
 ```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: []
-  })
-})
-"
+npx @elyun/bylane state write AGENT_NAME '{"status":"in_progress","startedAt":"'$(date -u +%Y-%m-%dT%H:%M:%SZ)'","progress":0,"currentTask":"TASK_DESCRIPTION","retries":0,"log":[]}'
 ```
 
 ## 피드백 루프

package/commands/bylane-pr-agent.md

@@ -43,7 +43,7 @@ ls .github/PULL_REQUEST_TEMPLATE/*.md 2>/dev/null | head -5
 ## 실행 전 상태 기록
 
 ```bash
-node -e "import('./src/state.js').then(({writeState})=>writeState('pr-agent',{status:'in_progress',startedAt:new Date().toISOString(),progress:0,retries:0,log:[]}))"
+npx @elyun/bylane state write pr-agent '{"status":"in_progress","startedAt":"'$(date -u +%Y-%m-%dT%H:%M:%SZ)'","progress":0,"retries":0,"log":[]}'
 ```
 
 ## 실행 흐름
@@ -90,7 +90,7 @@ node -e "import('./src/state.js').then(({writeState})=>writeState('pr-agent',{st
 
 4. 상태 업데이트:
    ```bash
-   node -e "import('./src/state.js').then(({writeState})=>writeState('pr-agent',{status:'completed',progress:100,prNumber:PR_NUMBER,prUrl:'PR_URL'}))"
+   npx @elyun/bylane state write pr-agent '{"status":"completed","progress":100,"prNumber":PR_NUMBER,"prUrl":"PR_URL"}'
    ```
 
 ## 출력

package/commands/bylane-respond-agent.md

@@ -16,9 +16,9 @@ description: PR 리뷰 코멘트에 반박하거나 코드를 수정하여 반
 | `"api"` | REST API + `$GITHUB_TOKEN` |
 | `"auto"` (기본) | MCP → CLI → API 순서로 시도 |
 
-## GitHub 리뷰 대응 템플릿 탐지
+## 대응 템플릿 탐지
 
-답글 작성 전 프로젝트 내 대응 템플릿을 탐색한다:
+답글 작성 전 프로젝트 내 템플릿을 탐색한다:
 
 ```bash
 ls .github/REVIEW_RESPONSE_TEMPLATE.md \
@@ -26,9 +26,7 @@ ls .github/REVIEW_RESPONSE_TEMPLATE.md \
    .github/CONTRIBUTING.md 2>/dev/null | head -1
 ```
 
-- `REVIEW_RESPONSE_TEMPLATE.md`가 있으면 답글 형식을 **반드시** 따른다.
-- `CONTRIBUTING.md`가 있으면 코드 기여 가이드라인을 참고하여 대응 톤/형식을 맞춘다.
-- 없으면 기본 형식으로 작성한다.
+템플릿이 있으면 답글 형식을 따른다. 없으면 간결하게 작성한다.
 
 ## 입력
 
@@ -39,28 +37,25 @@ ls .github/REVIEW_RESPONSE_TEMPLATE.md \
 
 | 모드 | 동작 |
 |---|---|
-| `auto` (기본값, 미지정 시) | 각 코멘트를 분석하여 수정 반영 또는 반박을 **자동 판단** 후 진행 |
+| `auto` (기본, 미지정 시) | 각 코멘트를 분석하여 수정 반영 또는 반박을 자동 판단 후 진행 |
 | `accept` | 모든 코멘트를 수정 반영 |
 | `rebut` | 모든 코멘트에 반박 |
-| `manual` | 코멘트별로 사용자에게 "수정 반영할까요, 반박할까요?" 질문 후 진행 |
+| `manual` | 코멘트별로 사용자에게 선택 요청 |
 
 ### auto 모드 판단 기준
 
-각 코멘트를 분석하여:
 - **반영**: 버그 지적, 명확한 컨벤션 위반, 테스트 누락, 성능 문제
-- **반박**: 의견 차이, 이미 의도된 설계, 스펙 요구사항과 일치, 트레이드오프 판단이 필요한 경우
+- **반박**: 의견 차이, 의도된 설계, 스펙 요구사항과 일치하는 경우
 
-자동 판단 결과를 사용자에게 먼저 요약으로 보여준 뒤 실행한다:
+실행 전 요약을 먼저 보여주고 확인 후 진행:
 ```
 코멘트 #1: [반영] null 체크 누락 → 코드 수정
 코멘트 #2: [반박] 의도된 설계 (이슈 #12 참조)
-코멘트 #3: [반영] 타입 오류
 진행할까요? (y/n)
 ```
 
 ### manual 모드
 
-각 코멘트를 보여주고 사용자에게 선택을 요청:
 ```
 [코멘트 #1] null 체크가 없습니다.
 → (1) 수정 반영  (2) 반박  (3) 건너뜀
@@ -69,15 +64,14 @@ ls .github/REVIEW_RESPONSE_TEMPLATE.md \
 ## 실행 전 상태 기록
 
 ```bash
-node -e "import('./src/state.js').then(({writeState})=>writeState('respond-agent',{status:'in_progress',startedAt:new Date().toISOString(),progress:0,retries:0,log:[]}))"
+npx @elyun/bylane state write respond-agent '{"status":"in_progress","startedAt":"'$(date -u +%Y-%m-%dT%H:%M:%SZ)'","progress":0,"retries":0,"log":[]}'
 ```
 
 ## 실행 흐름
 
 ### 리뷰 코멘트 로드
 
-**MCP:**
-→ GitHub MCP `list_review_comments` 도구 사용
+**MCP:** → `list_review_comments` 도구 사용
 
 **CLI:**
 ```bash
@@ -91,16 +85,12 @@ curl -s \
   https://api.github.com/repos/OWNER/REPO/pulls/PR_NUMBER/comments
 ```
 
-### accept 모드
+### 수정 반영 (accept)
 
-1. 각 코멘트별 수정 사항 결정
-2. 코드 수정 (code-agent 서브 실행)
-3. test-agent로 검증
-4. commit-agent로 수정 커밋 (`fix: address review comments`)
-5. 코멘트에 "반영 완료" 답글 게시:
+1. 코드 수정 후 커밋 (`fix: address review comments`)
+2. 해당 코멘트에 짧은 답글 게시:
 
-   **MCP:**
-   → GitHub MCP `create_review_comment_reply` 도구 사용
+   **MCP:** → `create_review_comment_reply` 사용
 
    **CLI:**
    ```bash
@@ -116,13 +106,14 @@ curl -s \
      -d '{"body":"REPLY_BODY"}'
    ```
 
-### rebut 모드
+### 반박 (rebut)
 
-1. 각 코멘트에 근거를 기술한 반박 답글 작성:
-   - 의도적 설계 결정: 배경 설명
-   - 성능 트레이드오프: 구체적 수치 근거
-   - 스펙 요구사항과 일치하는 경우: 이슈 링크 첨부
-2. 위와 동일한 방법으로 답글 게시
+근거를 간결하게 기술한 답글 작성:
+- 의도적 설계 결정: 배경 한 줄 설명
+- 스펙 요구사항과 일치: 이슈 링크 첨부
+- 성능 트레이드오프: 수치 근거
+
+답글은 짧고 명확하게. 불필요한 서두 없이 핵심만.
 
 ## 출력
 
@@ -132,7 +123,7 @@ curl -s \
   "agent": "respond-agent",
   "status": "completed",
   "progress": 100,
-  "mode": "accept",
+  "mode": "auto",
   "resolvedComments": 3,
   "needsMoreWork": false
 }
@@ -140,4 +131,4 @@ curl -s \
 
 ## 수동 실행
 
-`/bylane respond #45` → accept/rebut 선택 프롬프트 표시
+`/bylane respond #45`

package/commands/bylane-respond-loop.md

@@ -30,15 +30,12 @@ echo "폴러 PID: $!"
 pending PR이 생길 때마다 respond-agent를 실행한다:
 
 ```bash
-node -e "
-import('./src/state.js').then(({readState}) => {
-  const q = readState('respond-queue', '.bylane/state')
-  const pending = (q?.queue ?? []).filter(p => p.status === 'pending')
-  console.log(JSON.stringify(pending))
-})
-"
+# 큐 확인 (pending 항목 필터링)
+npx @elyun/bylane state read respond-queue
 ```
 
+출력된 JSON에서 `queue` 배열의 `status === "pending"` 항목을 선택한다.
+
 pending 항목이 있으면 각 PR에 대해:
 
 1. `hasChangesRequested` 여부 확인:
@@ -50,17 +47,8 @@ pending 항목이 있으면 각 PR에 대해:
 3. 완료 후 큐 항목을 `status: "responded"`로 업데이트:
 
 ```bash
-node -e "
-import('./src/state.js').then(({readState, writeState}) => {
-  const q = readState('respond-queue', '.bylane/state')
-  const queue = (q?.queue ?? []).map(p =>
-    p.number === PR_NUMBER
-      ? { ...p, status: 'responded', respondedAt: new Date().toISOString() }
-      : p
-  )
-  writeState('respond-queue', { status: 'running', queue }, '.bylane/state')
-})
-"
+# 현재 큐 읽기 후 PR_NUMBER 항목을 responded로 업데이트하여 다시 쓰기
+npx @elyun/bylane state write respond-queue '{"status":"running","queue":UPDATED_QUEUE_JSON}'
 ```
 
 4. 다음 pending 항목으로 반복. pending 없으면 5분 대기 후 재확인 (폴러 주기와 동일).

package/commands/bylane-review-agent.md

@@ -1,6 +1,6 @@
 ---
 name: bylane-review-agent
-description: PR의 diff를 분석하여 코드 리뷰 코멘트를 작성한다.
+description: PR의 diff를 분석하여 코드 라인별 인라인 리뷰 코멘트를 작성한다.
 ---
 
 # Review Agent
@@ -28,35 +28,7 @@ ls .github/REVIEW_TEMPLATE.md \
 ```
 
 GitHub 템플릿이 있으면 해당 형식을 **최우선**으로 따른다.
-없으면 아래 bylane 설정의 템플릿을 사용한다.
-
-## 리뷰 템플릿 로드
-
-실행 전 `.bylane/bylane.json`의 `review` 설정 읽기:
-
-```bash
-node -e "
-import('./src/config.js').then(({loadConfig}) => {
-  const c = loadConfig()
-  console.log(JSON.stringify(c.review, null, 2))
-})
-"
-```
-
-설정 항목:
-- `model` — 리뷰에 사용할 모델 (기본: `claude-sonnet-4-6`)
-- `language` — 리뷰 언어 (기본: `ko`)
-- `includeModel` — 푸터에 모델명 포함 여부
-- `includeCodeExample` — Before/After 코드 예시 포함 여부
-- `templateFile` — 커스텀 템플릿 파일 경로 (비어있으면 `templates/review-template.md` 사용)
-- `severityEmoji` — 심각도 레이블 커스터마이즈
-- `footer` — 푸터 문자열 (`{model}`, `{date}` 치환 가능)
-
-커스텀 템플릿이 있으면 로드:
-```bash
-# templateFile이 설정된 경우
-cat TEMPLATE_FILE_PATH
-```
+없으면 `templates/review-template.md`를 사용한다.
 
 ## 검사 항목 선택
 
@@ -88,108 +60,128 @@ Enter 또는 아무것도 선택하지 않으면 → `all` (전체 검사)
 
 | 항목 | 중점 확인 사항 |
 |---|---|
-| `grammar` | 오탈자, 주석 언어 일관성, 변수/함수명 문법, 문서 일관성 |
+| `grammar` | 오탈자, 주석 언어 일관성, 변수/함수명 문법 |
 | `domain` | 비즈니스 규칙 위반, 도메인 용어 오용, 로직 정합성 |
 | `code` | 컨벤션 위반, 중복 코드, 복잡도, 불변성, 테스트 커버리지 |
-| `security` | 시크릿 노출, SQL/XSS 인젝션, 인증·인가 누락, 민감 데이터 처리 |
+| `security` | 시크릿 노출, SQL/XSS 인젝션, 인증·인가 누락 |
 | `all` | 위 4가지 전체 |
 
-선택된 항목만 집중 검사하고, 리뷰 코멘트 상단에 검사 범위를 명시한다:
+## 실행 전 상태 기록
+
+```bash
+npx @elyun/bylane state write review-agent '{"status":"in_progress","startedAt":"'$(date -u +%Y-%m-%dT%H:%M:%SZ)'","progress":0,"retries":0,"log":[]}'
 ```
-> 검사 범위: code, security
+
+## 실행 흐름
+
+### 1. PR diff 로드
+
+**MCP:**
+→ `get_pull_request_files` + `get_pull_request` 도구 사용
+
+**CLI:**
+```bash
+gh pr diff PR_NUMBER
+gh pr view PR_NUMBER --json files,headRefName,baseRefName
 ```
 
-## 입력
+**API:**
+```bash
+curl -s \
+  -H "Authorization: Bearer $GITHUB_TOKEN" \
+  https://api.github.com/repos/OWNER/REPO/pulls/PR_NUMBER/files
+```
 
-PR 번호 (`.bylane/state/pr-agent.json`에서 자동 로드, 또는 수동 전달)
+### 2. 파일별 분석
 
-## 실행 전 상태 기록
+선택된 검사 항목 범위에서 각 변경 파일 분석:
+- 버그 가능성 (null check, 경계값, 예외 처리)
+- 타입 오류 (TypeScript)
+- 성능 이슈
+- 컨벤션 위반
+- 보안 취약점
+
+### 3. 인라인 코멘트 작성 (라인별 개별 등록)
+
+**핵심 원칙: 모든 지적사항은 해당 코드 라인에 직접 코멘트로 등록한다.**
+
+코멘트 본문 형식:
+```
+{제목}
+
+{설명}
 
+```suggestion
+{수정 제안 코드 (해당 라인 전체 대체)}
+```
+```
+
+- suggestion 블록은 수정 제안이 명확한 경우에만 포함
+- 한 코멘트에 한 가지 지적사항만 담는다
+- 검사 범위가 지정된 경우 첫 코멘트 또는 요약에 명시: `> 검사 범위: code, security`
+
+#### 인라인 코멘트 등록 방법
+
+**MCP:**
+→ `create_review` 도구의 `comments` 배열에 각 항목 포함
+
+**CLI (파일별 개별 등록):**
 ```bash
-node -e "import('./src/state.js').then(({writeState})=>writeState('review-agent',{status:'in_progress',startedAt:new Date().toISOString(),progress:0,retries:0,log:[]}))"
+# diff의 position 값 또는 line 번호 사용
+gh api repos/OWNER/REPO/pulls/PR_NUMBER/reviews \
+  --method POST \
+  --field body="" \
+  --field event="COMMENT" \
+  --field "comments[][path]=파일경로" \
+  --field "comments[][line]=라인번호" \
+  --field "comments[][body]=코멘트 본문"
 ```
 
-## 실행 흐름
+여러 코멘트는 `comments[]` 배열에 모두 담아 **한 번의 review 요청**으로 제출한다.
+
+**API:**
+```bash
+curl -s -X POST \
+  -H "Authorization: Bearer $GITHUB_TOKEN" \
+  -H "Content-Type: application/json" \
+  https://api.github.com/repos/OWNER/REPO/pulls/PR_NUMBER/reviews \
+  -d '{
+    "body": "요약 코멘트",
+    "event": "COMMENT",
+    "comments": [
+      {
+        "path": "src/foo.js",
+        "line": 42,
+        "body": "코멘트 본문 (suggestion 포함 가능)"
+      }
+    ]
+  }'
+```
+
+`event` 값: 지적사항이 있으면 `"REQUEST_CHANGES"`, 없으면 `"APPROVE"`, 코멘트만이면 `"COMMENT"`
 
-1. PR diff 로드:
-
-   **MCP:**
-   → GitHub MCP `get_pull_request_files` 도구 사용
-
-   **CLI:**
-   ```bash
-   gh pr diff PR_NUMBER
-   gh pr view PR_NUMBER --json files
-   ```
-
-   **API:**
-   ```bash
-   curl -s \
-     -H "Authorization: Bearer $GITHUB_TOKEN" \
-     https://api.github.com/repos/OWNER/REPO/pulls/PR_NUMBER/files
-   ```
-
-2. 변경된 파일별 분석:
-   - 버그 가능성 (null check, 경계값 등)
-   - 타입 오류 (TypeScript)
-   - 성능 이슈 (불필요한 리렌더링, 메모이제이션 누락)
-   - 코딩 컨벤션 위반
-   - 테스트 커버리지 누락
-
-3. 코멘트 작성 규칙 (템플릿 적용):
-
-   각 코멘트 형식:
-   ```
-   {severityEmoji.SEVERITY} {title}
-
-   {description}
-
-   [includeCodeExample=true인 경우]
-   **Before:**
-   ```lang
-   // 문제 코드
-   ```
-   **After:**
-   ```lang
-   // 개선 코드
-   ```
-
-   {suggestion}
-   ```
-
-   리뷰 언어(`language`)에 맞게 작성. `ko`이면 한국어, `en`이면 영어.
-
-4. 전체 요약 생성:
-   - 심각도별 건수 표
-   - 주요 발견사항
-   - 종합 의견
-   - 푸터: `review.footer`의 `{model}`을 실제 모델명으로, `{date}`를 현재 날짜로 치환
-
-5. 리뷰 제출 (CRITICAL/HIGH 없으면 `APPROVE`, 있으면 `REQUEST_CHANGES`):
-
-   **MCP:**
-   → GitHub MCP `create_review` 도구 사용
-
-   **CLI:**
-   ```bash
-   gh pr review PR_NUMBER --approve --body "REVIEW_BODY"
-   # 또는
-   gh pr review PR_NUMBER --request-changes --body "REVIEW_BODY"
-   ```
-
-   **API:**
-   ```bash
-   curl -s -X POST \
-     -H "Authorization: Bearer $GITHUB_TOKEN" \
-     -H "Content-Type: application/json" \
-     https://api.github.com/repos/OWNER/REPO/pulls/PR_NUMBER/reviews \
-     -d '{"body":"REVIEW_BODY","event":"APPROVE","comments":[]}'
-   ```
-
-6. 상태 업데이트:
-   ```bash
-   node -e "import('./src/state.js').then(({writeState})=>writeState('review-agent',{status:'completed',progress:100,approved:APPROVED_BOOL,commentCount:COMMENT_COUNT}))"
-   ```
+### 4. 전체 요약 (PR 전체 코멘트)
+
+```
+## 리뷰 요약
+
+> 검사 범위: {scope}
+
+### 주요 발견사항
+- ...
+
+### 종합 의견
+...
+```
+
+푸터: `review.footer`의 `{model}`을 실제 모델명으로, `{date}`를 현재 날짜로 치환.
+기본 푸터: `{model} · {date}`  (bylane 문구 없음)
+
+### 5. 상태 업데이트
+
+```bash
+npx @elyun/bylane state write review-agent '{"status":"completed","progress":100,"approved":APPROVED_BOOL,"commentCount":COMMENT_COUNT}'
+```
 
 ## 출력
 
@@ -199,8 +191,8 @@ node -e "import('./src/state.js').then(({writeState})=>writeState('review-agent'
   "agent": "review-agent",
   "status": "completed",
   "progress": 100,
-  "approved": true,
-  "commentCount": 3
+  "approved": false,
+  "commentCount": 5
 }
 ```
 

package/commands/bylane-review-loop.md

@@ -47,30 +47,19 @@ node src/review-loop.js
 아래 루프를 실행하면서 pending PR이 생길 때마다 review-agent를 실행한다:
 
 ```bash
-# 큐 확인
-node -e "
-import('./src/state.js').then(({readState}) => {
-  const q = readState('review-queue', '.bylane/state')
-  const pending = (q?.queue ?? []).filter(p => p.status === 'pending')
-  console.log(JSON.stringify(pending))
-})
-"
+# 큐 확인 (pending 항목 필터링)
+npx @elyun/bylane state read review-queue
 ```
 
+출력된 JSON에서 `queue` 배열의 `status === "pending"` 항목을 선택한다.
+
 pending 항목이 있으면 각 PR에 대해:
 1. `bylane-review-agent` skill 실행 (PR 번호 전달)
 2. 리뷰 완료 후 큐 항목을 `status: "reviewed"`로 업데이트:
 
 ```bash
-node -e "
-import('./src/state.js').then(({readState, writeState}) => {
-  const q = readState('review-queue', '.bylane/state')
-  const queue = (q?.queue ?? []).map(p =>
-    p.number === PR_NUMBER ? { ...p, status: 'reviewed', reviewedAt: new Date().toISOString() } : p
-  )
-  writeState('review-queue', { status: 'running', queue }, '.bylane/state')
-})
-"
+# 현재 큐 읽기 후 PR_NUMBER 항목을 reviewed로 업데이트하여 다시 쓰기
+npx @elyun/bylane state write review-queue '{"status":"running","queue":UPDATED_QUEUE_JSON}'
 ```
 
 3. 다음 pending 항목으로 반복

package/commands/bylane-test-agent.md

@@ -12,7 +12,7 @@ description: 변경된 코드의 테스트를 실행하고 결과를 반환한
 ## 실행 전 상태 기록
 
 ```bash
-node -e "import('./src/state.js').then(({writeState})=>writeState('test-agent',{status:'in_progress',startedAt:new Date().toISOString(),progress:0,retries:0,log:[]}))"
+npx @elyun/bylane state write test-agent '{"status":"in_progress","startedAt":"'$(date -u +%Y-%m-%dT%H:%M:%SZ)'","progress":0,"retries":0,"log":[]}'
 ```
 
 ## 실행 흐름

package/package.json

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