@elyun/bylane 1.26.0 → 1.28.0

package/commands/bylane-code-agent.md

@@ -1,13 +1,23 @@
 ---
 name: bylane-code-agent
-description: issue-agent가 작성한 전략 스펙(이슈 본문)을 기반으로 브랜치를 생성하고 코드를 구현한다. issueMemory에 진행 상황을 기록하며, 실패 시 피드백 루프로 재시도한다.
+description: issue-agent가 작성한 전략 스펙을 기반으로 코드를 구현한다. 내부적으로 분석/구현/리뷰 서브에이전트를 활용하며, 서브에이전트 간 피드백 루프(Ralph Loop)로 품질을 보장한다. 부모 에이전트에게는 최종 결과만 반환한다.
 ---
 
 # Code Agent
 
-## 입력 읽기
+> **설계 원칙**: code-agent 본체는 **오케스트레이션만** 담당한다. 실제 파일 읽기/수정/분석은 전부 서브에이전트가 수행한다. 부모(orchestrator)에게는 `changedFiles` 결과만 돌려준다.
+
+---
+
+## 실행 전 상태 기록
+
+```bash
+npx @elyun/bylane state write code-agent '{"status":"in_progress","startedAt":"'$(date -u +%Y-%m-%dT%H:%M:%SZ)'","progress":0,"currentTask":"서브에이전트 초기화","retries":0,"log":[]}'
+```
+
+---
 
-### 1. issue-agent 상태에서 spec 로드
+## 입력 읽기
 
 `.bylane/state/issue-agent.json`에서 다음 필드를 읽는다:
 
@@ -19,73 +29,172 @@ description: issue-agent가 작성한 전략 스펙(이슈 본문)을 기반으
 | `spec.checklist` | 구현 체크리스트 |
 | `spec.figmaSpec` | Figma 컬러토큰·컴포넌트 구조 |
 | `issueType` | `new-feature` / `bug` / `improvement` / `chore` |
+| `issueNumber` | GitHub 이슈 번호 |
 
-없으면 GitHub 이슈 본문을 직접 로드하여 "구현 방향", "관련 파일 및 영향 범위", "구현 체크리스트" 섹션을 파싱한다.
-
-### 2. issueMemory 로드
-
-이슈 번호를 알고 있으면 이전 세션 컨텍스트를 확인한다:
+없으면 GitHub 이슈 본문을 직접 로드하여 파싱한다.
 
+issueMemory 로드:
 ```bash
 npx @elyun/bylane memory read ISSUE_NUMBER
 ```
 
-아키텍처 결정이나 트러블슈팅 기록이 있으면 구현에 반영한다.
-
 ---
 
-## 실행 전 상태 기록
+## Phase 1 — 병렬 분석 서브에이전트 (3개 동시 실행)
 
