@elyun/bylane 1.22.0 → 1.24.0

package/CLAUDE.md

@@ -21,6 +21,15 @@ node -e "import('./src/state.js').then(({writeState})=>writeState('code-agent',{
 
 # 에이전트별 모델 확인
 node -e "import('./src/config.js').then(({loadConfig,getAgentModel})=>{const c=loadConfig();['orchestrator','code-agent','review-agent'].forEach(a=>console.log(a,getAgentModel(c,a)))})"
+
+# Loop 관리
+npx @elyun/bylane loop start   # review-loop + respond-loop 시작 (tmux 또는 process)
+npx @elyun/bylane loop stop    # loop 종료
+npx @elyun/bylane loop status  # 실행 상태 확인
+
+# issueMemory 확인
+npx @elyun/bylane memory list
+npx @elyun/bylane memory read 123
 ```
 
 ## 아키텍처
@@ -28,9 +37,11 @@ node -e "import('./src/config.js').then(({loadConfig,getAgentModel})=>{const c=l
 - `src/state.js` — `.bylane/state/*.json` 읽기/쓰기 유틸 (writeState, readState, clearState, listStates, appendLog)
 - `src/config.js` — `.bylane/bylane.json` 로드/저장/검증 (loadConfig, saveConfig, validateConfig, getAgentModel, DEFAULT_CONFIG)
 - `src/branch.js` — 브랜치명 패턴 엔진 (buildBranchName, buildBranchNameFromConfig)
-- `src/cli.js` — npx 설치 CLI (install, --symlink 옵션, 기존 파일 .bak 백업)
-- `src/review-loop.js` — 5분 주기 review 요청 PR 폴러 → `.bylane/state/review-queue.json`
-- `src/respond-loop.js` — 5분 주기 내 PR 리뷰/코멘트 폴러 → `.bylane/state/respond-queue.json`
+- `src/memory.js` — 이슈별 컨텍스트 메모리 유틸 (readIssueMemory, appendIssueMemory, listIssueMemories)
+- `src/cli.js` — npx 설치 CLI (install, loop, --symlink 옵션, 기존 파일 .bak 백업)
+- `src/loop-utils.js` — 루프 공통 유틸 (killExistingLoop, tmux 세션 관리, createAbsoluteTimer, resolveLoopMode)
+- `src/review-loop.js` — review 요청 PR 폴러 → `.bylane/state/review-queue.json` (절대시간 기반 폴링)
+- `src/respond-loop.js` — 내 PR 리뷰/코멘트 폴러 → `.bylane/state/respond-queue.json` (절대시간 기반 폴링)
 - `src/monitor/` — blessed 기반 TUI 대시보드 (2열 그리드, 1초 폴링, fullUnicode)
 - `skills/` — Claude Code 에이전트 skill 파일들
 - `hooks/` — 외부 이벤트 자동 감지 훅
@@ -46,12 +57,31 @@ orchestrator → issue-agent → code-agent → test-agent → commit-agent
             → pr-agent → review-agent → respond-agent → notify-agent
 
 analyze-agent (독립: 프로젝트 분석 → .claude/instructions/ 생성)
-review-loop   (독립: 5분 주기 review 요청 감지)
-respond-loop  (독립: 5분 주기 리뷰 코멘트 감지)
+review-loop   (독립: 설정 주기로 review 요청 감지, 절대시간 기반 폴링)
+respond-loop  (독립: 설정 주기로 리뷰 코멘트 감지, 절대시간 기반 폴링)
 ```
 
 각 에이전트는 `.bylane/state/{name}.json`에 상태 기록. 모니터가 1초마다 폴링.
 
+## Loop 실행
+
+`bylane loop start` / `bylane loop stop` / `bylane loop status`
+
+두 가지 모드 (`config.loop.mode`):
+
+| 모드 | 설명 | 해결하는 문제 |
+|------|------|-------------|
+| `tmux` (기본) | tmux 세션에서 백그라운드 실행 | 터미널 종료, SSH 끊김 시 프로세스 유지 |
+| `process` | 현재 프로세스에서 직접 실행 | tmux 미설치 환경 대응 |
+
+두 모드 모두 **절대시간 기반 폴링** 사용:
+- 10초마다 "마지막 폴링 후 intervalMs 경과 여부" 체크
+- macOS 잠자기 모드 동안은 CPU 정지로 실행 불가 (OS 제약)
+- 잠자기 해제 직후 경과 시간 감지 → 즉시 폴링 실행
+- preflight에서 tmux 미설치 감지 시 자동으로 process 모드 fallback
+
+설정: `config.loop.intervalMs` (기본 300000 = 5분), `config.loop.sessionName` (기본 `bylane-loops`)
+
 ## 상태 파일 스키마
 
 ```json
@@ -92,6 +122,8 @@ tests/
 ## 주의사항
 
 - `.bylane/state/`는 .gitignore로 제외됨 (런타임 상태)
+- `.bylane/memory/`는 .gitignore로 제외됨 (issueMemory 로컬 파일)
 - `.bylane/bylane.json`은 추적됨 (프로젝트 설정)
 - `docs/`는 .gitignore로 제외됨 (내부 설계 문서)
 - pre-commit 훅: `npm install` 시 자동 등록 (`prepare` 스크립트)
+- issueMemory: 루프 비활성 시 로컬 파일, 루프 실행 중 GitHub 이슈 코멘트로 기록

package/README.md

@@ -11,6 +11,7 @@ GitHub Issues에서 시작해 코드 구현, 테스트, 커밋, PR 생성, 리
 | 기능 | 설명 |
 |------|------|
 | **전체 워크플로우** | 자연어 한 줄로 이슈 → 코드 → 테스트 → 커밋 → PR 자동화 |
+| **issueMemory** | 이슈별 작업 컨텍스트(아키텍처 결정, 트러블슈팅 등) 자동 기록 및 재활용 |
 | **프로젝트 분석** | 코드 스타일·디자인 토큰·아키텍처 자동 분석, `.claude/instructions/` 생성 |
 | **인라인 코드 리뷰** | 변경 라인마다 개별 코멘트 + GitHub suggestion 블록 자동 등록 |
 | **자동 리뷰 루프** | 5분 주기로 review 요청된 PR을 자동 감지 → 리뷰 실행 |
@@ -64,10 +65,10 @@ node src/cli.js install
 설치 후 Claude Code에서 프로젝트 디렉토리로 이동:
 
 ```
-/bylane setup
+/bylane-setup
 ```
 
-인터랙티브 설정 (GitHub 접근 방법, 알림 채널, 브랜치 패턴, 에이전트 모델 등).
+인터랙티브 설정 (GitHub 접근 방법, 이슈 트래커, 알림 채널, 팀 모드, 권한, 루프 모드, 브랜치 패턴, 에이전트 모델).
 
 ### 사전 점검
 
@@ -80,7 +81,7 @@ npx @elyun/bylane preflight
 또는 Claude Code에서:
 
 ```
-/bylane preflight
+/bylane 점검해줘
 ```
 
 점검 항목: bylane.json 존재, GitHub CLI 로그인, GITHUB_TOKEN, Slack/Telegram 연동 설정.
@@ -101,54 +102,132 @@ npx @elyun/bylane preflight
 
 ## 사용법
 
-### 전체 워크플로우
+### 자연어 워크플로우 (`/bylane`)
 
 ```
 /bylane 다크모드 토글 버튼 추가해줘
 /bylane issue #123 구현해줘
 /bylane PR #45 리뷰해줘
-/bylane 리뷰 #45 반영해줘
+/bylane 리뷰 반영해줘
 ```
 
-### 개별 에이전트 실행
+`/bylane`은 자연어 키워드를 감지하여 적절한 에이전트를 자동 실행합니다.
+서브커맨드 없이 **자연어만** 받습니다.
+
+### 효과적인 지시 방법
+
+byLane은 지시 내용을 바탕으로 코드베이스를 분석하고 사용자와 문답을 거쳐 이슈를 작성합니다.
+지시가 구체적일수록 문답 횟수가 줄고 이슈 품질이 높아집니다.
+
+#### 신규 기능
+
+목적과 UI 힌트를 함께 제공하면 좋습니다:
 
 ```
-/bylane analyze                  프로젝트 분석 → .claude/instructions/ 생성
-/bylane issue [#번호 | 텍스트]   이슈 생성/분석
-/bylane code [#번호]             코드 구현
-/bylane test                     테스트 실행
-/bylane commit                   커밋 생성
-/bylane pr                       PR 생성
-/bylane review [#PR번호] [scope] PR 인라인 리뷰
-/bylane respond [#PR번호] [모드] 리뷰 반박/반영
-/bylane notify                   알림 발송
-/bylane status                   현재 상태 요약
+/bylane 헤더 우측에 다크모드 토글 버튼 추가해줘. 상태는 localStorage에 저장하고 시스템 설정도 따라가게 해줘.
 ```
 
-### 자동 루프
+Figma 링크가 있으면 포함하세요:
 
-두 루프를 동시에 실행하면 리뷰 요청과 리뷰 대응을 완전 자동화합니다:
+```
+/bylane 결제 흐름 추가해줘. 디자인은 https://figma.com/... 참고해줘.
+```
 
-```bash
-node src/review-loop.js &   # 내게 요청된 PR 자동 리뷰 (5분 주기)
-node src/respond-loop.js &  # 내 PR 리뷰 자동 대응 (5분 주기)
+#### 버그 수정
+
+재현 조건과 기대 동작을 함께 적으면 분석 범위가 좁아집니다:
+
+```
+/bylane 로그인 후 새로고침하면 세션이 풀리는 버그 수정해줘. 토큰 갱신 로직 쪽 문제인 것 같아.
+```
+
+#### 기존 기능 개선
+
+현재 상태의 어느 부분이 문제인지 지적하면 최소 변경으로 진행됩니다:
+
+```
+/bylane 상품 목록 API 호출이 매번 발생해서 느린데, 캐싱 넣어줘. SWR 이미 쓰고 있어.
 ```
 
-루프 종료:
+#### 이슈 번호로 구현
+
+이미 작성된 이슈를 그대로 구현할 때:
+
+```
+/bylane issue #42 구현해줘
+```
+
+issue-agent가 이슈 본문의 "구현 방향"과 "관련 파일" 섹션을 읽어 code-agent에 전달합니다.
+이슈 본문에 배경, 접근 방법, 영향 범위가 잘 정리되어 있을수록 추가 문답 없이 바로 구현합니다.
+
+#### 피해야 할 패턴
+
+| 지시 | 문제 | 개선 |
+|------|------|------|
+| `/bylane 버그 고쳐줘` | 어떤 버그인지 불명확 → 문답 증가 | `/bylane 장바구니 수량 변경 시 합계가 안 바뀌는 버그 수정해줘` |
+| `/bylane 리팩토링해줘` | 범위 불명확 → 전체 분석 필요 | `/bylane useCart hook이 너무 커서 상태 관리 부분만 분리해줘` |
+| `/bylane 성능 개선` | 측정 기준 없음 | `/bylane 홈 화면 LCP가 4초 넘는데 이미지 lazy loading 추가해줘` |
+
+### 개별 에이전트 직접 실행 (`/bylane-*`)
+
+개별 에이전트를 직접 실행하려면 `/bylane-*` 커맨드를 사용합니다:
+
+| 커맨드 | 설명 |
+|---|---|
+| `/bylane-setup` | GitHub 접근, 알림, 팀 모드, 루프, 브랜치, 모델 설정 위자드 |
+| `/bylane-monitor` | TUI 대시보드 실행 안내 (에이전트 상태/큐/로그 실시간 표시) |
+| `/bylane-cleanup` | 파일 권한 수정, 죽은 PID 정리, 큐 복구 일괄 실행 |
+| `/bylane-analyze-agent` | 코드 스타일/디자인 토큰/아키텍처 분석 → `.claude/instructions/` 생성 |
+| `/bylane-issue-agent` | 코드베이스 분석 + 문답 → 전략 스펙 포함 GitHub 이슈 작성 |
+| `/bylane-code-agent` | 이슈 전략 스펙 기반 브랜치 생성 + 코드 구현 |
+| `/bylane-test-agent` | 테스트 실행, FAIL 시 상세 기록으로 재시도 피드백 제공 |
+| `/bylane-commit-agent` | conventional commit 메시지 자동 생성 + 커밋 |
+| `/bylane-pr-agent` | 커밋 히스토리 분석 → PR 제목/요약/테스트 계획 자동 작성 |
+| `/bylane-review-agent` | PR diff 라인별 인라인 리뷰 (grammar/domain/code/security) |
+| `/bylane-respond-agent` | 리뷰 코멘트 accept(수정 반영) 또는 rebut(반박) 대응 |
+| `/bylane-review-loop` | 설정 주기로 review 요청 PR 감지 → 자동 리뷰 실행 |
+| `/bylane-respond-loop` | 설정 주기로 내 PR 리뷰/코멘트 감지 → 자동 대응 실행 |
+| `/bylane-notify-agent` | Slack/Telegram 알림 발송 |
+
+### 자동 루프
+
+두 루프를 동시에 실행하면 리뷰 요청과 리뷰 대응을 완전 자동화합니다.
+
+#### CLI로 루프 관리 (권장)
 
 ```bash
-kill $(pgrep -f review-loop.js)
-kill $(pgrep -f respond-loop.js)
-# 또는 모니터에서 [s]
+npx @elyun/bylane loop start   # review-loop + respond-loop 동시 시작 (tmux 또는 process)
+npx @elyun/bylane loop stop    # 루프 종료
+npx @elyun/bylane loop status  # 실행 상태 확인
 ```
 
-Claude Code에서 실행:
+두 가지 실행 모드 (`/bylane-setup`에서 설정):
+
+| 모드 | 설명 |
+|------|------|
+| `tmux` (기본) | tmux 세션에서 백그라운드 실행. 터미널 종료/SSH 끊김 시에도 유지 |
+| `process` | 현재 프로세스에서 직접 실행. tmux 미설치 시 자동 fallback |
+
+두 모드 모두 **절대시간 기반 폴링**을 사용합니다:
+- macOS 잠자기 모드 해제 직후 경과 시간 감지 → 즉시 폴링 실행
+- 잠자기 중에는 CPU 정지로 실행 불가 (OS 제약)
+
+#### Claude Code에서 실행
 
 ```
-/bylane review-loop     자동 리뷰 루프 시작 (검사 범위 선택 후 시작)
-/bylane respond-loop    자동 대응 루프 시작
+/bylane-review-loop     자동 리뷰 루프 시작 (검사 범위 선택 후 시작)
+/bylane-respond-loop    자동 대응 루프 시작
+```
+
+#### 수동 실행
+
+```bash
+node src/review-loop.js &   # 내게 요청된 PR 자동 리뷰
+node src/respond-loop.js &  # 내 PR 리뷰 자동 대응
 ```
 
+루프 종료: 모니터에서 `[s]` 키, 또는 `npx @elyun/bylane loop stop`
+
 ---
 
 ## 모니터 대시보드
@@ -210,7 +289,7 @@ npx @elyun/bylane monitor
 
 인자로도 지정 가능:
 ```
-/bylane review #45 code,security
+/bylane PR #45 code,security만 리뷰해줘
 ```
 
 ### 인라인 코멘트
@@ -251,9 +330,9 @@ docs/REVIEW_TEMPLATE.md
 | `manual` | 코멘트별로 수정/반박/건너뜀 직접 선택 |
 
 ```
-/bylane respond #45           auto 모드 (기본)
-/bylane respond #45 manual    코멘트별 수동 선택
-/bylane respond #45 accept    전체 반영
+/bylane #45 리뷰 대응해줘            auto 모드 (기본)
+/bylane #45 리뷰 코멘트별로 보여줘    manual 모드
+/bylane #45 리뷰 전부 반영해줘       accept 모드
 ```
 
 auto 모드에서는 실행 전 요약을 먼저 보여주고 확인을 받습니다:
@@ -266,9 +345,51 @@ auto 모드에서는 실행 전 요약을 먼저 보여주고 확인을 받습
 
 ---
 
+## issueMemory
+
+이슈 단위로 작업 컨텍스트를 자동으로 기록하고, 다음 세션에서 재활용합니다.
+
+### 동작 방식
+
+- **루프 비활성 시** — `.bylane/memory/issues/{이슈번호}.md` 로컬 파일에 기록
+- **루프 실행 중** — GitHub 이슈 코멘트로 기록 (팀 전체가 볼 수 있도록)
+
+기록 내용: 작업 요약, 변경 파일, 아키텍처 결정, 트러블슈팅 내역
+
+### 자동 기록
+
+issue-agent와 code-agent가 작업 완료 후 자동으로 기록합니다. 별도 설정 불필요.
+
+code-agent는 작업 시작 시 이전 세션의 메모리를 불러와 일관된 아키텍처 결정을 유지합니다.
+
+### 수동 사용
+
+```bash
+npx @elyun/bylane memory read 123       # 이슈 #123 메모리 조회
+npx @elyun/bylane memory list           # 메모리가 있는 이슈 목록
+npx @elyun/bylane memory append 123 code-agent "메모 내용"  # 직접 추가
+```
+
+### 설정
+
+`.bylane/bylane.json`:
+
+```json
+{
+  "memory": {
+    "enabled": true,
+    "dir": ".bylane/memory"
+  }
+}
+```
+
+`enabled: false`로 비활성화할 수 있습니다.
+
+---
+
 ## 프로젝트 분석
 
-`/bylane analyze` 실행 시 현재 프로젝트를 자동 분석하여 Claude Code가 참조할 instruction 파일을 생성합니다.
+`/bylane-analyze-agent` (또는 `/bylane 프로젝트 분석해줘`) 실행 시 현재 프로젝트를 자동 분석하여 Claude Code가 참조할 instruction 파일을 생성합니다.
 
 | 파일 | 내용 |
 |------|------|
@@ -279,8 +400,8 @@ auto 모드에서는 실행 전 요약을 먼저 보여주고 확인을 받습
 ESLint/Prettier/tsconfig, Tailwind config, CSS 변수 등 설정 파일을 자동 탐색하고 실제 소스 패턴을 샘플링합니다. 분석 후 `CLAUDE.md`에 import 구문을 자동 추가합니다.
 
 ```
-/bylane analyze          기존 파일 있으면 확인 요청
-/bylane analyze --force  강제 덮어쓰기
+/bylane-analyze-agent              기존 파일 있으면 확인 요청
+/bylane 프로젝트 분석 강제로 해줘   강제 덮어쓰기
 ```
 
 ---
@@ -355,6 +476,10 @@ respond-loop    독립: 5분 주기 리뷰 코멘트 감지
     "templateFile": "",
     "footer": "{model} · {date}"
   },
+  "memory": {
+    "enabled": true,
+    "dir": ".bylane/memory"
+  },
   "extensions": {
     "figma": { "enabled": false, "useAt": "issue-analysis" }
   }
@@ -394,7 +519,7 @@ npx @elyun/bylane   # 재설치/업데이트
 
 ### 루프 중복 실행
 
-review-loop / respond-loop는 PID를 상태 파일에 기록합니다. 모니터의 `[s]` 키 또는 `pgrep`으로 확인 후 종료하세요.
+review-loop / respond-loop는 PID를 상태 파일에 기록합니다. `npx @elyun/bylane loop status`로 상태를 확인하고, `npx @elyun/bylane loop stop` 또는 모니터 `[s]` 키로 종료하세요.
 
 ### GitHub MCP vs CLI
 

package/commands/bylane-analyze-agent.md

@@ -1,6 +1,6 @@
 ---
 name: bylane-analyze-agent
-description: 현재 프로젝트를 분석하여 코드 스타일, 디자인 토큰, 아키텍처, 폴더 구조를 `.claude/instructions/` 하위에 instruction 파일로 저장하고 CLAUDE.md에 import를 추가한다.
+description: 프로젝트의 코드 스타일, 디자인 토큰, 아키텍처, 폴더 구조, 의존성을 병렬 분석하여 .claude/instructions/ 하위에 instruction 파일로 저장한다. CLAUDE.md에 import를 자동 추가하여 이후 에이전트가 프로젝트 컨텍스트를 활용할 수 있게 한다.
 ---
 
 # Analyze Agent

package/commands/bylane-cleanup.md

@@ -1,6 +1,6 @@
 ---
 name: bylane-cleanup
-description: 상태 파일 권한 수정, 좀비 에이전트/루프 초기화, 큐 복구를 한 번에 실행한다.
+description: .bylane/state/ 파일 권한 수정(755/644), 죽은 루프 PID 정리, 30분 초과 in_progress→failed 전환, reviewing/responding→pending 큐 복구를 한 번에 실행한다.
 ---
 
 # /bylane cleanup

package/commands/bylane-code-agent.md

@@ -1,13 +1,38 @@
 ---
 name: bylane-code-agent
-description: issue-agent의 스펙을 기반으로 프론트엔드 코드를 구현한다.
+description: issue-agent가 작성한 전략 스펙(이슈 본문)을 기반으로 브랜치를 생성하고 코드를 구현한다. issueMemory에 진행 상황을 기록하며, 실패 시 피드백 루프로 재시도한다.
 ---
 
 # Code Agent
 
-## 입력
+## 입력 읽기
 
-`.bylane/state/issue-agent.json`에서 `spec` 읽기. 없으면 사용자에게 스펙 텍스트 직접 입력 요청.
+### 1. issue-agent 상태에서 spec 로드
+
+`.bylane/state/issue-agent.json`에서 다음 필드를 읽는다:
+
+| 필드 | 용도 |
+|------|------|
+| `spec.title` | 작업 제목 |
+| `spec.approach` | 채택된 구현 방향 |
+| `spec.affectedFiles` | 수정/추가할 파일 목록 |
+| `spec.checklist` | 구현 체크리스트 |
+| `spec.figmaSpec` | Figma 컬러토큰·컴포넌트 구조 |
+| `issueType` | `new-feature` / `bug` / `improvement` / `chore` |
+
+없으면 GitHub 이슈 본문을 직접 로드하여 "구현 방향", "관련 파일 및 영향 범위", "구현 체크리스트" 섹션을 파싱한다.
+
+### 2. issueMemory 로드
+
+이슈 번호를 알고 있으면 이전 세션 컨텍스트를 확인한다:
+
+```bash
+npx @elyun/bylane memory read ISSUE_NUMBER
+```
+
+아키텍처 결정이나 트러블슈팅 기록이 있으면 구현에 반영한다.
+
+---
 
 ## 실행 전 상태 기록
 
@@ -15,30 +40,69 @@ description: issue-agent의 스펙을 기반으로 프론트엔드 코드를 구
 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. `.bylane/state/issue-agent.json` 로드하여 `spec` 추출
-2. `spec.checklist` 항목을 순서대로 구현
-3. Figma 스펙이 있으면 (`spec.figmaSpec.enabled === true`):
-   - `colorTokens`를 CSS 변수 또는 Tailwind config 값으로 변환
-   - 컴포넌트 구조를 Figma 계층에 맞게 구현
-4. 기존 코드베이스 패턴 파악 후 동일 스타일로 작성 (TypeScript, 테스트 파일 위치 등)
-5. 각 파일 구현 후 `appendLog` 호출:
+### issueType별 접근 전략
+
+#### `new-feature`
+- `spec.affectedFiles`의 신규 파일부터 생성
+- 유사 구현 패턴(이슈 본문 "코드 패턴 참고" 섹션) 따르기
+- Figma 스펙이 있으면 컬러토큰 → CSS 변수/Tailwind config 변환
+
+#### `bug`
+- 이슈 본문의 "문제 지점" 파일부터 열기
+- 원인 파악 후 최소 변경으로 수정
+- 재현 케이스를 테스트로 먼저 작성 (TDD)
+
+#### `improvement`
+- 기존 구현 파악 후 변경 범위 최소화
+- 사이드 이펙트 발생 가능 파일은 이슈 본문 "영향 범위" 기준으로 확인
+
+#### `chore`
+- 기능 변경 없음 확인 후 진행
+- 설정 파일 변경 시 기존 동작 보존 여부 체크
+
+### 구현 순서
+
+1. `spec.checklist` 항목을 순서대로 처리
+2. 각 파일 구현 완료 시 상태 로그 기록:
    ```bash
    npx @elyun/bylane state append code-agent "FILENAME 구현 완료"
    ```
-6. 구현 완료 후 상태 업데이트:
-   ```bash
-   npx @elyun/bylane state write code-agent '{"status":"completed","progress":100,"currentTask":"구현 완료","retries":0,"changedFiles":CHANGED_FILES_ARRAY}'
-   ```
+3. 코드베이스 기존 패턴과 동일한 스타일 유지 (TypeScript, 테스트 위치, import 방식 등)
 
-## 코딩 원칙
+### 코딩 원칙
 
 - 함수형 컴포넌트 + hooks 우선
 - 파일당 단일 책임
 - 200줄 초과 시 분리 고려
 - 불변성 패턴 유지 (객체 직접 수정 금지)
 
+---
+
+## 완료 처리
+
+```bash
+npx @elyun/bylane state write code-agent '{"status":"completed","progress":100,"currentTask":"구현 완료","retries":0,"changedFiles":CHANGED_FILES_ARRAY}'
+```
+
+---
+
+## issueMemory 기록
+
+```bash
+npx @elyun/bylane memory append ISSUE_NUMBER code-agent "구현 요약: SUMMARY
+변경 파일: CHANGED_FILES
+아키텍처 결정: DECISIONS
+트러블슈팅: ISSUES_FACED"
+```
+
+`memory.enabled: false`이면 생략.
+
+---
+
 ## 출력
 
 `.bylane/state/code-agent.json`의 `changedFiles`: 변경된 파일 경로 배열

package/commands/bylane-commit-agent.md

@@ -1,6 +1,6 @@
 ---
 name: bylane-commit-agent
-description: 변경된 파일들을 conventional commit 형식으로 커밋한다.
+description: 변경된 파일들을 분석하여 conventional commit(feat/fix/refactor 등) 형식의 메시지를 자동 생성하고 커밋한다. 시크릿 파일은 자동 제외.
 ---
 
 # Commit Agent