@elyun/bylane 1.22.0 → 1.24.0

package/commands/bylane-issue-agent.md

@@ -1,13 +1,18 @@
 ---
 name: bylane-issue-agent
-description: GitHub Issue 생성 및 분석. Figma 링크 감지 시 스펙 추출.
+description: 코드베이스를 병렬 분석(구조/스타일/의존성)하고 사용자 문답으로 요구사항을 구체화한 뒤, 전략 스펙이 포함된 GitHub 이슈를 작성한다. code-agent의 입력이 된다.
 ---
 
 # Issue Agent
 
+## 역할
+
+코드베이스를 병렬로 분석하고, 사용자와 문답을 거쳐 이슈 유형을 분류한 뒤,
+code-agent가 방향을 명확하게 읽을 수 있는 구조화된 이슈를 작성한다.
+
 ## GitHub 접근 방법
 
-`.bylane/bylane.json`의 `github.method` 확인:
+`.bylane/bylane.json`의 `github.method`:
 
 | 값 | 동작 |
 |----|------|
@@ -16,69 +21,195 @@ description: GitHub Issue 생성 및 분석. Figma 링크 감지 시 스펙 추
 | `"api"` | REST API + `$GITHUB_TOKEN` |
 | `"auto"` (기본) | MCP → CLI → API 순서로 시도 |
 
-## 입력
+## 상태 기록 (시작 시)
+
+```bash
+npx @elyun/bylane state write issue-agent '{"status":"in_progress","startedAt":"'$(date -u +%Y-%m-%dT%H:%M:%SZ)'","progress":0,"currentTask":"전략 수립 중","retries":0,"log":[]}'
+```
 
