npm - @elyun/bylane - Versions diffs - 1.5.0 → 1.7.0 - Mend

@elyun/bylane 1.5.0 → 1.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (7) hide show

package/CLAUDE.md CHANGED Viewed

@@ -10,34 +10,43 @@ byLane — Claude Code용 프론트엔드 개발 자동화 하네스.
 ## 커맨드
 ```bash
-# 의존성 설치
-npm install
-# 전체 테스트 실행
-npm test
-# 모니터 대시보드 실행
-npm run monitor
+npm install          # 의존성 설치 + pre-commit 훅 자동 등록 (prepare 스크립트)
+npm test             # 테스트 실행 (19개)
+npm run monitor      # 모니터 대시보드
+npm version minor    # 마이너 버전 올리기 (커밋 + 태그 자동 생성)
+npm run release      # npm 배포 (커밋/푸시 완료 후 실행)
 # 테스트용 더미 상태 생성
 node -e "import('./src/state.js').then(({writeState})=>writeState('code-agent',{status:'in_progress',progress:50,retries:0,startedAt:new Date().toISOString(),log:[]}))"
+# 에이전트별 모델 확인
+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)))})"
 ```
 ## 아키텍처
 - `src/state.js` — `.bylane/state/*.json` 읽기/쓰기 유틸 (writeState, readState, clearState, listStates, appendLog)
-- `src/config.js` — `.bylane/bylane.json` 로드/저장/검증 (loadConfig, saveConfig, validateConfig, DEFAULT_CONFIG)
+- `src/config.js` — `.bylane/bylane.json` 로드/저장/검증 (loadConfig, saveConfig, validateConfig, getAgentModel, DEFAULT_CONFIG)
 - `src/branch.js` — 브랜치명 패턴 엔진 (buildBranchName, buildBranchNameFromConfig)
-- `src/monitor/` — blessed 기반 TUI 대시보드 (2열 그리드, 1초 폴링)
+- `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/monitor/` — blessed 기반 TUI 대시보드 (2열 그리드, 1초 폴링, fullUnicode)
 - `skills/` — Claude Code 에이전트 skill 파일들
 - `hooks/` — 외부 이벤트 자동 감지 훅
 - `commands/` — `/bylane` 슬래시 커맨드 정의
+- `templates/review-template.md` — 리뷰 코멘트 기본 템플릿
+- `scripts/release.sh` — npm 배포 스크립트 (dirty 체크 + 테스트 + publish)
+- `.githooks/pre-commit` — 보안 검사 훅 (시크릿/민감파일/console.log)
 ## 에이전트 파이프라인
 ```
 orchestrator → issue-agent → code-agent → test-agent → commit-agent
             → pr-agent → review-agent → respond-agent → notify-agent
+review-loop   (독립: 5분 주기 review 요청 감지)
+respond-loop  (독립: 5분 주기 리뷰 코멘트 감지)
 ```
 각 에이전트는 `.bylane/state/{name}.json`에 상태 기록. 모니터가 1초마다 폴링.