-```bash
-npx @elyun/bylane state write code-agent '{"status":"in_progress","startedAt":"'$(date -u +%Y-%m-%dT%H:%M:%SZ)'","progress":0,"currentTask":"코드 구현 시작","retries":0,"log":[]}'
+Agent 도구로 3개를 **동시에** 호출한다.
+각 서브에이전트는 결과만 텍스트로 반환하고, code-agent 본체는 취합한다.
+
+### 서브에이전트 A — 파일 현황 분석
+```
+prompt: |
+  다음 파일들의 현재 구현 상태를 분석해줘:
+  대상: {spec.affectedFiles}
+  issueType: {issueType}
+
+  각 파일에 대해:
+  - 현재 구현 방식 요약 (있는 경우)
+  - 변경이 필요한 라인/영역
+  - 의존하는 import 목록
+
+  결과만 간결하게 텍스트로 반환. 파일을 직접 수정하지 마라.
+```
+
+### 서브에이전트 B — 코드 패턴 샘플링
+```
+prompt: |
+  이 프로젝트에서 유사한 구현 패턴을 찾아줘.
+  구현할 기능: {spec.title}
+  issueType: {issueType}
+
+  찾아야 할 것:
+  - 유사한 컴포넌트/함수 구현 예시 (파일경로:라인번호)
+  - 사용 중인 네이밍 컨벤션
+  - 테스트 파일 위치와 작성 패턴
+  - 상태 관리 / API 호출 방식
+
+  결과만 간결하게 텍스트로 반환. 파일을 수정하지 마라.
+```
+
+### 서브에이전트 C — 영향 범위 확인
+```
+prompt: |
+  다음 파일들을 수정할 때 영향받는 코드를 파악해줘:
+  대상: {spec.affectedFiles}
+
+  찾아야 할 것:
+  - 이 파일들을 import/사용하는 파일 목록
+  - 공유 컴포넌트/훅인 경우 사이드 이펙트 위험도
+  - bug/improvement인 경우: 현재 문제 지점 (파일:라인)
+
+  결과만 간결하게 텍스트로 반환. 파일을 수정하지 마라.
 ```
 
 ---
 
-## 실행 흐름
+## Phase 2 — Ralph Loop: 구현 → 리뷰 → 피드백 사이클
+
+`spec.checklist` 항목을 순서대로 처리한다.
+각 항목마다 **구현 서브에이전트 → 리뷰 서브에이전트** 쌍으로 실행하며,
+리뷰가 통과될 때까지 피드백을 실어 구현 서브에이전트를 재호출한다.
+
+```
+for each checklistItem in spec.checklist:
+
+  feedback = null
+  retries = 0
 
-### issueType별 접근 전략
+  while true:
+    [구현 서브에이전트 호출]
+    [리뷰 서브에이전트 호출]
 
-#### `new-feature`
-- `spec.affectedFiles`의 신규 파일부터 생성
-- 유사 구현 패턴(이슈 본문 "코드 패턴 참고" 섹션) 따르기
-- Figma 스펙이 있으면 컬러토큰 → CSS 변수/Tailwind config 변환
+    if 리뷰 통과 → break
+    if retries >= 2 → 상태에 경고 기록 후 break
 
-#### `bug`
-- 이슈 본문의 "문제 지점" 파일부터 열기
-- 원인 파악 후 최소 변경으로 수정
-- 재현 케이스를 테스트로 먼저 작성 (TDD)
+    feedback = 리뷰 결과
+    retries++
+```
 
-#### `improvement`
-- 기존 구현 파악 후 변경 범위 최소화
-- 사이드 이펙트 발생 가능 파일은 이슈 본문 "영향 범위" 기준으로 확인
+### 구현 서브에이전트 프롬프트
 
-#### `chore`
-- 기능 변경 없음 확인 후 진행
-- 설정 파일 변경 시 기존 동작 보존 여부 체크
+```
+prompt: |
+  다음 체크리스트 항목을 구현해줘.
+
+  [컨텍스트]
+  - 작업: {spec.title}
+  - issueType: {issueType}
+  - 구현 방향: {spec.approach}
+  - 현재 항목: {checklistItem}
+  - 관련 파일: {spec.affectedFiles에서 이 항목과 관련된 파일}
+
+  [분석 결과]
+  - 파일 현황: {서브에이전트 A 결과}
+  - 참고 패턴: {서브에이전트 B 결과}
+  - 영향 범위: {서브에이전트 C 결과}
+
+  {feedback이 있으면 추가:}
+  [이전 리뷰 피드백 — 이 내용을 반드시 반영해야 함]
+  {feedback}
+
+  [코딩 원칙]
+  - 함수형 컴포넌트 + hooks 우선
+  - 파일당 단일 책임
+  - 200줄 초과 시 분리 고려
+  - 불변성 패턴 유지 (객체 직접 수정 금지)
+  - issueType이 bug라면 최소 변경으로 수정
+  - issueType이 chore라면 기능 변경 없음 확인
+
+  구현 완료 후 변경한 파일 목록만 반환해줘.
+```
 
-### 구현 순서
+### 리뷰 서브에이전트 프롬프트
 
-1. `spec.checklist` 항목을 순서대로 처리
-2. 각 파일 구현 완료 시 상태 로그 기록:
-   ```bash
-   npx @elyun/bylane state append code-agent "FILENAME 구현 완료"
-   ```
-3. 코드베이스 기존 패턴과 동일한 스타일 유지 (TypeScript, 테스트 위치, import 방식 등)
+```
+prompt: |
+  방금 구현된 코드를 리뷰해줘.
+
+  [검토 대상]
+  - 항목: {checklistItem}
+  - 변경 파일: {구현 서브에이전트가 반환한 파일 목록}
+
+  [체크리스트]
+  1. spec.approach 방향과 일치하는가?
+  2. 코딩 원칙(불변성, 단일책임, 200줄) 준수했는가?
+  3. issueType별 주의사항 지켰는가?
+     - new-feature: 신규 파일 패턴이 기존 패턴과 일치하는가
+     - bug: 최소 변경인가, 다른 동작 변경 없는가
+     - improvement: 사이드 이펙트 없는가
+     - chore: 기능 변경 없는가
+  4. 명백한 버그나 누락 없는가?
+
+  응답 형식:
+  PASS — 문제 없음 (한 줄 요약)
+  FAIL — {구체적인 문제점과 수정 방향}
+
+  코드를 직접 수정하지 마라. 판정만 내려줘.
+```
 
-### 코딩 원칙
+### 상태 로그 (각 항목 완료 시)
 
-- 함수형 컴포넌트 + hooks 우선
-- 파일당 단일 책임
-- 200줄 초과 시 분리 고려
-- 불변성 패턴 유지 (객체 직접 수정 금지)
+```bash
+npx @elyun/bylane state append code-agent "{checklistItem} 구현 완료 (리뷰 통과)"
+```
 
 ---
 
-## 완료 처리
+## Phase 3 — 완료 처리
+
+모든 체크리스트 항목이 완료되면:
 
 ```bash
