github-project-manager 0.1.4 → 0.2.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 (2) hide show
  1. package/README.md +89 -50
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1,65 +1,112 @@
1
1
  # GPM - GitHub Project Manager
2
2
 
3
- GitHub Project V2를 CLI와 웹 UI로 관리하는 도구. Claude Code에서 bash로 태스크를 관리하고, 브라우저에서 칸반 보드로 시각화합니다.
3
+ GitHub Project V2를 CLI와 웹 UI로 관리하는 도구.
4
+ Claude Code에서 AI PM처럼 태스크를 추천받고, 브라우저에서 칸반 보드로 시각화합니다.
4
5
 
5
- ## 설치
6
+ ## 설치 & 세팅 (Claude Code에서 그대로 실행)
6
7
 
7
8
  ```bash
8
- npm install -g github-project-manager
9
+ # 1. GitHub CLI 인증 (아직 안 했다면)
10
+ gh auth login
11
+
12
+ # 2. git repo 안에서 초기화
13
+ npx github-project-manager init
14
+ # → GitHub Project URL 입력
15
+ # → .gpmrc 생성
16
+ # → .claude/skills/gpm/SKILL.md 생성 (Claude Code Skill)
17
+ # → .claude/agents/gpm-pm.md 생성 (AI PM Agent)
18
+
19
+ # 3. 동기화
20
+ npx github-project-manager sync
9
21
  ```
10
22
 
11
- ## 사전 조건
23
+ init 완료 후 Claude Code에서 `/gpm status`, `/gpm next` 등을 바로 사용할 수 있습니다.
12
24
 
