spets 0.1.3 → 0.1.5

package/README.md

@@ -5,10 +5,9 @@ Spec Driven Development Execution Framework - 유저가 정의한 스텝대로 S
 ## Installation
 
 ```bash
-# 글로벌 설치 (선택)
 npm install -g spets
 
-# 또는 npx로 바로 사용 (설치 불필요)
+# 또는 npx로 바로 사용
 npx spets init
 ```
 
@@ -30,7 +29,7 @@ npx spets resume
 
 ## How it Works
 
-1. **spets init** - `.sept/` 폴더에 설정과 스텝 템플릿 생성
+1. **spets init** - `.spets/` 폴더에 설정과 스텝 템플릿 생성
 2. **spets start** - 유저 쿼리로 워크플로우 시작, Claude가 각 스텝 문서 생성
 3. **approve/revise/reject** - 각 스텝마다 유저가 검토하고 승인
 4. **반복** - 모든 스텝 완료까지 진행
@@ -38,7 +37,7 @@ npx spets resume
 ## Directory Structure
 
 ```
-.sept/
+.spets/
 ├── config.yml          # 워크플로우 설정
 ├── steps/
 │   ├── 01-plan/
@@ -56,21 +55,61 @@ npx spets resume
 
 ## GitHub Integration
 
-PR/Issue 코멘트로 워크플로우 제어:
+GitHub Issue/PR과 연동하여 워크플로우를 실행합니다.
+
+### 설정
 
 ```bash
-# GitHub Actions 워크플로우 포함해서 초기화
+# GitHub Actions + Issue 템플릿 포함해서 초기화
 npx spets init --github
+```
+
+이 명령어는 다음을 생성합니다:
+- `.github/workflows/spets.yml` - GitHub Actions 워크플로우
+- `.github/ISSUE_TEMPLATE/spets-task.yml` - Issue 템플릿
+- `.spets/config.yml`에 `github.owner`, `github.repo` 자동 설정 (git remote에서 파싱)
+
+### Issue로 워크플로우 시작
+
+1. GitHub에서 **New Issue** → **Spets Task** 템플릿 선택
+2. Task Description 입력 (예: "사용자 인증 기능 추가")
+3. Branch Name 입력 (선택, 비워두면 `spets/<issue-number>` 자동 생성)
+4. Issue 생성 → GitHub Actions 자동 트리거
+
+### CLI로 워크플로우 시작
+
+```bash
+# GitHub 모드 (기존 Issue/PR 자동 감지)
+npx spets start "task" --github
+
+# 새 Issue 생성하면서 시작
+npx spets start "task" --issue
 
-# GitHub 플랫폼으로 시작
-npx spets start "task" --platform github --owner myorg --repo myrepo --issue 42
+# 기존 Issue에 연결
+npx spets start "task" --issue 42
+
+# 새 PR 생성하면서 시작 (브랜치도 자동 생성)
+npx spets start "task" --pr
+
+# 기존 PR에 연결
+npx spets start "task" --pr 42
 ```
 
-코멘트 명령어:
-- `/approve` - 승인하고 다음 스텝
-- `/revise <feedback>` - 피드백과 함께 재생성
+### 코멘트 명령어
+
+Issue/PR 코멘트로 워크플로우를 제어합니다:
+
+- `/approve` - 현재 스텝 승인하고 다음 스텝 진행
+- `/approve --pr` - 승인하고 Pull Request 생성
+- `/approve --issue` - 승인하고 Issue 생성/업데이트
+- `/revise <feedback>` - 피드백과 함께 현재 스텝 재생성
 - `/reject` - 워크플로우 중단
 
+### 필요 설정
+
+Repository Secrets에 추가:
+- `CLAUDE_CODE_OAUTH_TOKEN` - Claude 인증 토큰 (`claude setup-token`으로 생성)
+
 ## Claude Code Plugin
 
 ```bash
@@ -81,17 +120,21 @@ npx spets plugin install claude
 /spets start "task description"
 ```
 
-스킬이 설치되면 Claude Code 내에서 `npx spets` 명령어를 자동으로 실행합니다. 글로벌 설치 없이도 동작합니다.
-
 ## Configuration
 
-`.sept/config.yml`:
+`.spets/config.yml`:
 
 ```yaml
 steps:
   - 01-plan
   - 02-implement
 
+# GitHub 연동 (spets init --github 시 자동 설정)
+github:
+  owner: your-org
+  repo: your-repo
+
+# 훅 (선택)
 hooks:
   preStep: "./hooks/pre-step.sh"
   postStep: "./hooks/post-step.sh"
@@ -102,7 +145,8 @@ hooks:
 ## Requirements
 
 - Node.js >= 18
-- Claude CLI (`claude` command) or ANTHROPIC_API_KEY
+- Claude CLI (`claude` command) or CLAUDE_CODE_OAUTH_TOKEN
+- GitHub CLI (`gh`) - GitHub 연동 사용 시
 
 ## License
 

package/dist/{chunk-XYU22TND.js → chunk-YK5ZZE4P.js}

@@ -195,6 +195,8 @@ function loadTaskMetadata(taskId, cwd = process.cwd()) {
 
 export {
   getSpetsDir,
+  getStepsDir,
+  getOutputsDir,
   spetsExists,
   loadConfig,
   loadStepDefinition,