@@ -55,13 +64,20 @@ orchestrator → issue-agent → code-agent → test-agent → commit-agent
 }
 ```
+## GitHub 접근 방법
+`github.method`: `"auto"` (기본, MCP→CLI→API 순) | `"mcp"` | `"cli"` | `"api"`
+## 에이전트 모델 설정
+`config.models` 객체에서 에이전트별 모델 지정. `getAgentModel(config, agentName)`으로 조회.
+기본값: orchestrator/issue-agent/respond-agent → opus-4-6, code-agent/review-agent → sonnet-4-6, 나머지 → haiku-4-5.
 ## 브랜치 네이밍 토큰
 `{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`
+빈 토큰은 자동 제외: `{type}/{issue-number}` + type 없음 → `32-add-dark-mode`
 ## 테스트 구조
@@ -69,5 +85,12 @@ orchestrator → issue-agent → code-agent → test-agent → commit-agent
 tests/
 ├── state.test.js   — writeState, readState, clearState, listStates, appendLog
 ├── config.test.js  — loadConfig, saveConfig, validateConfig, DEFAULT_CONFIG
-└── branch.test.js  — buildBranchName (5개 패턴 케이스)
+└── branch.test.js  — buildBranchName (6개 패턴 케이스, 슬래시 엣지케이스 포함)
 ```
+## 주의사항
+- `.bylane/state/`는 .gitignore로 제외됨 (런타임 상태)
+- `.bylane/bylane.json`은 추적됨 (프로젝트 설정)
+- `docs/`는 .gitignore로 제외됨 (내부 설계 문서)
+- pre-commit 훅: `npm install` 시 자동 등록 (`prepare` 스크립트)

package/README.md CHANGED Viewed

@@ -6,18 +6,25 @@ GitHub Issues에서 시작해 코드 구현, 테스트, 커밋, PR 생성, 리
 ## 특징
+- **프로젝트 분석** — 코드 스타일·디자인 토큰·아키텍처를 자동 분석해 `.claude/instructions/`에 저장, CLAUDE.md에 자동 import
 - **전체 워크플로우 자동화** — `/bylane 다크모드 토글 추가해줘` 한 줄로 이슈 생성부터 PR까지
 - **개별 실행 가능** — 각 에이전트를 단독으로 실행 가능
 - **실시간 모니터링** — 2열 그리드 터미널 TUI 대시보드
+- **자동 리뷰 루프** — 5분 주기로 review 요청 PR 자동 리뷰
+- **자동 대응 루프** — 5분 주기로 내 PR 리뷰/코멘트 자동 대응 (accept/rebut)
 - **피드백 루프** — 테스트 실패 시 자동 재시도 (설정 가능)
+- **GitHub 접근 방법** — MCP / CLI(`gh`) / REST API 자동 감지
+- **리뷰 템플릿** — 코드 예시, 모델 명시, 커스텀 푸터 설정 가능
+- **에이전트별 모델 설정** — 에이전트마다 다른 AI 모델 지정 가능
 - **Figma MCP 연동** — 이슈의 Figma 링크에서 스펙 자동 추출 (선택적)
 - **Slack / Telegram 알림** — 완료 또는 개입 필요 시 알림
+- **pre-commit 보안 훅** — 시크릿/민감 파일/console.log 자동 검사
 ## 요구사항
 - [Claude Code](https://claude.ai/code) CLI
 - Node.js 20+
-- GitHub MCP (Claude Code 기본 제공)
+- GitHub MCP (Claude Code 기본 제공), `gh` CLI, 또는 `GITHUB_TOKEN` 중 하나
 - Slack MCP / Telegram (알림 사용 시)
 - Figma MCP (디자인 연동 사용 시)
@@ -26,15 +33,16 @@ GitHub Issues에서 시작해 코드 구현, 테스트, 커밋, PR 생성, 리
 ### npx로 설치 (권장)
 ```bash
-npx bylane
+npx @elyun/bylane
 ```
 Skills, Commands, Hooks 파일을 `~/.claude/` 하위 디렉토리에 자동으로 복사합니다.
+기존 파일이 있으면 `.bak`으로 백업 후 교체합니다.
 심볼릭 링크로 설치하면 레포 업데이트 시 자동으로 반영됩니다:
 ```bash
-npx bylane --symlink
+npx @elyun/bylane --symlink
 ```
 ### 수동 설치
@@ -42,7 +50,7 @@ npx bylane --symlink
 ```bash
 git clone https://github.com/el-yun/byLane.git
 cd byLane
-npm install
+npm install   # pre-commit 보안 훅 자동 등록
 node src/cli.js install
 ```
@@ -54,13 +62,15 @@ Claude Code를 열고 프로젝트 디렉토리에서:
 /bylane setup
 ```
-6단계 인터랙티브 설정:
-1. 이슈 트래커 (GitHub Issues / Linear / 둘 다)
-2. 알림 채널 (Slack / Telegram / 둘 다)
-3. 팀 모드 설정
-4. 권한 범위 (read-only / write / full)
-5. 고급 설정 (재시도 횟수, 타임아웃, Figma MCP)
-6. 브랜치 네이밍 패턴
+7단계 인터랙티브 설정:
+1. GitHub 접근 방법 (MCP / CLI / API / auto)
+2. 이슈 트래커 (GitHub Issues / Linear / 둘 다)
+3. 알림 채널 (Slack / Telegram / 둘 다)
+4. 팀 모드 설정
+5. 권한 범위 (read-only / write / full)
+6. 고급 설정 (재시도 횟수, 타임아웃, Figma MCP)
+7. 브랜치 네이밍 패턴
+8. 에이전트별 AI 모델
 ## 사용법
@@ -78,17 +88,29 @@ Claude Code를 열고 프로젝트 디렉토리에서:
 ### 개별 에이전트 실행
 ```
+/bylane analyze                  프로젝트 분석 → .claude/instructions/ 생성
 /bylane issue [#번호 | 텍스트]   이슈 생성/분석
 /bylane code [#번호]             코드 구현
 /bylane test                     테스트 실행
 /bylane commit                   커밋 생성
 /bylane pr                       PR 생성
 /bylane review [PR번호]          PR 리뷰
+/bylane review-loop              5분 주기 자동 리뷰 루프
 /bylane respond [PR번호]         리뷰 반박/반영
+/bylane respond-loop             5분 주기 자동 대응 루프
 /bylane notify                   알림 발송
 /bylane status                   현재 상태 요약
 ```
+### 자동 루프
+두 루프를 동시에 실행하면 review 요청과 리뷰 대응을 모두 자동화합니다:
+```bash
+node src/review-loop.js &   # 내게 요청된 PR 자동 리뷰
+node src/respond-loop.js &  # 내 PR 리뷰 자동 대응
+```
 ### 모니터 대시보드
 ```bash
@@ -98,26 +120,48 @@ npm run 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]일시정지  [↑↓]로그스크롤
++---------------------------+--------------------------------------+
+|  AGENT PIPELINE           |  AGENT LOG                 [LIVE]  |
+|                           |                                     |
+|  issue-agent  [v] 완료   |  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    OK 연결됨                |
+|  2  PR #45  review        |  Slack     OK #dev-alerts           |
++---------------------------+--------------------------------------+
 ```
-## 브랜치 네이밍 패턴
+## 프로젝트 분석 (analyze)
+`/bylane analyze`를 실행하면 현재 프로젝트를 자동 분석하여 Claude Code가 참조할 수 있는 instruction 파일을 생성합니다.
+### 생성되는 파일
+| 파일 | 내용 |
+|---|---|
+| `.claude/instructions/code-style.md` | 언어, 포맷팅, 네이밍 컨벤션, import 규칙, 금지 패턴 |
+| `.claude/instructions/design-tokens.md` | 색상 팔레트, 타이포그래피, 간격, 브레이크포인트, 다크모드 |
+| `.claude/instructions/architecture.md` | 프레임워크, 렌더링 전략, 상태관리, 데이터 페칭, 폴더 구조 |
+### 동작 방식
+1. ESLint/Prettier/tsconfig, Tailwind config, CSS 변수, package.json 등 설정 파일을 자동 탐색
+2. 소스 파일을 샘플링하여 실제 사용 패턴 파악
+3. 분석 결과를 `.claude/instructions/`에 Markdown 파일로 저장
+4. `CLAUDE.md`에 `@.claude/instructions/*.md` import 구문 자동 추가
+   - `CLAUDE.md`가 없으면 `/init`으로 먼저 생성
+```
+/bylane analyze          # 분석 후 파일 생성 (기존 파일 확인 요청)
+/bylane analyze --force  # 기존 instruction 파일 강제 덮어쓰기
+```
-셋업 시 패턴을 정의하거나 `.bylane/bylane.json`에서 직접 설정:
+커스텀 내용은 `.claude/instructions/structure.md`를 직접 작성하고 CLAUDE.md에 `@.claude/instructions/structure.md`를 추가하면 재분석 시에도 유지됩니다.
+## 브랜치 네이밍 패턴
 | 패턴 | 예시 |
 |---|---|
@@ -134,6 +178,11 @@ npm run monitor
 ```json
 {
   "version": "1.0",
+  "github": {
+    "method": "auto",
+    "owner": "",
+    "repo": ""
+  },
   "trackers": {
     "primary": "github",
     "linear": { "enabled": false, "apiKey": "" }
@@ -152,6 +201,26 @@ npm run monitor
     "tokens": { "tracker": "issues", "type": "feature", "custom-id": "" },
     "caseStyle": "kebab-case"
   },
+  "models": {
+    "default": "claude-sonnet-4-6",
+    "orchestrator": "claude-opus-4-6",
+    "issue-agent": "claude-opus-4-6",
+    "code-agent": "claude-sonnet-4-6",
+    "review-agent": "claude-sonnet-4-6",
+    "respond-agent": "claude-opus-4-6",
+    "test-agent": "claude-haiku-4-5-20251001",
+    "commit-agent": "claude-haiku-4-5-20251001",
+    "pr-agent": "claude-haiku-4-5-20251001",
+    "notify-agent": "claude-haiku-4-5-20251001"
+  },
+  "review": {
+    "model": "claude-sonnet-4-6",
+    "language": "ko",
+    "includeModel": true,
+    "includeCodeExample": true,
+    "templateFile": "",
+    "footer": "Reviewed by byLane · model: {model}"
+  },
   "extensions": {
     "figma": { "enabled": false, "useAt": "issue-analysis" }
   }
@@ -170,15 +239,50 @@ orchestrator
   → review-agent   (자동 리뷰)
   → respond-agent  (리뷰 반박 또는 반영)
   → notify-agent   (Slack/Telegram 알림)
+review-loop   (독립 실행: 5분 주기 리뷰 요청 감지)
+respond-loop  (독립 실행: 5분 주기 리뷰 코멘트 감지)
 ```
-각 에이전트는 수동 단독 실행 가능하며, 타인의 PR/리뷰에도 대응합니다.
+## GitHub 접근 방법
+`github.method` 설정으로 제어:
+| 값 | 동작 |
+|----|------|
+| `"auto"` (기본) | MCP → CLI → API 순서로 자동 시도 |
+| `"mcp"` | GitHub MCP 도구만 사용 |
+| `"cli"` | `gh` CLI만 사용 |
+| `"api"` | REST API + `$GITHUB_TOKEN`만 사용 |
+## 리뷰 템플릿
+`templates/review-template.md`를 복사해 커스터마이즈한 뒤 `review.templateFile`에 경로를 지정합니다.
+기본 구성: 심각도 레이블 (CRITICAL/HIGH/MEDIUM/LOW), Before/After 코드 예시, 사용 모델 명시, 커스텀 푸터.
+## 보안
+`npm install` 시 pre-commit 훅이 자동 등록됩니다. 커밋마다 아래를 검사합니다:
+| 항목 | 심각도 |
+|------|--------|
+| AWS/OpenAI/GitHub/Slack/Google 키 패턴 | CRITICAL (차단) |
+| `.env`, `.pem`, `credentials` 등 민감 파일 | CRITICAL (차단) |
+| 하드코딩된 password/api_key | CRITICAL (차단) |
+| `node_modules` 실수 커밋 | CRITICAL (차단) |
+| `console.log` | WARN (경고만) |
+우회: `git commit --no-verify`
 ## 개발
 ```bash
-npm test        # 테스트 실행 (19개)
-npm run monitor # 모니터 대시보드
+npm install          # 의존성 설치 + pre-commit 훅 등록
+npm test             # 테스트 실행 (19개)
+npm run monitor      # 모니터 대시보드
+npm version minor    # 버전 올리기
+npm run release      # npm 배포 (커밋/푸시 후 실행)
 ```
 ## 라이선스

package/commands/bylane.md CHANGED Viewed

@@ -10,6 +10,7 @@ description: byLane 메인 커맨드. 자연어로 전체 개발 워크플로우
 ```
 /bylane [자연어 명령]   — 전체 워크플로우 자동 실행
 /bylane setup          — 셋업 위자드 (재실행 가능)
+/bylane analyze        — 프로젝트 분석 후 .claude/instructions/ 에 instruction 파일 생성
 /bylane monitor        — 실시간 TUI 대시보드
 /bylane issue [#번호 | 텍스트]
 /bylane code [#번호]
@@ -39,6 +40,7 @@ description: byLane 메인 커맨드. 자연어로 전체 개발 워크플로우
 | `commit` | `bylane-commit-agent` |
 | `pr` | `bylane-pr-agent` |
 | `review` | `bylane-review-agent` |
+| `analyze` | `bylane-analyze-agent` |
 | `review-loop` | `bylane-review-loop` |
 | `respond` | `bylane-respond-agent` |
 | `respond-loop` | `bylane-respond-loop` |

package/package.json CHANGED Viewed

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

package/skills/analyze-agent.md ADDED Viewed

@@ -0,0 +1,368 @@
+---
+name: bylane-analyze-agent
+description: 현재 프로젝트를 분석하여 코드 스타일, 디자인 토큰, 아키텍처, 폴더 구조를 `.claude/instructions/` 하위에 instruction 파일로 저장하고 CLAUDE.md에 import를 추가한다.
+---
+# Analyze Agent
+프로젝트의 코드 스타일, 디자인 토큰, 아키텍처, 폴더 구조를 분석하여
+Claude Code가 해당 프로젝트의 컨텍스트를 이해할 수 있는 instruction 파일을 생성한다.
+**사용 모델: `claude-opus-4-6`** — 정확한 패턴 추론을 위해 Opus를 사용한다.
+orchestrator에서 이 에이전트를 호출할 때 `model: "claude-opus-4-6"`을 전달한다.
+## 실행 전 상태 기록
+```bash
+node -e "
+import('PATH_TO_BYLANE/src/state.js').then(({writeState}) => {
+  writeState('analyze-agent', {
+    status: 'in_progress',
+    startedAt: new Date().toISOString(),
+    progress: 0,
+    currentTask: '프로젝트 분석 시작',
+    retries: 0,
+    log: []
+  })
+})
+"
+```
+## Step 1 — 분석 대상 파일 수집
+다음 파일들을 읽어 분석 데이터를 수집한다:
+### 코드 스타일 관련
+```bash
+# ESLint
+cat .eslintrc* eslint.config* .eslintignore 2>/dev/null
+# Prettier
+cat .prettierrc* prettier.config* 2>/dev/null
+# TypeScript
+cat tsconfig*.json 2>/dev/null
+# Stylelint
+cat .stylelintrc* 2>/dev/null
+# EditorConfig
+cat .editorconfig 2>/dev/null
+# 실제 소스 파일 샘플 (패턴 파악용)
+find src -name "*.ts" -o -name "*.tsx" -o -name "*.js" -o -name "*.jsx" 2>/dev/null | head -20
+```
+### 디자인 토큰 관련
+```bash
+# Tailwind
+cat tailwind.config* 2>/dev/null
+# CSS 변수
+grep -r "^:root" --include="*.css" --include="*.scss" -l 2>/dev/null | head -5
+# styled-components / emotion 테마
+find src -name "theme*" -o -name "tokens*" -o -name "colors*" 2>/dev/null | head -10
+# CSS modules
+find src -name "*.module.css" -o -name "*.module.scss" 2>/dev/null | head -5
+# design system
+find . -path "*/design-system/*" -o -path "*/design-tokens/*" 2>/dev/null | head -10
+```
+### 아키텍처 관련
+```bash
+# package.json (의존성, 스크립트)
+cat package.json 2>/dev/null
+# Next.js
+cat next.config* 2>/dev/null
+# Vite
+cat vite.config* 2>/dev/null
+# 상태 관리
+grep -r "createStore\|configureStore\|createSlice\|useRecoilState\|atom\|create(" \
+  --include="*.ts" --include="*.tsx" -l 2>/dev/null | head -5
+# 라우팅
+find src -name "router*" -o -name "routes*" -o -name "routing*" 2>/dev/null | head -5
+```
+### 폴더 구조
+```bash
+find . -maxdepth 4 \
+  -not -path "*/node_modules/*" \
+  -not -path "*/.git/*" \
+  -not -path "*/.next/*" \
+  -not -path "*/dist/*" \
+  -not -path "*/build/*" \
+  -not -path "*/.bylane/*" \
+  -type f | head -100
+```
+## Step 2 — 각 영역 분석 및 정리
+수집된 데이터를 바탕으로 아래 네 가지 영역을 분석한다.
+### 2-1. 코드 스타일 분석
+다음 항목을 파악한다:
+- **언어**: TypeScript / JavaScript / 혼용 여부, strict 모드
+- **포맷팅**: indent(공백/탭, 너비), 따옴표 스타일, 세미콜론, trailing comma, print width
+- **네이밍 컨벤션**: 컴포넌트(PascalCase), 함수/변수(camelCase), 상수(UPPER_CASE), 파일명 패턴
+- **import 순서**: 외부 라이브러리 → 내부 모듈 순 여부, 절대경로 alias (`@/`, `~/`)
+- **컴포넌트 패턴**: 함수형/클래스형, default/named export, props 타입 정의 방식
+- **주석 스타일**: JSDoc, 인라인 주석 언어 (한국어/영어)
+- **금지 패턴**: `console.log`, `any` 타입, `!` non-null assertion 등
+### 2-2. 디자인 토큰 분석
+다음 항목을 파악한다:
+- **색상**: primary, secondary, accent, background, text, border, error, success, warning 팔레트
+- **타이포그래피**: font-family, font-size 스케일, font-weight, line-height, letter-spacing
+- **간격**: spacing 스케일 (4/8px 기반 등)
+- **브레이크포인트**: mobile/tablet/desktop 분기점
+- **반응형 접근**: mobile-first / desktop-first
+- **다크모드**: CSS 변수 기반 / Tailwind dark: / 별도 테마 객체
+- **그림자, 테두리 반경**: shadow, border-radius 스케일
+- **토큰 위치**: 어느 파일/변수에 정의되어 있는지
+토큰을 찾지 못한 경우 "감지되지 않음" 으로 표기.
+### 2-3. 아키텍처 분석
+다음 항목을 파악한다:
+- **프레임워크**: Next.js / Vite+React / Vue / Nuxt 등, 버전
+- **렌더링 전략**: SSR / SSG / CSR / ISR, App Router / Pages Router
+- **상태 관리**: Redux / Zustand / Recoil / Jotai / Context API / 없음
+- **데이터 페칭**: SWR / React Query / Apollo / fetch / axios, 캐싱 전략
+- **폼 관리**: React Hook Form / Formik / 직접 구현
+- **스타일링**: Tailwind / CSS Modules / styled-components / emotion / 혼용
+- **테스트**: Jest / Vitest / Testing Library / Playwright / Cypress
+- **주요 서드파티 의존성**: 핵심 라이브러리 목록과 용도
+### 2-4. 폴더 구조 분석
+다음 항목을 파악한다:
+- **최상위 디렉토리**: `src/`, `app/`, `pages/`, `components/`, `lib/`, `utils/`, `hooks/` 등
+- **컴포넌트 조직**: feature-based / type-based / atomic design
+- **공유 코드 위치**: 공통 컴포넌트, 유틸, 훅의 위치
+- **API/서버 코드 위치**: `api/`, `server/`, `services/`
+- **에셋 위치**: 이미지, 폰트, 아이콘
+- **환경 설정**: `.env` 파일 구조
+## Step 3 — instruction 파일 생성
+`.claude/instructions/` 디렉토리를 생성하고 각 파일을 저장한다:
+```bash
+mkdir -p .claude/instructions
+```
+### `.claude/instructions/code-style.md`
+```markdown
+# 코드 스타일 가이드
+> byLane analyze-agent가 자동 생성 · 마지막 업데이트: {날짜}
+> 수동 수정 가능. `/bylane analyze`로 재분석하면 덮어씁니다.
+## 언어 및 타입
+{TypeScript/JavaScript 버전, strict 설정}
+## 포맷팅
+- indent: {2 or 4 spaces / tabs}
+- 따옴표: {single / double}
+- 세미콜론: {있음 / 없음}
+- trailing comma: {all / es5 / none}
+- print width: {80 / 100 / 120}
+## 네이밍 컨벤션
+- 컴포넌트: PascalCase (`UserProfile`, `DarkModeToggle`)
+- 함수/변수: camelCase
+- 상수: {UPPER_SNAKE_CASE / camelCase}
+- 파일명: {kebab-case / PascalCase / camelCase}
+- CSS 클래스: {BEM / camelCase / kebab-case}
+## Import
+- 경로 alias: {`@/` → `src/`, 없음}
+- import 순서: 외부 라이브러리 → 내부 경로 → 상대 경로
+{추가 import 규칙}
+## 컴포넌트 패턴
+{함수형 컴포넌트 예시, props 타입 정의 방식}
+## 주석
+- 언어: {한국어 / 영어}
+- 스타일: {JSDoc / 인라인 // / 없음}
+## 금지 패턴
+{eslint 규칙에서 추출한 주요 금지 패턴}
+```
+### `.claude/instructions/design-tokens.md`
+```markdown
+# 디자인 토큰
+> byLane analyze-agent가 자동 생성 · 마지막 업데이트: {날짜}
+> 수동 수정 가능. `/bylane analyze`로 재분석하면 덮어씁니다.
+## 색상 팔레트
+{발견된 색상 토큰 — CSS 변수명 또는 Tailwind 키 포함}
+예시 형식:
+| 용도 | 변수명 / 클래스 | 값 |
+|---|---|---|
+| Primary | `--color-primary` / `bg-primary-500` | `#3B82F6` |
+## 타이포그래피
+{font-family, size 스케일, weight, line-height}
+## 간격 스케일
+{spacing 값 — Tailwind 기본 / 커스텀 스케일}
+## 브레이크포인트
+{sm/md/lg/xl 분기점}
+## 반응형 전략
+{mobile-first / desktop-first, 사용 방법}
+## 다크모드
+{지원 여부, 구현 방식}
+## 토큰 파일 위치
+{실제 토큰이 정의된 파일 경로}
+```
+### `.claude/instructions/architecture.md`
+```markdown
+# 프로젝트 아키텍처
+> byLane analyze-agent가 자동 생성 · 마지막 업데이트: {날짜}
+> 수동 수정 가능. `/bylane analyze`로 재분석하면 덮어씁니다.
+## 프레임워크 & 런타임
+- 프레임워크: {Next.js 14 App Router / Vite + React 18 / ...}
+- Node.js: {버전}
+- 패키지 매니저: {npm / yarn / pnpm}
+## 렌더링 전략
+{SSR / SSG / CSR / ISR, 어떤 페이지에 어떤 전략 사용}
+## 상태 관리
+{라이브러리, 스토어 위치, 사용 패턴}
+## 데이터 페칭
+{라이브러리, 패턴, API base URL 위치}
+## 스타일링
+{라이브러리, 설정 파일 위치}
+## 테스트
+{프레임워크, 실행 명령, 테스트 파일 위치 패턴}
+## 주요 의존성
+{핵심 라이브러리와 용도 목록}
+## 폴더 구조
+{프로젝트 디렉토리 트리 (핵심 부분만)}
+## 컨벤션
+{이 프로젝트 특유의 패턴이나 주의사항}
+```
+## Step 4 — CLAUDE.md 업데이트
+### CLAUDE.md 존재 확인
+```bash
+test -f CLAUDE.md && echo "exists" || echo "not_found"
+```
+**없는 경우**: `/init` 커맨드를 실행하여 CLAUDE.md를 먼저 생성한다.
+CLAUDE.md 생성 후 Step 4를 계속한다.
+### import 섹션 추가
+CLAUDE.md의 상단 (첫 번째 `#` 헤딩 이전) 또는 기존 import 블록 뒤에 아래 내용을 추가한다.
+이미 같은 경로가 있으면 중복 추가하지 않는다:
+```markdown
+@.claude/instructions/code-style.md
+@.claude/instructions/design-tokens.md
+@.claude/instructions/architecture.md
+```
+Claude Code는 CLAUDE.md에서 `@경로` 형식으로 다른 파일을 자동으로 로드한다.
+### 추가 방법
+```python
+# 의사코드 — Read 도구로 CLAUDE.md 읽은 후 Edit 도구로 수정
+lines = read("CLAUDE.md")
+imports_to_add = [
+    "@.claude/instructions/code-style.md",
+    "@.claude/instructions/design-tokens.md",
+    "@.claude/instructions/architecture.md",
+]
+# 이미 있는 항목 제외
+missing = [i for i in imports_to_add if i not in lines]
+if missing:
+    # 첫 번째 줄에 삽입 (또는 기존 @ import 블록 마지막에 추가)
+    insert_at_top(missing)
+```
+## Step 5 — 완료 처리
+```bash
+node -e "
+import('PATH_TO_BYLANE/src/state.js').then(({writeState}) => {
+  writeState('analyze-agent', {
+    status: 'completed',
+    progress: 100,
+    currentTask: '분석 완료',
+    retries: 0,
+    generatedFiles: [
+      '.claude/instructions/code-style.md',
+      '.claude/instructions/design-tokens.md',
+      '.claude/instructions/architecture.md'
+    ]
+  })
+})
+"
+```
+분석 결과 요약을 사용자에게 출력한다:
+```
+분석 완료!
+생성된 파일:
+  .claude/instructions/code-style.md    — 코드 스타일, 네이밍 컨벤션
+  .claude/instructions/design-tokens.md — 색상, 타이포, 간격, 브레이크포인트
+  .claude/instructions/architecture.md  — 프레임워크, 상태관리, 주요 의존성
+CLAUDE.md에 import 추가 완료.
+다음 Claude Code 세션부터 이 프로젝트의 컨텍스트를 자동으로 로드합니다.
+재분석: /bylane analyze
+```
+## 수동 실행
+```
+/bylane analyze
+```
+## 주의사항
+- `--force` 옵션: 기존 instruction 파일을 강제로 덮어씀
+  기본값: 파일이 이미 있으면 덮어쓰기 전에 사용자에게 확인 요청
+- 디자인 토큰이나 코드 스타일이 감지되지 않은 항목은 "감지되지 않음" 으로 표기하고,
+  사용자가 직접 채울 수 있도록 TODO 주석을 남긴다
+- `.claude/instructions/` 파일은 수동으로 수정해도 된다 — `/bylane analyze` 재실행 시 덮어쓰므로
+  커스텀 내용은 별도 파일로 분리하거나 `@.claude/instructions/structure.md` 를 직접 작성한다

package/skills/orchestrator.md CHANGED Viewed

@@ -27,6 +27,7 @@ import('./src/config.js').then(({loadConfig, getAgentModel}) => {
     'commit-agent','pr-agent','review-agent','respond-agent','notify-agent'
   ]
   agents.forEach(a => console.log(a + ': ' + getAgentModel(config, a)))
+  // analyze-agent는 항상 opus 사용 (config 무관)
 })
 "
 ```
@@ -47,6 +48,7 @@ import('./src/config.js').then(({loadConfig, getAgentModel}) => {
 | "커밋해줘" | commit-agent |
 | "PR 만들어줘" | pr-agent |
 | "테스트해줘" | test-agent |
+| "프로젝트 분석", "analyze", "코드스타일 분석", "디자인토큰 분석" | analyze-agent |
 ## 에이전트 실행 방법

package/src/config.js CHANGED Viewed

@@ -50,7 +50,8 @@ export const DEFAULT_CONFIG = {
     'pr-agent': 'claude-haiku-4-5-20251001',
     'review-agent': 'claude-sonnet-4-6',
     'respond-agent': 'claude-opus-4-6',
-    'notify-agent': 'claude-haiku-4-5-20251001'
+    'notify-agent': 'claude-haiku-4-5-20251001',
+    'analyze-agent': 'claude-opus-4-6'
   },
   review: {
     model: 'claude-sonnet-4-6',