-npx @elyun/bylane state write code-agent '{"status":"completed","progress":100,"currentTask":"구현 완료","retries":0,"changedFiles":CHANGED_FILES_ARRAY}'
+npx @elyun/bylane state write code-agent '{
+  "status": "completed",
+  "progress": 100,
+  "currentTask": "구현 완료",
+  "retries": 0,
+  "changedFiles": CHANGED_FILES_ARRAY
+}'
 ```
 
 ---
@@ -105,7 +214,9 @@ npx @elyun/bylane memory append ISSUE_NUMBER code-agent "구현 요약: SUMMARY
 
 ## 출력
 
-`.bylane/state/code-agent.json`의 `changedFiles`: 변경된 파일 경로 배열
+부모(orchestrator)에게 돌려주는 값:
+- `.bylane/state/code-agent.json`의 `changedFiles` 배열
+- `status: "completed"` 또는 `"failed"`
 
 ## 수동 실행
 

package/commands/bylane-orchestrator.md

@@ -1,51 +1,50 @@
 ---
 name: bylane-orchestrator
-description: byLane 메인 오케스트레이터. 자연어 의도를 파싱하여 4가지 파이프라인(새 기능/기존 이슈/리뷰/단일 에이전트) 중 하나를 선택하고 에이전트 체인을 순차 실행한다.
+description: byLane 메인 오케스트레이터. 자연어 의도를 파싱하여 4가지 파이프라인(새 기능/기존 이슈/리뷰/단일 에이전트) 중 하나를 선택하고, 각 단계를 **서브에이전트**로 위임하여 실행한다. 오케스트레이터 본체는 상태 파일만 읽고 판단하며, 직접 구현하지 않는다.
 ---
 
 # byLane Orchestrator
 
 ## 역할
 
-사용자 의도를 파싱하고, issue-agent를 통해 전략을 수립한 뒤 에이전트 파이프라인을 실행한다.
+사용자 의도를 파싱하고, 파이프라인을 결정한 뒤 **각 에이전트를 서브에이전트로 위임**한다.
+오케스트레이터 자신은 **상태 조회와 다음 단계 결정**만 담당한다. 직접 코드를 수정하거나 이슈를 작성하지 않는다.
 
-## 실행 전 체크
+> **Hang 방지 원칙**: 오케스트레이터는 Agent 도구로 서브에이전트를 호출하고 결과만 받는다.
+> 긴 작업(코드 구현, 분석, 테스트 등)을 직접 수행하면 Claude Code가 hang될 수 있다.
+
+---
 
-1. 사전 점검:
-   ```bash
-   npx @elyun/bylane preflight
-   ```
-   실패 시 안내 메시지 출력 후 **중단**. `.bylane/bylane.json` 없으면 즉시 `bylane-setup` 스킬 실행.
+## 실행 전 체크
 
-2. `.bylane/state/` 디렉토리 확인. 없으면 생성.
+```bash
+npx @elyun/bylane preflight
+```
+실패 시 안내 메시지 출력 후 **중단**. `.bylane/bylane.json` 없으면 즉시 `bylane-setup` 스킬 실행.
 
 ## 에이전트별 모델 결정
 
 ```bash
 npx @elyun/bylane models
 ```
+출력 형식: `AGENT_NAME=MODEL_ID`. 서브에이전트 호출 시 `model` 파라미터로 전달.
 
-출력 형식: `AGENT_NAME=MODEL_ID` (한 줄씩). 에이전트 호출 시 `model` 파라미터로 전달.
+---
 
 ## 의도 파싱 규칙
 
-오케스트레이터는 `/bylane`에서 **복합 의도** 또는 **기능 요청 자연어**가 넘어올 때 실행된다.
-단일 에이전트 키워드는 `/bylane`이 직접 라우팅하므로, 오케스트레이터는 **파이프라인 실행**에 집중한다.
-
 ### 파이프라인 A — 새 기능 / 이슈 없는 구현 요청
 
 **감지 키워드**: `만들어`, `추가해`, `구현해`, `개발해`, `넣어줘`, `바꿔줘`, `변경해`, `개선해`, `수정해`,
 `리팩터`, `리팩토링`, `마이그레이션`, `~해줘` (기능 설명 포함), 이슈 번호 없음
 
-**실행 흐름**:
-전략 수립 → `issue-agent` → `code-agent` → `test-agent` → `commit-agent` → `pr-agent` → `review-agent` → `notify-agent`
+**실행 흐름**: `issue-agent` → `code-agent` → `test-agent` → `commit-agent` → `pr-agent` → `review-agent` → `notify-agent`
 
 ### 파이프라인 B — 기존 이슈 구현
 
 **감지 키워드**: `#N`, `이슈 #N`, `issue #N`, `#N 구현`, `#N 작업`, `#N 해줘`, `#N 처리`
 