13
- - Node.js 22+
14
- - [GitHub CLI](https://cli.github.com/) 설치 및 인증 (`gh auth login`)
15
- - GitHub Project V2
25
+ ## Claude Code 연동
16
26
 
17
- ## 빠른 시작
27
+ `gpm init`을 실행하면 아래 파일이 자동 생성됩니다:
18
28
 
19
- ```bash
20
- # 1. GitHub Project 연결 (git repo 안에서 실행)
21
- npx github-project-manager init
29
+ ```
30
+ .gpmrc # GitHub Project 연결 설정
31
+ .claude/skills/gpm/SKILL.md # /gpm 슬래시 커맨드 (Skill)
32
+ .claude/agents/gpm-pm.md # AI PM Agent
33
+ ```
22
34
 
23
- # 2. GitHub에서 태스크 가져오기
24
- npx github-project-manager sync
35
+ ### Skill 커맨드 (`/gpm`)
25
36
 
26
- # 3. 태스크 목록 확인
27
- npx github-project-manager task list
37
+ Claude Code에서 슬래시 커맨드로 사용:
28
38
 
29
- # 4. 웹 UI 실행
30
- npx github-project-manager server
31
- ```
39
+ | 커맨드 | 설명 |
40
+ |--------|------|
41
+ | `/gpm next` | 마일스톤 기한 + 최근 작업 맥락 기반으로 다음 태스크 추천 → 선택 → 작업 시작 |
42
+ | `/gpm done` | 현재 작업 완료 처리 (git log 분석으로 태스크 추론 + 사용자 확인) |
43
+ | `/gpm status` | 프로젝트 현황 브리핑 (상태별 집계, 진행 중 태스크, 마일스톤 진행률) |
44
+ | `/gpm plan` | 남은 태스크 분석 → 마일스톤 기한 기준 작업 순서 제안 |
45
+ | `/gpm sync` | GitHub Project와 동기화 |
46
+ | `/gpm create <title>` | 태스크 생성 + 목적/완료기준/구현방향 작업 계획 자동 작성 |
32
47
 
33
- ## CLI 명령어
48
+ ### AI PM Agent (`gpm-pm`)
34
49
 
35
- ### 초기 설정
50
+ Claude Code가 자동으로 PM처럼 행동합니다:
36
51
 
37
- ```bash
38
- npx github-project-manager init # GitHub Project URL 입력 → .gpmrc 생성
52
+ - **"다음 뭐 해?"** → 마일스톤 기한, 최근 작업, 의존성을 분석하여 추천
53
+ - **"이거 끝났어"** → git log에서 작업 추론 + 상태 변경 + 다음 추천
54
+ - **"현황 알려줘"** → 마일스톤 진행률 바 + 리스크 감지 + In Progress 목록
55
+ - **커밋/PR 시** → "이 작업이 #N 태스크와 관련있네요. 완료 처리할까요?"
56
+
57
+ ### 기존 프로젝트에 GPM 적용하기
58
+
59
+ 이미 CLAUDE.md가 있는 프로젝트에서 GPM을 사용하려면, CLAUDE.md에 아래 내용을 추가하세요:
60
+
61
+ ```markdown
62
+ ## GPM 태스크 관리
63
+
64
+ 이 프로젝트는 [GPM](https://www.npmjs.com/package/github-project-manager)으로 GitHub Project V2 태스크를 관리합니다.
65
+
66
+ ### 설정 파일
67
+ - `.gpmrc` — GitHub Project 연결 정보
68
+ - `.claude/skills/gpm/SKILL.md` — /gpm 슬래시 커맨드
69
+ - `.claude/agents/gpm-pm.md` — AI PM Agent
70
+
71
+ ### 사용 방법
72
+ - `/gpm next` — 다음 작업 추천 (마일스톤 기한 + 최근 작업 맥락 기반)
73
+ - `/gpm done` — 현재 작업 완료 처리
74
+ - `/gpm status` — 프로젝트 현황 브리핑
75
+ - `/gpm plan` — 작업 계획 수립
76
+
77
+ ### 태스크 관리 규칙
78
+ - 새 기능 작업 시작 전 `/gpm next`로 GitHub Project 태스크를 확인한다
79
+ - 작업 완료 후 `/gpm done`으로 태스크 상태를 업데이트한다
80
+ - 새 태스크가 필요하면 `/gpm create`로 GitHub Project에 직접 생성한다
39
81
  ```
40
82
 
83
+ 이 내용을 CLAUDE.md에 추가하면 Claude Code가 GPM Skill/Agent를 적극적으로 활용합니다.
84
+
85
+ ## 사전 조건
86
+
87
+ - Node.js 22+
88
+ - [GitHub CLI](https://cli.github.com/) (`gh auth login`)
89
+ - [Claude Code](https://claude.com/claude-code) (Skill/Agent 사용 시)
90
+ - GitHub Project V2
91
+
92
+ ## CLI 명령어
93
+
41
94
  ### 태스크 관리
42
95
 
43
96
  ```bash
44
97
  npx github-project-manager task list # 태스크 목록
45
- npx github-project-manager task list --json # JSON 출력 (Claude Code 연동)
98
+ npx github-project-manager task list --json # JSON 출력
46
99
  npx github-project-manager task show <id> # 태스크 상세
47
100
  npx github-project-manager task create <title> # 태스크 생성 (GitHub에 직접 반영)
48
- npx github-project-manager task update <id> # 태스크 수정
49
101
  npx github-project-manager task status <id> <status> # 상태 변경
50
102
  npx github-project-manager task delete <id> # 태스크 삭제
51
103
  ```
52
104
 
53
- ### 동기화
105
+ ### 동기화 & 서버
54
106
 
55
107
  ```bash
56
108
  npx github-project-manager sync # GitHub → 로컬 DB 동기화
57
- ```
58
-
59
- ### 웹 서버
60
-
61
- ```bash
62
- npx github-project-manager server # API + 웹 UI 서버 시작 (포트 6170)
109
+ npx github-project-manager server # 웹 UI 서버 시작 (포트 6170)
63
110
  npx github-project-manager server --port 8080 # 포트 변경
64
111
  npx github-project-manager server --no-open # 브라우저 자동 열기 비활성화
65
112
  ```
@@ -68,23 +115,16 @@ npx github-project-manager server --no-open # 브라우저 자동 열
68
115
 
69
116
  ## 아키텍처
70
117
 
71
- ```
72
- npx github-project-manager init (any git repo)
73
- → .gpmrc 생성 + DB에 프로젝트 등록
74
-
75
- npx github-project-manager task create "제목"
76
- → GitHub Project에 Draft Issue 직접 생성
77
-
78
- npx github-project-manager sync
79
- → GitHub → 로컬 SQLite DB (Pull only)
118
+ - **GitHub = SSOT**: 쓰기는 GitHub API에 직접 반영, 로컬 DB는 읽기 캐시 (Pull-only sync)
119
+ - **멀티 프로젝트**: 하나의 서버에서 여러 GitHub Project 관리 (`.gpmrc`로 식별)
120
+ - **CLI 독립 실행**: NestJS Standalone Mode로 서버 없이도 CLI 사용 가능
80
121
 
81
- npx github-project-manager server (port 6170)
82
- → NestJS API + React 웹 UI 단일 포트 서빙
83
122
  ```
84
-
85
- - **GitHub = SSOT**: 쓰기는 GitHub에 직접 반영, 로컬 DB는 읽기 캐시
86
- - **멀티 프로젝트**: 하나의 서버에서 여러 GitHub Project 관리
87
- - **CLI 독립 실행**: NestJS Standalone Mode로 서버 없이도 CLI 사용 가능
123
+ gpm init → .gpmrc + .claude/skills + .claude/agents 생성
124
+ gpm task create → GitHub Project에 Draft Issue 직접 생성
125
+ gpm sync → GitHub → 로컬 SQLite DB
126
+ gpm server → NestJS API + React 웹 UI (단일 포트)
127
+ ```
88
128
 
89
129
  ## 기술 스택
90
130
 
@@ -94,11 +134,11 @@ npx github-project-manager server (port 6170)
94
134
  | Backend | NestJS, TypeORM, SQLite |
95
135
  | Frontend | React, Vite, TailwindCSS |
96
136
  | GitHub API | Octokit GraphQL API v4 |
137
+ | AI 연동 | Claude Code Skill + Agent |
97
138
 
98
139
  ## 개발
99
140
 
100
141
  ```bash
101
- # 의존성 설치
102
142
  yarn install
103
143
 
104
144
  # 개발 서버 (터미널 2개)
@@ -115,9 +155,8 @@ yarn gpm -- task list
115
155
  ## 배포
116
156
 
117
157
  ```bash
118
- ./deploy.sh patch # 0.1.0 → 0.1.1
119
- ./deploy.sh minor # 0.1.0 → 0.2.0
120
- ./deploy.sh major # 0.1.0 → 1.0.0
158
+ ./deploy.sh patch # 0.1.x → patch 버전 업
159
+ ./deploy.sh minor # 0.x.0 → minor 버전 업
121
160
  ```
122
161
 
123
162
  `v*` 태그 push 시 GitHub Actions가 자동으로 npm에 배포합니다.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "github-project-manager",
3
- "version": "0.1.4",
3
+ "version": "0.2.0",
4
4
  "description": "GitHub Project V2 manager - CLI + Web UI for task management with Claude Code",
5
5
  "bin": {
6
6
  "gpm": "./apps/cli/bin/gpm.js"