@litmers/cursorflow-orchestrator 0.1.37 → 0.1.40

package/README.md

@@ -77,9 +77,9 @@ cursorflow new SearchFeature --lanes "api,web,mobile"
 ```
 _cursorflow/flows/001_SearchFeature/
 ├── flow.meta.json       # Flow 메타데이터
-├── 01-api.json          # API 레인 (빈 상태)
-├── 02-web.json          # Web 레인 (빈 상태)
-└── 03-mobile.json       # Mobile 레인 (빈 상태)
+├── api.json             # API 레인 (빈 상태)
+├── web.json             # Web 레인 (빈 상태)
+└── mobile.json          # Mobile 레인 (빈 상태)
 ```
 
 ---
@@ -178,7 +178,7 @@ Within the `cursorflow monitor` dashboard:
 {
   "branchPrefix": "feature/lane-1-",
   "timeout": 600000,
-  "enableIntervention": false,
+  "enableIntervention": true,
   "enableReview": true,
   "reviewModel": "sonnet-4.5-thinking",
   "tasks": [
@@ -203,7 +203,7 @@ Within the `cursorflow monitor` dashboard:
 | Option | Type | Default | Description |
 |--------|------|---------|-------------|
 | `timeout` | number | 600000 | Task timeout in milliseconds (10 min) |
-| `enableIntervention` | boolean | false | Enable stdin piping for intervention |
+| `enableIntervention` | boolean | true | Enable stdin piping for intervention |
 | `model` | string | "sonnet-4.5" | AI model to use |
 | `enableReview` | boolean | true | Enable AI code review |
 
@@ -222,7 +222,7 @@ JSON 파일에서 `dependsOn` 필드 추가:
     { 
       "name": "integrate", 
       "prompt": "API 연동...",
-      "dependsOn": ["01-backend:implement"]  // ← 이 태스크 완료 후 시작
+      "dependsOn": ["backend:implement"]  // ← 이 태스크 완료 후 시작
     }
   ]
 }
@@ -233,9 +233,9 @@ JSON 파일에서 `dependsOn` 필드 추가:
 ### 실행 흐름 예시
 
 ```
-01-backend: [setup] → [implement] → [test]
+1-backend: [setup] → [implement] → [test]
                           ↓ 완료!
-02-frontend: [setup] ─────┴─ 대기 → [integrate] → [test]
+2-frontend: [setup] ─────┴─ 대기 → [integrate] → [test]
 ```
 
 - 백엔드와 프론트엔드 **동시 시작**
@@ -246,7 +246,7 @@ JSON 파일에서 `dependsOn` 필드 추가:
 
 ```bash
 cursorflow doctor --tasks-dir _cursorflow/tasks/MyFeature
-# ❌ Cyclic dependency: 01-a:task1 → 02-b:task2 → 01-a:task1
+# ❌ Cyclic dependency: a:task1 → b:task2 → a:task1
 ```
 
 ## 🩺 Pre-flight Checks
@@ -308,12 +308,12 @@ CursorFlow provides comprehensive logging with automatic cleanup and export opti
 
 ### Log Format
 
-Logs use the format `[L{n}-T{t}-{lanename}]`:
-- `L{n}`: Lane number (1-indexed, single digit)
-- `T{t}`: Task number (1-indexed, single digit)
+Logs use the format `[{n}-{t}-{lanename}]`:
+- `{n}`: Lane number (1-indexed)
+- `{t}`: Task number (1-indexed)
 - `{lanename}`: First 10 characters of lane name
 
-Example: `[L1-T2-backend]` = Lane 1, Task 2, lane "backend"
+Example: `[1-2-backend]` = Lane 1, Task 2, lane "backend"
 
 ### Features
 - **ANSI Stripping**: Clean logs without terminal escape codes

package/commands/cursorflow-init.md

@@ -1,50 +1,131 @@
-# CursorFlow Init
+# cursorflow init
 
-## Overview
-Initialize CursorFlow in your project. This command creates the default configuration file, sets up the required directory structure, and prepares the environment for parallel AI orchestration.
+프로젝트에 CursorFlow를 초기화합니다.
 
-## Usage
+## 사용법
 
 ```bash
 cursorflow init [options]
 ```
 
-## Options
+## 옵션
 
-| Option | Description |
+| 옵션 | 설명 |
 |------|------|
-| `--example` | Create an example task to help you get started |
-| `--config-only` | Only create the `cursorflow.config.js` file |
-| `--no-commands` | Skip installing Cursor IDE custom commands |
-| `--no-gitignore` | Skip adding `_cursorflow/` to your `.gitignore` |
-| `--force` | Overwrite existing configuration or directories |
+| `--example` | 예제 Flow를 생성하여 빠르게 시작 |
+| `--config-only` | `cursorflow.config.js` 파일만 생성 |
+| `--no-commands` | Cursor IDE 커맨드 설치 건너뛰기 |
+| `--no-gitignore` | `.gitignore`에 `_cursorflow/` 추가 안 함 |
+| `--force` | 기존 설정 덮어쓰기 |
 