-**실행 흐름**:
-전략 수립(기존 이슈 분석) → `code-agent` → `test-agent` → `commit-agent` → `pr-agent` → `review-agent` → `notify-agent`
+**실행 흐름**: `code-agent` → `test-agent` → `commit-agent` → `pr-agent` → `review-agent` → `notify-agent`
 
 ### 파이프라인 C — 리뷰 관련
 
@@ -53,62 +52,93 @@ npx @elyun/bylane models
 |---|---|
 | `PR #N 리뷰`, `리뷰해줘`, `코드 리뷰`, `#N 봐줘` | `review-agent`(PR번호 전달) |
 | `리뷰 반영`, `수락`, `accept`, `LGTM 반영`, `코멘트 반영` | `respond-agent`(모드=accept) |
-| `반박`, `rebut`, `동의 안 해`, `이유 설명`, `왜 이렇게 했냐면` | `respond-agent`(모드=rebut) |
+| `반박`, `rebut`, `동의 안 해`, `이유 설명` | `respond-agent`(모드=rebut) |
 
-### 파이프라인 D — 단일 에이전트 (오케스트레이터 경유 시)
+### 파이프라인 D — 단일 에이전트
 
 | 감지 키워드 | 실행 |
 |---|---|
-| `커밋`, `commit`, `커밋해줘`, `변경사항 저장` | `commit-agent` |
-| `PR`, `풀리퀘`, `PR 만들어`, `PR 올려` | `pr-agent` |
-| `테스트`, `test`, `검증`, `시험`, `테스트 돌려` | `test-agent` |
-| `분석`, `analyze`, `구조 파악`, `코드 분석` | `analyze-agent` |
-| `알림`, `notify`, `슬랙`, `텔레그램`, `통보` | `notify-agent` |
-
-### 파이프라인 판단 기준
+| `커밋`, `commit` | `commit-agent` |
+| `PR`, `풀리퀘`, `PR 만들어` | `pr-agent` |
+| `테스트`, `test`, `검증` | `test-agent` |
+| `분석`, `구조 파악` | `analyze-agent` |
+| `알림`, `notify` | `notify-agent` |
 
