@litmers/cursorflow-orchestrator 0.1.0 → 0.1.2

package/commands/cursorflow-clean.md

@@ -1,162 +1,162 @@
-# CursorFlow Clean
-
-## Overview
-브랜치, 워크트리, 로그 등을 정리합니다. 오래된 파일이나 실패한 실행의 잔여물을 제거합니다.
-
-## Steps
-
-1. **정리 타입 선택**
-   
-   | 타입 | 설명 |
-   |------|------|
-   | `branches` | Git 브랜치 정리 |
-   | `worktrees` | Git worktree 정리 |
-   | `logs` | 로그 파일 정리 |
-   | `all` | 모두 정리 |
-
-2. **브랜치 정리**
-   ```bash
-   cursorflow clean branches --pattern "feature/my-*"
-   ```
-
-3. **워크트리 정리**
-   ```bash
-   cursorflow clean worktrees --all
-   ```
-
-4. **로그 정리**
-   ```bash
-   cursorflow clean logs --older-than 30
-   ```
-
-5. **Dry run으로 확인**
-   ```bash
-   cursorflow clean all --dry-run
-   ```
-
-## 옵션
-
-| 옵션 | 설명 |
-|------|------|
-| `--pattern <pattern>` | 패턴 매칭 (예: "feature/*") |
-| `--older-than <days>` | N일 이상 된 항목만 (logs용) |
-| `--dry-run` | 삭제할 항목만 표시 |
-| `--force` | 확인 없이 삭제 |
-| `--local-only` | 로컬만 (브랜치용) |
-| `--remote-only` | 원격만 (브랜치용) |
-
-## 예제
-
-### 브랜치 정리
-
-#### 패턴 매칭으로 삭제
-```bash
-cursorflow clean branches --pattern "feature/dashboard-*"
-```
-
-#### 모든 CursorFlow 브랜치
-```bash
-cursorflow clean branches --pattern "feature/*" --dry-run
-```
-
-#### 로컬 브랜치만
-```bash
-cursorflow clean branches --pattern "feature/*" --local-only
-```
-
-### 워크트리 정리
-
-#### 모든 워크트리
-```bash
-cursorflow clean worktrees --all
-```
-
-#### 특정 패턴
-```bash
-cursorflow clean worktrees --pattern "*-dashboard-*"
-```
-
-### 로그 정리
-
-#### 30일 이상 된 로그
-```bash
-cursorflow clean logs --older-than 30
-```
-
-#### 모든 로그
-```bash
-cursorflow clean logs --all --force
-```
-
-### 전체 정리
-
-#### 모두 확인 후 삭제
-```bash
-cursorflow clean all --dry-run
-cursorflow clean all --force
-```
-
-## 정리 결과
-
-```
-🧹 Cleaning CursorFlow Resources
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-Branches to delete:
-  - feature/dashboard-pipeline-abc123 (local)
-  - feature/dashboard-pipeline-abc123 (remote)
-  - feature/client-pipeline-def456 (local)
-
-Worktrees to remove:
-  - .cursorflow/logs/worktrees/01-dashboard-pipeline-abc123
-  - .cursorflow/logs/worktrees/02-client-pipeline-def456
-
-Logs to delete:
-  - _cursorflow/logs/runs/01-dashboard-2025-12-10T10-00-00 (9 days old)
-
-Total: 5 branches, 2 worktrees, 1 log directory
-
-Proceed? [y/N]
-```
-
-## 주의사항
-
-1. **백업**: 중요한 작업 중인 브랜치는 백업
-2. **확인**: `--dry-run`으로 먼저 확인
-3. **원격**: 원격 브랜치 삭제는 신중하게
-4. **복구**: 삭제된 항목은 복구 어려움
-
-## Checklist
-- [ ] 정리할 항목을 확인했는가?
-- [ ] 백업이 필요한가?
-- [ ] dry-run으로 먼저 확인했는가?
-- [ ] 다른 사람이 사용 중인 브랜치는 아닌가?
-- [ ] 원격 저장소에서도 삭제할 것인가?
-
-## 트러블슈팅
-
-### 브랜치 삭제 실패
-```bash
-# 강제 삭제
-git branch -D <branch-name>
-git push origin --delete <branch-name>
-```
-
-### 워크트리 제거 실패
-```bash
-# 강제 제거
-git worktree remove --force <worktree-path>
-```
-
-### 로그 디렉토리 권한 문제
-```bash
-# 권한 확인
-ls -la _cursorflow/logs/
-# 권한 수정
-chmod -R u+w _cursorflow/logs/
-```
-
-## Next Steps
-1. 정기적으로 로그 정리 (예: 월 1회)
-2. CI/CD에 자동 정리 스크립트 추가
-3. `.gitignore`에 로그 디렉토리 추가
+# CursorFlow Clean
+
+## Overview
+Clean up branches, worktrees, and logs. Remove stale files or remnants from failed runs.
+
+## Steps
+
+1. **Choose what to clean**
+
+   | Type | Description |
+   |------|------|
+   | `branches` | Clean Git branches |
+   | `worktrees` | Clean Git worktrees |
+   | `logs` | Clean log files |
+   | `all` | Clean everything |
+
+2. **Clean branches**
+   ```bash
+   cursorflow clean branches --pattern "feature/my-*"
+   ```
+
+3. **Clean worktrees**
+   ```bash
+   cursorflow clean worktrees --all
+   ```
+
+4. **Clean logs**
+   ```bash
+   cursorflow clean logs --older-than 30
+   ```
+
+5. **Verify with a dry run**
+   ```bash
+   cursorflow clean all --dry-run
+   ```
+
+## Options
+
+| Option | Description |
+|------|------|
+| `--pattern <pattern>` | Pattern match (e.g., "feature/*") |
+| `--older-than <days>` | Items older than N days (for logs) |
+| `--dry-run` | Show items to delete without removing |
+| `--force` | Delete without confirmation |
+| `--local-only` | Local only (branches) |
+| `--remote-only` | Remote only (branches) |
+
+## Examples
+
+### Branch cleanup
+
+#### Delete by pattern
+```bash
+cursorflow clean branches --pattern "feature/dashboard-*"
+```
+
+#### All CursorFlow branches
+```bash
+cursorflow clean branches --pattern "feature/*" --dry-run
+```
+
+#### Local branches only
+```bash
+cursorflow clean branches --pattern "feature/*" --local-only
+```
+
+### Worktree cleanup
+
+#### All worktrees
+```bash
+cursorflow clean worktrees --all
+```
+
+#### Specific pattern
+```bash
+cursorflow clean worktrees --pattern "*-dashboard-*"
+```
+
+### Log cleanup
+
+#### Logs older than 30 days
+```bash
+cursorflow clean logs --older-than 30
+```
+
+#### All logs
+```bash
+cursorflow clean logs --all --force
+```
+
+### Full cleanup
+
+#### Review then delete
+```bash
+cursorflow clean all --dry-run
+cursorflow clean all --force
+```
+
+## Sample output
+
+```
+🧹 Cleaning CursorFlow Resources
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Branches to delete:
+  - feature/dashboard-pipeline-abc123 (local)
+  - feature/dashboard-pipeline-abc123 (remote)
+  - feature/client-pipeline-def456 (local)
+
+Worktrees to remove:
+  - .cursorflow/logs/worktrees/01-dashboard-pipeline-abc123
+  - .cursorflow/logs/worktrees/02-client-pipeline-def456
+
+Logs to delete:
+  - _cursorflow/logs/runs/01-dashboard-2025-12-10T10-00-00 (9 days old)
+
+Total: 5 branches, 2 worktrees, 1 log directory
+
+Proceed? [y/N]
+```
+
+## Notes
+
+1. **Back up**: Save important branches before deleting.
+2. **Confirm**: Start with `--dry-run` to review changes.
+3. **Remote caution**: Be careful when deleting remote branches.
+4. **Irreversible**: Deleted items are hard to recover.
+
+## Checklist
+- [ ] Have you reviewed items to clean?
+- [ ] Do you need backups?
+- [ ] Did you run a dry run first?
+- [ ] Are other teammates using these branches?
+- [ ] Do you also need to delete from the remote?
+
+## Troubleshooting
+
+### Branch deletion failed
+```bash
+# Force delete
+git branch -D <branch-name>
+git push origin --delete <branch-name>
+```
+
+### Worktree removal failed
+```bash
+# Force remove
+git worktree remove --force <worktree-path>
+```
+
+### Log directory permission issues
+```bash
+# Check permissions
+ls -la _cursorflow/logs/
+# Fix permissions
+chmod -R u+w _cursorflow/logs/
+```
+
+## Next steps
+1. Clean logs regularly (e.g., monthly).
+2. Add an automated cleanup script to CI/CD.
+3. Add log directories to `.gitignore`.