-- 자유 텍스트 (새 이슈 생성용) OR GitHub Issue 번호 (#N)
+---
 
 ## 실행 흐름
 
-### 새 이슈 생성 모드 (텍스트 입력)
+### Phase 0 — issueMemory 로드 (이슈 번호가 있는 경우)
+
+기존 이슈 번호가 입력되었으면 이전 작업 컨텍스트를 불러온다:
+
+```bash
+npx @elyun/bylane memory read ISSUE_NUMBER
+```
+
+출력된 내용(이전 아키텍처 결정, 트러블슈팅 기록)을 이후 분석에 반영한다.
+
+---
+
+### Phase 1 — 이슈 유형 1차 분류
+
+입력 텍스트 또는 기존 이슈 본문을 분석하여 유형을 예비 분류:
+
+| 유형 | 판단 기준 |
+|------|-----------|
+| `new-feature` | 신규 컴포넌트/페이지/기능 추가 |
+| `bug` | 오류, 크래시, 잘못된 동작 |
+| `improvement` | 기존 기능 수정·개선·리팩토링 |
+| `chore` | 설정, 의존성, 빌드, 문서 |
+
+---
+
+### Phase 2 — 코드베이스 병렬 분석
+
+서브에이전트 3개를 **동시에** 실행한다. 각 에이전트는 아래 질문에 답한다.
+
+#### 서브에이전트 A — 관련 파일 탐색
+- 입력 의도와 관련된 파일·폴더를 DFS로 탐색
+- 관련 컴포넌트, hook, util, 타입 정의 목록화
+- 현재 구현 방식 요약 (있는 경우)
+
+#### 서브에이전트 B — 코드 패턴 분석
+- 유사 기능의 구현 패턴 샘플링 (컴포넌트 구조, 상태 관리, API 호출 방식)
+- 네이밍 컨벤션, 파일 분리 방식
+- 테스트 파일 위치 및 작성 패턴
+
+#### 서브에이전트 C — 의존성 및 영향 범위
+- 변경 시 영향받는 파일·모듈 목록
+- 공유 컴포넌트/훅 여부 확인
+- `bug` / `improvement` 유형이면 해당 코드의 현재 상태와 문제 지점 파악
+
+**`extensions.figma.enabled === true`이고 Figma URL이 있는 경우:**
+서브에이전트 A와 병렬로 Figma MCP 분석도 실행:
+- `get_file` / `get_node`로 프레임/컴포넌트 구조 추출
+- 컬러 토큰, 타이포그래피, 레이아웃 정보 추출
+- 실패 시 경고 로그 후 텍스트 기반 스펙으로 fallback
+
+---
+
+### Phase 3 — 사용자 문답 (방향 확정)
+
+병렬 분석 결과를 요약하여 사용자에게 제시하고, **핵심 결정 사항만** 질문한다.
+
+질문 예시 (유형에 따라 선택):
+
+**new-feature:**
+```
+분석 결과:
+- 관련 파일: src/components/theme/, src/hooks/useTheme.ts
+- 유사 구현: ColorPicker 컴포넌트 (src/components/ColorPicker/)
+
+결정이 필요한 사항:
+1. 토글 위치: 헤더 우측 / 사이드바 하단 / 플로팅 버튼?
+2. 상태 저장: localStorage / 서버 동기화?
+```
+
+**bug:**
+```
+분석 결과:
+- 문제 지점: src/hooks/useAuth.ts:47 — 토큰 만료 시 갱신 로직 누락
+- 영향 범위: useAuth를 사용하는 12개 컴포넌트
+
+확인 사항:
+1. 재현 조건이 있으신가요? (특정 브라우저, 로그인 상태 등)
+2. 임시 수정 vs 근본 해결 중 어느 방향으로 진행할까요?
+```
+
+문답은 **1~3개 질문**으로 제한. 명확한 경우 생략 가능.
+
+---
+
+### Phase 4 — 이슈 작성
+
+문답 결과와 분석 내용을 바탕으로 GitHub 이슈를 작성한다.
+
+#### 이슈 본문 구조
+
+```markdown
+## 개요
+
+[한 줄 요약 — 무엇을, 왜]
+
+**유형:** `new-feature` | `bug` | `improvement` | `chore`
+
+---
+
+## 배경 및 목적
+
+[사용자 의도 + 분석으로 파악한 현재 상태]
+
+---
+
+## 구현 방향
+
+[Phase 3 문답에서 확정된 전략적 방향]
+
+- 접근 방법: ...
+- 채택 이유: ...
+- 제외한 대안: ... (이유)
+
+---
+
+## 관련 파일 및 영향 범위
+
+| 파일/모듈 | 역할 | 변경 필요 여부 |
+|-----------|------|--------------|
+| `src/hooks/useTheme.ts` | 테마 상태 관리 | 수정 |
+| `src/components/Header/` | 토글 위치 | 추가 |
+
+---
+
+## 코드 패턴 참고
 
-1. 입력 텍스트에서 추출:
-   - 제목 (50자 이내), 상세 설명, 구현 체크리스트, Figma URL
+[서브에이전트 B가 발견한 유사 구현 패턴 요약]
 
-2. 이슈 생성:
+```typescript
+// 유사 구현 예시 (src/components/ColorPicker/index.tsx 참조)
+```
+
+---
 
-   **MCP:**
-   → GitHub MCP `create_issue` 도구 사용
+## Figma 스펙 (해당 시)
 
-   **CLI:**
-   ```bash
-   gh issue create \
-     --title "TITLE" \
-     --body "BODY" \
-     --label "bylane-auto"
-   ```
+- 컴포넌트: [컴포넌트명]
+- 컬러 토큰: `--color-primary: #3B82F6`
+- 레이아웃: [설명]
 
-   **API:**
-   ```bash
-   curl -s -X POST \
-     -H "Authorization: Bearer $GITHUB_TOKEN" \
-     -H "Content-Type: application/json" \
-     https://api.github.com/repos/OWNER/REPO/issues \
-     -d '{"title":"TITLE","body":"BODY","labels":["bylane-auto"]}'
-   ```
+---
 
-3. Figma MCP 활성화 여부 확인 (`extensions.figma.enabled`):
-   - `true`이고 Figma URL 있으면 → Figma 분석 단계 실행
-   - `false` → 텍스트 기반 스펙만 생성
+## 구현 체크리스트
 
-### 기존 이슈 분석 모드 (Issue 번호 입력)
+- [ ] [첫 번째 구현 단위]
+- [ ] [두 번째 구현 단위]
+- [ ] 테스트 작성
+- [ ] 기존 테스트 통과 확인
 
-1. 이슈 내용 로드:
+---
 
-   **MCP:**
-   → GitHub MCP `get_issue` 도구 사용
+## 주의사항
 
-   **CLI:**
-   ```bash
-   gh issue view NUMBER --json title,body,labels
-   ```
+[영향 범위, 사이드 이펙트, 알려진 제약]
+```
 
-   **API:**
-   ```bash
-   curl -s \
-     -H "Authorization: Bearer $GITHUB_TOKEN" \
-     https://api.github.com/repos/OWNER/REPO/issues/NUMBER
-   ```
+#### 이슈 생성
 
-2. 본문에서 Figma URL 추출 시도 후 스펙 생성
+**MCP:**
+→ GitHub MCP `create_issue` 도구 사용
 
-### Figma 분석 (활성화된 경우)
+**CLI:**
+```bash
+gh issue create \
+  --title "TITLE" \
+  --body "BODY" \
+  --label "bylane-auto"
+```
 
-Figma MCP `get_file` 또는 `get_node` 도구로 프레임/컴포넌트 분석.
+**API:**
+```bash
+curl -s -X POST \
+  -H "Authorization: Bearer $GITHUB_TOKEN" \
+  -H "Content-Type: application/json" \
+  https://api.github.com/repos/OWNER/REPO/issues \
+  -d '{"title":"TITLE","body":"BODY","labels":["bylane-auto"]}'
+```
 
-**실패 시 fallback:** 경고 로그 후 텍스트 기반 스펙 사용
+---
 
 ## 출력
 
@@ -91,20 +222,35 @@ Figma MCP `get_file` 또는 `get_node` 도구로 프레임/컴포넌트 분석.
   "progress": 100,
   "issueNumber": 123,
   "issueUrl": "https://github.com/...",
+  "issueType": "new-feature",
   "spec": {
     "title": "다크모드 토글 버튼 추가",
     "description": "...",
-    "checklist": ["ThemeToggle 컴포넌트 생성", "useTheme hook 구현"],
+    "approach": "localStorage 기반 useTheme hook 확장",
+    "affectedFiles": ["src/hooks/useTheme.ts", "src/components/Header/"],
+    "checklist": ["ThemeToggle 컴포넌트 생성", "useTheme hook 수정", "테스트 작성"],
     "figmaSpec": { "enabled": false, "components": [], "colorTokens": {} }
   }
 }
 ```
 
-상태 기록:
+---
+
+## issueMemory 기록
+
+작업 완료 후:
+
 ```bash
-npx @elyun/bylane state write issue-agent '{"status":"in_progress","startedAt":"'$(date -u +%Y-%m-%dT%H:%M:%SZ)'","progress":0,"retries":0}'
+npx @elyun/bylane memory append ISSUE_NUMBER issue-agent "유형: ISSUE_TYPE
+방향: APPROACH
+관련 파일: AFFECTED_FILES
+특이사항: NOTES"
 ```
 
+`memory.enabled: false`이면 생략.
+
+---
+
 ## 수동 실행
 
 `/bylane issue #123` 또는 `/bylane issue 다크모드 토글 추가해줘`

package/commands/bylane-monitor.md

@@ -1,6 +1,6 @@
 ---
 name: bylane-monitor
-description: byLane 실시간 TUI 모니터 대시보드 실행 안내. Claude가 직접 실행하지 않고 사용자 터미널 명령을 안내한다.
+description: blessed 기반 실시간 TUI 모니터 대시보드 실행 안내. 에이전트 상태, 루프 큐, 로그를 1초 주기로 폴링하여 2열 그리드로 표시한다. 터미널에서 직접 실행해야 하므로 명령만 안내한다.
 ---
 
 # /bylane monitor

package/commands/bylane-notify-agent.md

@@ -1,6 +1,6 @@
 ---
 name: bylane-notify-agent
-description: 워크플로우 완료 또는 개입 필요 시 Slack/Telegram으로 알림을 보낸다.
+description: 워크플로우 완료, 테스트 실패, 리뷰 대기, 개입 필요 등 주요 이벤트 발생 시 설정된 채널(Slack/Telegram)로 알림을 보낸다. bylane.json의 notifications 설정을 따른다.
 ---
 
 # Notify Agent

package/commands/bylane-orchestrator.md

@@ -1,57 +1,95 @@
 ---
 name: bylane-orchestrator
-description: byLane 메인 오케스트레이터. 자연어 의도를 파싱해 에이전트 파이프라인을 실행한다.
+description: byLane 메인 오케스트레이터. 자연어 의도를 파싱하여 4가지 파이프라인(새 기능/기존 이슈/리뷰/단일 에이전트) 중 하나를 선택하고 에이전트 체인을 순차 실행한다.
 ---
 
 # byLane Orchestrator
 
 ## 역할
 
-사용자의 자연어 입력을 파싱하여 어떤 에이전트를 어떤 순서로 실행할지 결정한다.
+사용자 의도를 파싱하고, issue-agent를 통해 전략을 수립한 뒤 에이전트 파이프라인을 실행한다.
 
 ## 실행 전 체크
 
-1. 사전 점검 실행:
+1. 사전 점검:
    ```bash
    npx @elyun/bylane preflight
    ```
-   - 점검 실패 시 안내 메시지를 출력하고 워크플로우를 **중단**한다.
-   - `.bylane/bylane.json` 없으면 즉시 `bylane-setup` 스킬 실행.
+   실패 시 안내 메시지 출력 후 **중단**. `.bylane/bylane.json` 없으면 즉시 `bylane-setup` 스킬 실행.
 
 2. `.bylane/state/` 디렉토리 확인. 없으면 생성.
 
 ## 에이전트별 모델 결정
 
-각 에이전트 실행 전 사용할 모델을 config에서 읽는다:
-
 ```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`
 
-| 패턴 | 실행할 에이전트 체인 |
+### 파이프라인 B — 기존 이슈 구현
+
+**감지 키워드**: `#N`, `이슈 #N`, `issue #N`, `#N 구현`, `#N 작업`, `#N 해줘`, `#N 처리`
+
+**실행 흐름**:
+전략 수립(기존 이슈 분석) → `code-agent` → `test-agent` → `commit-agent` → `pr-agent` → `review-agent` → `notify-agent`
+
+### 파이프라인 C — 리뷰 관련
+
+| 감지 키워드 | 실행 |
 |---|---|
-| "구현", "만들어", "추가해", 이슈 없음 | 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 |
-| "프로젝트 분석", "analyze", "코드스타일 분석", "디자인토큰 분석" | analyze-agent |
+| `PR #N 리뷰`, `리뷰해줘`, `코드 리뷰`, `#N 봐줘` | `review-agent`(PR번호 전달) |
+| `리뷰 반영`, `수락`, `accept`, `LGTM 반영`, `코멘트 반영` | `respond-agent`(모드=accept) |
+| `반박`, `rebut`, `동의 안 해`, `이유 설명`, `왜 이렇게 했냐면` | `respond-agent`(모드=rebut) |
+
+### 파이프라인 D — 단일 에이전트 (오케스트레이터 경유 시)
+
+| 감지 키워드 | 실행 |
+|---|---|
+| `커밋`, `commit`, `커밋해줘`, `변경사항 저장` | `commit-agent` |
+| `PR`, `풀리퀘`, `PR 만들어`, `PR 올려` | `pr-agent` |
+| `테스트`, `test`, `검증`, `시험`, `테스트 돌려` | `test-agent` |
+| `분석`, `analyze`, `구조 파악`, `코드 분석` | `analyze-agent` |
+| `알림`, `notify`, `슬랙`, `텔레그램`, `통보` | `notify-agent` |
+
+### 파이프라인 판단 기준
+
+1. 이슈 번호(`#N`)가 있으면 → **파이프라인 B**
+2. 기능/변경 요청 키워드가 있고 이슈 번호 없으면 → **파이프라인 A**
+3. 리뷰/대응 키워드가 있으면 → **파이프라인 C**
+4. 단일 에이전트 키워드만 있으면 → **파이프라인 D**
+5. 복합 키워드 ("이슈 만들고 구현까지", "테스트하고 커밋") → 파이프라인 A 또는 해당 에이전트 순차 실행
+6. 판단 불가 → 사용자에게 의도 확인
+
+## 전략 수립 단계 (파이프라인 A, B 필수)
+
+파이프라인 C, D (단일 에이전트 요청)가 아닌 경우 반드시 전략 수립 후 진행.
+
+issue-agent를 `model` 파라미터와 함께 호출한다. issue-agent 내부에서 다음을 수행:
+
+1. 코드베이스 병렬 분석 (서브에이전트)
+2. 사용자 문답
+3. 이슈 분류 및 작성
+
+상세 로직은 `bylane-issue-agent` 참조.
 
 ## 에이전트 실행 방법
 
-각 에이전트를 순서대로 Agent 도구로 호출한다. 이전 에이전트의 출력을 다음 에이전트의 입력으로 전달한다.
-**config에서 읽은 모델을 `model` 파라미터로 반드시 전달한다.**
+각 에이전트를 순서대로 Agent 도구로 호출. 이전 출력을 다음 입력으로 전달.
+**config에서 읽은 모델을 `model` 파라미터로 반드시 전달.**
 
 상태 기록 (각 에이전트 시작 전):
 ```bash
@@ -60,17 +98,15 @@ npx @elyun/bylane state write AGENT_NAME '{"status":"in_progress","startedAt":"'
 
 ## 피드백 루프
 
-test-agent가 FAIL을 반환하면:
+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에 "개입 필요" 메시지 전송 후 중단
+2. `retries < config.workflow.maxRetries` → code-agent 재실행 (실패 피드백 포함, retries+1)
+3. `retries >= maxRetries` → notify-agent에 "개입 필요" 메시지 후 중단
 
-respond-agent가 "수정 필요"를 반환하면 동일 로직 적용.
+respond-agent가 "수정 필요" 반환 시 동일 로직 적용.
 
 ## 완료 처리
 
-모든 에이전트 완료 후:
 1. 각 에이전트 state를 `status: "completed"`로 업데이트
 2. notify-agent 실행하여 최종 결과 전송
 

package/commands/bylane-pr-agent.md

@@ -1,6 +1,6 @@
 ---
 name: bylane-pr-agent
-description: 현재 브랜치의 커밋들로 GitHub Pull Request를 생성한다.
+description: 현재 브랜치의 전체 커밋 히스토리를 분석하여 GitHub Pull Request를 생성한다. 제목, 요약, 테스트 계획을 자동 작성하고 팀 모드 시 리뷰어를 할당한다.
 ---
 
 # PR Agent

package/commands/bylane-respond-agent.md

@@ -1,6 +1,6 @@
 ---
 name: bylane-respond-agent
-description: PR 리뷰 코멘트에 반박하거나 코드를 수정하여 반영한다.
+description: PR 리뷰 코멘트를 분석하여 accept(코드 수정 후 재커밋) 또는 rebut(근거를 들어 반박 코멘트 작성) 모드로 대응한다. CHANGES_REQUESTED와 일반 코멘트 모두 처리.
 ---
 
 # Respond Agent

package/commands/bylane-respond-loop.md

@@ -1,6 +1,6 @@
 ---
 name: bylane-respond-loop
-description: 5분 주기로 내 PR에 달린 리뷰/코멘트를 감지하여 자동으로 반박하거나 반영한다.
+description: 백그라운드 폴러가 설정 주기(기본 5분)로 내 PR에 달린 CHANGES_REQUESTED/코멘트를 감지하여 respond-queue에 기록한다. pending 항목 발생 시 respond-agent를 자동 실행하며, 대응 후 새 코멘트 감지 시 재처리한다.
 ---
 
 # Respond Loop Agent
@@ -94,4 +94,4 @@ kill $(pgrep -f respond-loop.js)
 
 ## 수동 실행
 
-`/bylane respond-loop`
+`/bylane-respond-loop`

package/commands/bylane-review-agent.md

@@ -1,6 +1,6 @@
 ---
 name: bylane-review-agent
-description: PR의 diff를 분석하여 코드 라인별 인라인 리뷰 코멘트를 작성한다.
+description: PR의 diff를 파일별로 분석하여 코드 라인별 인라인 리뷰 코멘트를 작성한다. grammar/domain/code/security 4개 검사 범위를 지원하며 심각도(critical/warning/suggestion)를 분류한다.
 ---
 
 # Review Agent

package/commands/bylane-review-loop.md

@@ -1,6 +1,6 @@
 ---
 name: bylane-review-loop
-description: 5분 주기로 GitHub review 요청된 PR을 감지하여 자동으로 리뷰한다. 재요청 포함.
+description: 백그라운드 폴러가 설정 주기(기본 5분)로 GitHub review 요청 PR을 감지하여 review-queue에 기록한다. pending 항목 발생 시 review-agent를 자동 실행하며, 리뷰 후 updatedAt 변경 시 재요청도 처리한다.
 ---
 
 # Review Loop Agent
@@ -109,4 +109,4 @@ kill $(pgrep -f review-loop.js)
 
 ## 수동 실행
 
-`/bylane review-loop`
+`/bylane-review-loop`

package/commands/bylane-setup.md

@@ -1,12 +1,12 @@
 ---
 name: bylane-setup
-description: byLane 하네스 최초 설치 및 설정 위자드. /bylane setup 으로 실행.
+description: byLane 최초 설치 및 설정 위자드. GitHub 접근, 이슈 트래커, 알림 채널, 팀 모드, 권한, 루프 모드, 브랜치 네이밍, 모델을 단계별로 설정하여 .bylane/bylane.json을 생성한다.
 ---
 
 # byLane Setup Wizard
 
 사용자에게 단계별로 질문하여 `.bylane/bylane.json`을 생성한다.
-ALWAYS complete all 6 steps before saving. NEVER skip steps.
+ALWAYS complete all 8 steps before saving. NEVER skip steps.
 
 ## 실행 전 준비
 
@@ -83,7 +83,32 @@ Linear API Key는 환경변수명(`LINEAR_API_KEY`)으로 저장. 실제 키값
 
 `permissions.scope`에 저장.
 
-## Step 5/6 — 고급 설정
+## Step 5/8 — Loop 실행 모드
+
+> Loop 실행 모드를 선택하세요:
+> 1. tmux  — tmux 세션에서 백그라운드 실행 (터미널 종료 후에도 유지, 권장)
+> 2. process — 현재 프로세스에서 직접 실행 (잠자기 모드 대응 포함)
+
+- `1` → `loop.mode = "tmux"`, `loop.sessionName` 입력 (Enter = `bylane-loops`)
+- `2` → `loop.mode = "process"`
+
+tmux 선택 시 `which tmux`로 설치 여부를 자동 확인한다:
+- 설치됨 → `tmux` 모드 확정
+- 미설치 → 안내 후 `process` 모드로 자동 전환:
+  > tmux가 설치되어 있지 않습니다. process 모드로 설정합니다.
+  > tmux 설치: `brew install tmux`
+
+폴링 주기 입력 (Enter = 5분):
+- `loop.intervalMs`에 저장 (밀리초)
+
+loop 시작/종료 명령 안내:
+```
+bylane loop start   # loop 시작
+bylane loop stop    # loop 종료
+bylane loop status  # 상태 확인
+```
+
+## Step 6/8 — 고급 설정
 
 > 고급 설정을 변경하시겠습니까? (Enter = 기본값 사용)
 
@@ -92,7 +117,7 @@ Linear API Key는 환경변수명(`LINEAR_API_KEY`)으로 저장. 실제 키값
 - `loopTimeoutMinutes` (기본: 30): 루프 타임아웃 (분)
 - Figma MCP 활성화? (y/n, 기본: n)
 
-## Step 6/6 — 브랜치 네이밍
+## Step 7/8 — 브랜치 네이밍
 
 > 브랜치 네이밍 패턴을 선택하세요:
 > 1. {tracker}-{issue-number}              예) issues-32
@@ -107,7 +132,7 @@ Linear API Key는 환경변수명(`LINEAR_API_KEY`)으로 저장. 실제 키값
 직접 입력 시 사용 가능한 토큰 목록 안내:
 `{tracker}`, `{type}`, `{issue-number}`, `{custom-id}`, `{title-slug}`, `{date}`, `{username}`
 
-## Step 7/7 — 에이전트 모델 설정
+## Step 8/8 — 에이전트 모델 설정
 
 > 각 에이전트에 사용할 AI 모델을 설정하시겠습니까? (Enter = 기본값 사용)
 
@@ -147,3 +172,9 @@ Linear API Key는 환경변수명(`LINEAR_API_KEY`)으로 저장. 실제 키값
    모니터 대시보드: npm run monitor (byLane 디렉토리에서)
    또는: /bylane monitor
    ```
+5. Loop 실행 안내:
+   ```
+   Loop 시작: npx @elyun/bylane loop start
+   Loop 종료: npx @elyun/bylane loop stop
+   Loop 상태: npx @elyun/bylane loop status
+   ```

package/commands/bylane-test-agent.md

@@ -1,6 +1,6 @@
 ---
 name: bylane-test-agent
-description: 변경된 코드의 테스트를 실행하고 결과를 반환한다.
+description: 변경된 코드의 테스트를 실행하고 PASS/FAIL 결과를 반환한다. FAIL 시 실패 상세(failureDetails)를 state에 기록하여 code-agent 재시도 피드백으로 사용된다.
 ---
 
 # Test Agent