-1. 이슈 번호(`#N`)가 있으면 → **파이프라인 B**
-2. 기능/변경 요청 키워드가 있고 이슈 번호 없으면 → **파이프라인 A**
-3. 리뷰/대응 키워드가 있으면 → **파이프라인 C**
-4. 단일 에이전트 키워드만 있으면 → **파이프라인 D**
-5. 복합 키워드 ("이슈 만들고 구현까지", "테스트하고 커밋") → 파이프라인 A 또는 해당 에이전트 순차 실행
-6. 판단 불가 → 사용자에게 의도 확인
+### 판단 기준
 
-## 전략 수립 단계 (파이프라인 A, B 필수)
+1. 이슈 번호(`#N`) → 파이프라인 B
+2. 기능/변경 키워드 + 이슈 번호 없음 → 파이프라인 A
+3. 리뷰/대응 키워드 → 파이프라인 C
+4. 단일 에이전트 키워드만 → 파이프라인 D
+5. 판단 불가 → 사용자에게 의도 확인
 
-파이프라인 C, D (단일 에이전트 요청)가 아닌 경우 반드시 전략 수립 후 진행.
+---
 
-issue-agent를 `model` 파라미터와 함께 호출한다. issue-agent 내부에서 다음을 수행:
+## 파이프라인 실행 방식 (핵심)
 
-1. 코드베이스 병렬 분석 (서브에이전트)
-2. 사용자 문답
-3. 이슈 분류 및 작성
+오케스트레이터는 각 에이전트를 **Agent 도구로 서브에이전트 호출**한다.
+서브에이전트가 완료되면 `.bylane/state/{name}.json`의 `status`만 확인하고 다음 단계로 진행한다.
 
-상세 로직은 `bylane-issue-agent` 참조.
+```
+[오케스트레이터]
+    ↓ Agent 도구 호출 (bylane-issue-agent 스킬)
+[issue-agent 서브에이전트] — 내부에서 3개 병렬 분석 서브에이전트 실행
+    ↓ 완료 → .bylane/state/issue-agent.json 에 결과 기록
+[오케스트레이터] state 확인 → issueNumber, spec 읽기
+    ↓ Agent 도구 호출 (bylane-code-agent 스킬)
+[code-agent 서브에이전트] — 내부에서 구현/리뷰 피드백 루프 실행
+    ↓ 완료 → .bylane/state/code-agent.json 에 결과 기록
+[오케스트레이터] state 확인 → changedFiles 읽기
+    ↓ ... (이하 동일)
+```
 
-## 에이전트 실행 방법
+### 각 에이전트 호출 방법
 
-각 에이전트를 순서대로 Agent 도구로 호출. 이전 출력을 다음 입력으로 전달.
-**config에서 읽은 모델을 `model` 파라미터로 반드시 전달.**
+Agent 도구에 아래 형식으로 전달한다:
 
-상태 기록 (각 에이전트 시작 전):
-```bash
-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":[]}'
 ```