-## What's Created?
+## 생성되는 구조
 
-1. **`cursorflow.config.js`**: Central configuration for the project.
-2. **`_cursorflow/tasks/`**: Directory where you define your task JSON files.
-3. **`_cursorflow/logs/`**: Directory for run logs and terminal outputs.
-4. **`.cursor/commands/cursorflow/`**: (Optional) Integrated Cursor IDE commands.
-5. **`.gitignore` update**: Adds `_cursorflow/` to prevent committing logs.
+```
+your-project/
+├── cursorflow.config.js          # 중앙 설정 파일
+├── _cursorflow/
+│   ├── flows/                    # Flow 정의 (new 커맨드로 생성)
+│   ├── tasks/                    # Legacy 태스크 (deprecated)
+│   └── logs/                     # 실행 로그
+└── .cursor/
+    └── commands/cursorflow/      # Cursor IDE 커맨드
+```
+
+## 빠른 시작
+
+### Step 1: 초기화
+
+```bash
+cd your-project
+cursorflow init
+```
+
+### Step 2: Flow 생성
+
+```bash
+# 백엔드와 프론트엔드 2개 레인으로 Flow 생성
+cursorflow new MyFeature --lanes "backend,frontend"
+```
+
+### Step 3: Task 추가
+
+```bash
+# 백엔드 레인에 태스크 추가
+cursorflow add MyFeature backend \
+  --task "name=implement|prompt=API 엔드포인트 구현"
+
+# 프론트엔드 레인에 태스크 추가 (백엔드 완료 후 시작)
+cursorflow add MyFeature frontend \
+  --task "name=ui|prompt=UI 컴포넌트 구현" \
+  --after "backend"
+```
 
-## Example
+### Step 4: 검증 및 실행
 
 ```bash
-# Standard initialization with an example task
-cursorflow init --example
+# 설정 검증
+cursorflow doctor MyFeature
+
+# 실행
+cursorflow run MyFeature
+
+# 모니터링
+cursorflow monitor latest
+```
+
+## 워크플로우 다이어그램
+
+```
+┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
+│ 1. Create Flow  │ ──▶ │ 2. Add Tasks    │ ──▶ │ 3. Validate     │ ──▶ │ 4. Run          │
+│ (new)           │     │ (add)           │     │ (doctor)        │     │ (run)           │
+└─────────────────┘     └─────────────────┘     └─────────────────┘     └─────────────────┘
+```
+
+## 설정 파일 (cursorflow.config.js)
+
+```javascript
+module.exports = {
+  // 기본 브랜치 (worktree 생성 기준)
+  baseBranch: 'main',
+  
+  // 동시 실행 레인 수
+  maxConcurrentLanes: 3,
+  
+  // 기본 AI 모델 (task에서 model 생략 시 사용)
+  defaultModel: 'sonnet-4.5',
+  
+  // 태스크 타임아웃 (ms)
+  timeout: 600000,
+  
+  // AI 리뷰 활성화
+  enableReview: true,
+  reviewModel: 'sonnet-4.5-thinking',
+  
+  // Flow/Task 디렉토리
+  flowsDir: '_cursorflow/flows',
+  tasksDir: '_cursorflow/tasks',  // legacy
+  logsDir: '_cursorflow/logs',
+};
+```
+
+## 기본 모델 설정
+
+```bash
+# 기본 모델 확인
+cursorflow config defaultModel
+
+# 기본 모델 변경
+cursorflow config defaultModel gemini-2.5-flash
 
-# Minimal initialization
-cursorflow init --no-commands --no-gitignore
+# 사용 가능한 모델 목록
+cursorflow models
 ```
 
-## Next Steps
+## 관련 명령어
 
-1. **Configure**: Review `cursorflow.config.js` and adjust settings like `baseBranch` or `maxConcurrentLanes`.
-2. **Explore**: If you used `--example`, run it with:
-   ```bash
-   cursorflow run _cursorflow/tasks/example/
-   ```
-3. **Create**: Start your own feature tasks with:
-   ```bash
-   cursorflow prepare MyFeature
-   ```
+- [cursorflow new](cursorflow-new.md) - Flow와 Lane 생성
+- [cursorflow add](cursorflow-add.md) - Lane에 Task 추가
+- [cursorflow run](cursorflow-run.md) - Flow 실행
+- [cursorflow monitor](cursorflow-monitor.md) - 실행 모니터링
+- [cursorflow doctor](cursorflow-doctor.md) - 설정 검증