package/commands/cursorflow-init.md

@@ -1,67 +1,67 @@
-# CursorFlow Init
-
-## Overview
-프로젝트에 CursorFlow를 초기화합니다. 설정 파일과 디렉토리 구조를 생성하고, 선택적으로 Cursor 커맨드와 예제 태스크를 설치합니다.
-
-## Steps
-
-1. **초기화 실행**
-   ```bash
-   cursorflow init
-   ```
-
-2. **옵션 선택**
-   - `--example`: 예제 태스크 생성
-   - `--config-only`: 설정 파일만 생성
-   - `--no-commands`: Cursor 커맨드 설치 건너뛰기
-   - `--force`: 기존 파일 덮어쓰기
-
-3. **생성 확인**
-   - `cursorflow.config.js` 파일 생성됨
-   - `_cursorflow/tasks/` 디렉토리 생성됨
-   - `_cursorflow/logs/` 디렉토리 생성됨
-   - `.cursor/commands/cursorflow/` 커맨드 설치됨 (선택)
-
-4. **설정 파일 검토**
-   ```javascript
-   // cursorflow.config.js
-   module.exports = {
-     tasksDir: '_cursorflow/tasks',
-     logsDir: '_cursorflow/logs',
-     baseBranch: 'main',
-     // ... 기타 설정
-   };
-   ```
-
-## 예제
-
-### 기본 초기화
-```bash
-cursorflow init
-```
-
-### 예제 태스크 포함
-```bash
-cursorflow init --example
-```
-
-### 설정 파일만 생성
-```bash
-cursorflow init --config-only
-```
-
-### 기존 파일 덮어쓰기
-```bash
-cursorflow init --force
-```
-
-## Checklist
-- [ ] 설정 파일이 프로젝트 루트에 생성되었는가?
-- [ ] 필요한 디렉토리가 생성되었는가?
-- [ ] Cursor 커맨드가 설치되었는가?
-- [ ] 설정 내용이 프로젝트에 맞게 조정되었는가?
-
-## Next Steps
-1. `cursorflow.config.js` 파일을 프로젝트에 맞게 수정
-2. Cursor IDE에서 `/` 입력하여 커맨드 확인
-3. `cursorflow prepare MyFeature`로 태스크 생성 시작
+# CursorFlow Init
+
+## Overview
+Initialize CursorFlow in your project. Create the config file and directory structure, and optionally install Cursor commands and example tasks.
+
+## Steps
+
+1. **Run initialization**
+   ```bash
+   cursorflow init
+   ```
+
+2. **Choose options**
+   - `--example`: create example tasks
+   - `--config-only`: create only the config file
+   - `--no-commands`: skip installing Cursor commands
+   - `--force`: overwrite existing files
+
+3. **Verify created files**
+   - `cursorflow.config.js` created
+   - `_cursorflow/tasks/` directory created
+   - `_cursorflow/logs/` directory created
+   - `.cursor/commands/cursorflow/` commands installed (optional)
+
+4. **Review the config file**
+   ```javascript
+   // cursorflow.config.js
+   module.exports = {
+     tasksDir: '_cursorflow/tasks',
+     logsDir: '_cursorflow/logs',
+     baseBranch: 'main',
+     // ... other settings
+   };
+   ```
+
+## Examples
+
+### Basic initialization
+```bash
+cursorflow init
+```
+
+### Include example tasks
+```bash
+cursorflow init --example
+```
+
+### Generate only the config
+```bash
+cursorflow init --config-only
+```
+
+### Overwrite existing files
+```bash
+cursorflow init --force
+```
+
+## Checklist
+- [ ] Was the config file created at the project root?
+- [ ] Were the required directories created?
+- [ ] Were Cursor commands installed?
+- [ ] Is the configuration adjusted for the project?
+
+## Next steps
+1. Update `cursorflow.config.js` for your project.
+2. In Cursor IDE, type `/` to confirm the commands are available.
+3. Start generating tasks with `cursorflow prepare MyFeature`.