+subagent_type: "general-purpose"
+model: {models 명령으로 확인한 해당 에이전트 모델}
+prompt: |
+  다음 bylane 스킬을 실행해줘: bylane-{에이전트명}
+
+  [컨텍스트]
+  - 이슈 번호: {issueNumber} (있는 경우)
+  - 이슈 URL: {issueUrl} (있는 경우)
+  - 이전 단계 출력: {이전 state 파일 핵심 필드}
+
+  스킬 완료 후 .bylane/state/{에이전트명}.json 에 결과가 기록된다.
+  결과 파일의 status, 핵심 출력 필드만 응답으로 돌려줘.
+```
+
+---
 
-## 피드백 루프
+## 피드백 루프 (오케스트레이터 레벨)
 
 test-agent가 FAIL 반환 시:
+
 1. `.bylane/state/test-agent.json`에서 `failureDetails` 읽기
-2. `retries < config.workflow.maxRetries` → code-agent 재실행 (실패 피드백 포함, retries+1)
+2. `retries < config.workflow.maxRetries` → **code-agent 서브에이전트 재호출** (failureDetails 포함, retries+1)
 3. `retries >= maxRetries` → notify-agent에 "개입 필요" 메시지 후 중단
 
-respond-agent가 "수정 필요" 반환 시 동일 로직 적용.
+respond-agent가 "수정 필요" 반환 시 동일 로직.
+
+> 재호출 시 code-agent에 전달할 추가 컨텍스트:
+> `"이전 테스트 실패 내용: {failureDetails}. 해당 부분을 중점적으로 수정해줘."`
+
+---
 
 ## 완료 처리
 
-1. 각 에이전트 state를 `status: "completed"`로 업데이트
-2. notify-agent 실행하여 최종 결과 전송
+각 에이전트 완료 후 notify-agent 서브에이전트 호출:
+
+```
+prompt: |
+  bylane-notify-agent 스킬 실행.
+  type: completed
+  summary: {전체 파이프라인 요약}
+  url: {PR URL}
+```
 
 ## 수동 실행
 

package/commands/bylane-review-agent.md

@@ -158,7 +158,16 @@ curl -s -X POST \
   }'
 ```
 
-`event` 값: 지적사항이 있으면 `"REQUEST_CHANGES"`, 없으면 `"APPROVE"`, 코멘트만이면 `"COMMENT"`
+`event` 값 결정:
+
+| 조건 | `review.autoApprove` | event |
+|------|---------------------|-------|
+| 지적사항 있음 | 무관 | `"REQUEST_CHANGES"` |
+| 지적사항 없음 | `true` | `"APPROVE"` |
+| 지적사항 없음 | `false` (기본) | `"COMMENT"` — 사람이 직접 Approve 판단 |
+| 코멘트만 | 무관 | `"COMMENT"` |
+
+`review.autoApprove`가 `false`(기본값)이면 AI가 Approve를 내리지 않고 코멘트만 남긴다.
 
 ### 4. 전체 요약 (PR 전체 코멘트)
 
@@ -175,7 +184,7 @@ curl -s -X POST \
 ```
 
 푸터: `review.footer`의 `{model}`을 실제 모델명으로, `{date}`를 현재 날짜로 치환.
-기본 푸터: `{model} · {date}`  (bylane 문구 없음)
+기본 푸터: `🤖 {model} · {date}`  — 모델명 앞에 🤖 이모지로 AI 리뷰임을 표시
 
 ### 5. 상태 업데이트
 

package/commands/bylane-setup.md

@@ -83,7 +83,16 @@ Linear API Key는 환경변수명(`LINEAR_API_KEY`)으로 저장. 실제 키값
 
 `permissions.scope`에 저장.
 
-## Step 5/8 — Loop 실행 모드
+## Step 5/9 — 리뷰 자동 Approve
+
+> AI 리뷰에서 지적사항이 없을 때 자동으로 Approve할까요? (y/n, 기본: n)
+
+- `n` (기본) → `review.autoApprove = false` — AI는 코멘트만 남기고, Approve는 사람이 직접 판단
+- `y` → `review.autoApprove = true` — 지적사항 없으면 AI가 자동 Approve
+
+대부분의 팀에서는 사람이 최종 Approve하는 것을 권장한다.
+
+## Step 6/9 — Loop 실행 모드
 
 > Loop 실행 모드를 선택하세요:
 > 1. tmux  — tmux 세션에서 백그라운드 실행 (터미널 종료 후에도 유지, 권장)
@@ -108,7 +117,7 @@ bylane loop stop    # loop 종료
 bylane loop status  # 상태 확인
 ```
 
-## Step 6/8 — 고급 설정
+## Step 7/9 — 고급 설정
 
 > 고급 설정을 변경하시겠습니까? (Enter = 기본값 사용)
 
@@ -117,7 +126,7 @@ bylane loop status  # 상태 확인
 - `loopTimeoutMinutes` (기본: 30): 루프 타임아웃 (분)
 - Figma MCP 활성화? (y/n, 기본: n)
 
-## Step 7/8 — 브랜치 네이밍
+## Step 8/9 — 브랜치 네이밍
 
 > 브랜치 네이밍 패턴을 선택하세요:
 > 1. {tracker}-{issue-number}              예) issues-32
@@ -132,7 +141,7 @@ bylane loop status  # 상태 확인
 직접 입력 시 사용 가능한 토큰 목록 안내:
 `{tracker}`, `{type}`, `{issue-number}`, `{custom-id}`, `{title-slug}`, `{date}`, `{username}`
 
-## Step 8/8 — 에이전트 모델 설정
+## Step 9/9 — 에이전트 모델 설정
 
 > 각 에이전트에 사용할 AI 모델을 설정하시겠습니까? (Enter = 기본값 사용)
 

package/package.json

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

package/src/cli.js

@@ -223,7 +223,7 @@ if (command === 'install') {
   }
 } else if (command === 'loop') {
   const subCmd = args[1] || 'start'
-  const { resolveLoopMode, startTmuxLoops, stopTmuxLoops, isTmuxSessionAlive } = await import('./loop-utils.js')
+  const { resolveLoopMode, startTmuxLoops, stopTmuxLoops, isTmuxSessionAlive, findLoopPid } = await import('./loop-utils.js')
   const { loadConfig } = await import('./config.js')
   const config = loadConfig()
   const sessionName = config.loop?.sessionName ?? 'bylane-loops'
@@ -264,42 +264,50 @@ if (command === 'install') {
       stopped = true
     }
 
-    // 2) process 모드 PID 종료 시도 (모드 무관)
+    // 2) PID 기반 종료 (state → pgrep fallback)
     const { readState, writeState } = await import('./state.js')
     for (const loopName of ['review-loop', 'respond-loop']) {
-      const state = readState(loopName)
-      if (!state?.pid) continue
-      const pid = Number(state.pid)
-      let alive = false
-      try { process.kill(pid, 0); alive = true } catch {}
-
-      if (alive) {
-        try {
-          process.kill(pid, 'SIGTERM')
-          console.log(`  ${loopName} (PID: ${pid}) 종료`)
-        } catch {
-          console.log(`  ${loopName} (PID: ${pid}) 종료 실패`)
+      const found = findLoopPid(loopName)
+      if (!found) {
+        // state가 running이면 정리
+        const state = readState(loopName)
+        if (state?.status === 'running') {
+          writeState(loopName, { ...state, status: 'stopped', stoppedAt: new Date().toISOString() })
+          console.log(`  ${loopName}: 프로세스를 찾을 수 없음 — 상태 정리`)
+          stopped = true
         }
-      } else {
-        console.log(`  ${loopName} (PID: ${pid}) 이미 종료됨 — 상태 정리`)
+        continue
+      }
+
+      const { pid, source } = found
+      try {
+        process.kill(pid, 'SIGTERM')
+        const state = readState(loopName)
+        if (state) writeState(loopName, { ...state, status: 'stopped', stoppedAt: new Date().toISOString() })
+        console.log(`  ${loopName} (PID: ${pid}, 출처: ${source}) 종료`)
+        stopped = true
+      } catch (err) {
+        console.log(`  ${loopName} (PID: ${pid}) 종료 실패: ${err.message}`)
+        console.log(`  수동 종료: kill -9 ${pid}`)
       }
-      writeState(loopName, { ...state, status: 'stopped', stoppedAt: new Date().toISOString() })
-      stopped = true
     }
 
     if (!stopped) {
       console.log('  실행 중인 루프가 없습니다.')
     }
   } else if (subCmd === 'status') {
-    const alive = isTmuxSessionAlive(sessionName)
+    const tmuxAlive = isTmuxSessionAlive(sessionName)
     const { readState } = await import('./state.js')
-    const reviewState = readState('review-loop')
-    const respondState = readState('respond-loop')
     const mode = resolveLoopMode()
     console.log(`\n  모드: ${mode}`)
-    console.log(`  tmux 세션 (${sessionName}): ${alive ? '실행 중' : '없음'}`)
-    console.log(`  review-loop: ${reviewState?.status ?? 'unknown'}${reviewState?.pid ? ` (PID: ${reviewState.pid})` : ''}`)
-    console.log(`  respond-loop: ${respondState?.status ?? 'unknown'}${respondState?.pid ? ` (PID: ${respondState.pid})` : ''}\n`)
+    console.log(`  tmux 세션 (${sessionName}): ${tmuxAlive ? '실행 중' : '없음'}`)
+    for (const loopName of ['review-loop', 'respond-loop']) {
+      const state = readState(loopName)
+      const found = findLoopPid(loopName)
+      const pidInfo = found ? `PID: ${found.pid} (${found.source}, 실행 중)` : (state?.pid ? `PID: ${state.pid} (사망)` : '프로세스 없음')
+      console.log(`  ${loopName}: ${state?.status ?? 'unknown'} — ${pidInfo}`)
+    }
+    console.log('')
   } else {
     console.error('사용법: bylane loop <start|stop|status>')
     process.exit(1)

package/src/config.js

@@ -67,6 +67,7 @@ export const DEFAULT_CONFIG = {
     language: 'ko',
     includeModel: true,
     includeCodeExample: true,
+    autoApprove: false,
     templateFile: '',
     severityEmoji: {
       CRITICAL: '[CRITICAL]',
@@ -74,7 +75,7 @@ export const DEFAULT_CONFIG = {
       MEDIUM: '[MEDIUM]',
       LOW: '[LOW]'
     },
-    footer: 'Reviewed by byLane · model: {model}'
+    footer: '🤖 {model} · {date}'
   }
 }
 

package/src/loop-utils.js

@@ -47,6 +47,42 @@ export function killExistingLoop(loopName, stateDir = '.bylane/state') {
   }
 }
 
+/**
+ * 루프 프로세스의 PID를 반환한다.
+ * state 파일 → pgrep fallback 순서로 탐색.
+ * @param {string} loopName  e.g. 'review-loop'
+ * @param {string} stateDir
+ * @returns {{ pid: number, source: 'state' | 'pgrep' } | null}
+ */
+export function findLoopPid(loopName, stateDir = '.bylane/state') {
+  // 1) state 파일에서 PID 확인
+  const state = readState(loopName, stateDir)
+  if (state?.pid) {
+    const pid = Number(state.pid)
+    try {
+      process.kill(pid, 0)
+      return { pid, source: 'state' }
+    } catch {
+      // PID가 있지만 이미 죽었으면 pgrep으로 재시도
+    }
+  }
+
+  // 2) pgrep으로 프로세스명 검색
+  const scriptFile = `${loopName}.js`
+  try {
+    const result = execSync(`pgrep -f "${scriptFile}"`, { encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] }).trim()
+    if (result) {
+      // 여러 PID가 있을 수 있음 — 첫 번째 사용
+      const pid = Number(result.split('\n')[0])
+      if (pid && pid !== process.pid) return { pid, source: 'pgrep' }
+    }
+  } catch {
+    // pgrep 결과 없음
+  }
+
+  return null
+}
+
 /**
  * tmux 세션이 살아있는지 확인
  * @param {string} sessionName