Stats
Links
Categories
gx-pm
공공/SI PM의 AI 운영 체제
요구사항 분석부터 테스트 계획, ID 추적, 감리 대응까지
이게 뭔가요?
gx-pm은 공공/SI 프로젝트의 PM을 위한 Claude Code 플러그인입니다.
RFP를 넣으면 요구사항을 뽑아주고, 화면목록표와 프로그램정의서를 만들어주고, DDL에서 테이블정의서를 변환해주고, 테스트 계획서를 자동 생성하고, 산출물 간 ID가 끊기지 않았는지 추적합니다. 감리가 오면 지적사항 대응 문서까지 만들어줍니다.
v1.3.0 신규: 개발 완료 후 산출물을 맞춰야 할 때, 소스코드와 DB에서 산출물을 역생성할 수 있습니다. /프로젝트설정 한 번이면 모든 커맨드가 프로젝트 상황에 맞게 자동 동작합니다.
일반 PM 도구와 뭐가 다른가요?
| 일반 PM 플러그인 (pm-skills 등) | gx-pm |
|---|---|
| PRD, OKR, 로드맵 | 화면정의서, 요구사항 추적표, 인수테스트 |
| GTM, 그로스 루프 | 감리 대응, 범위 협상, 공수 산정 |
| TAM/SAM/SOM | WBS 분해, 진척률 분석 |
| 영어 중심 프레임워크 | 한국어 공공/SI 문서 양식 |
설치
Claude Desktop 앱 (Code 탭)
- 좌하단 사용자 지정 클릭
- 개인 플러그인 옆
+버튼 → 플러그인 탐색 - 상단 개인 탭 →
+버튼 → URL에bs-koo/gx-pm입력 → 추가 - gx-pm 탭 선택 → 설치
- 프로젝트에서
/요구사항정의서등 슬래시 커맨드로 사용
Claude Code CLI
# Claude Code CLI에서 실행
/plugin marketplace add bs-koo/gx-pm
/plugin install gx-pm@gx-pm
사용법
처음 시작할 때
/프로젝트설정
프로젝트 유형, 기본 정보, 소스코드 경로, DDL을 한 번 설정하면 이후 모든 커맨드가 자동으로 활용합니다. 새 대화를 열어도 설정이 유지됩니다.
프로젝트 유형 4가지
| 유형 | 언제 사용 | 커맨드 동작 |
|---|---|---|
| A. 신규 구축 | RFP만 있고, 코드 없음 | 정방향 생성 (RFP → 산출물) |
| B. 추가 개발 | 기존 시스템에 새 기능 추가 | 기존 산출물에 이어쓰기 |
| C. 산출물 정비 | 개발 완료, 산출물 부족 | 소스/DB에서 역생성 |
| D. 변경 관리 | 기존 기능 수정 | 변경 대상만 갱신 |
커맨드 목록
커맨드 이름 = 산출물 이름입니다. 만들고 싶은 산출물을 그대로 입력하면 됩니다.
| 이렇게 말하면 | 커맨드 | 결과물 |
|---|---|---|
| "프로젝트 설정해줘" | /프로젝트설정 | profile.json (프로젝트 프로파일) |
| "요구사항 뽑아줘" | /요구사항정의서 | AN-02 요구사항정의서 |
| "화면 설계해줘" | /화면목록표 | DE-03 화면목록표 |
| "프로그램 구조 잡아줘" | /프로그램정의서 | DE-05 프로그램정의서 |
| "외부 연동 정의해줘" | /인터페이스정의서 | 인터페이스정의서 |
| "DDL로 테이블정의서 만들어줘" | /테이블정의서 | DE-08 테이블정의서 |
| "단위테스트 계획 세워줘" | /단위테스트계획서 | DE-13 단위테스트계획서 |
| "통합테스트 시나리오 만들어줘" | /통합테스트시나리오 | DE-14 통합테스트시나리오 |
| "추적매트릭스 확인해줘" | /추적매트릭스 | AN-05 추적매트릭스 |
| "감리 지적사항 대응해줘" | /감리대응 | 감리 대응 문서 + 증빙 체크리스트 |
| "테스트 결과 기입해줘" | /테스트결과서 | IM-03 / TE-02 / TE-06 결과서 |
핵심 기능
1. 단계별 승인 루프
모든 커맨드는 산출물을 한 번에 생성하지 않습니다. 각 단계마다 사용자 확인을 받고, 수정 요청이 있으면 반영한 뒤 다시 확인합니다.
[산출물 생성] → [결과 표시] → 승인? → No → [수정 반영] → [다시 표시] → 승인? → ...
→ Yes → [다음 단계]
2. 시안/대안 자동 감지
요구사항에 "1안/2안", "A안/B안" 등 복수 시안이 있으면 자동 감지하여 사용자에게 선택을 요청합니다. 선택 전에는 산출물 생성을 시작하지 않습니다.
⚠ 시안 선택이 필요합니다
1안: 이중 슬라이더 단일 화면 → 화면 5개 예상
2안: 쾌적성/온도 별도 메뉴 → 화면 8개 예상
→ 어떤 시안으로 진행할까요? (1/2/병행)
3. 기존 산출물 처리
커맨드 실행 시 기존 산출물이 있으면 3가지 선택지를 제공합니다:
기존 요구사항정의서를 찾았습니다:
B-요구사항정의서.md (35건, 마지막 수정: 1/15)
1. 이어쓰기 — 기존 유지 + 새 항목 추가 (B-RE-036부터)
2. 새로쓰기 — backup/ 폴더에 백업 후 처음부터 재생성
3. 열기 — 기존 내용에서 특정 항목만 수정/삭제
4. 소스코드/DB에서 역생성 (C유형)
개발 완료 후 산출물을 맞출 때, 소스코드와 DB 스키마에서 산출물을 자동 역생성합니다:
| 소스 | 역생성 산출물 | 방식 |
|---|---|---|
| Controller/Service/DAO/JSP | 프로그램정의서 (DE-05) | 소스 스캔으로 역추출 |
| DDL (DataGrip/DBeaver 복사) | 테이블정의서 (DE-08) | DDL 파싱 + 한글명 추론 |
| JPA Entity 클래스 | 테이블정의서 (DE-08) | @Table/@Column 스캔 |
| HTTP 클라이언트 호출 코드 | 인터페이스정의서 | API 연동 코드 탐지 |
소스코드 스캔은 3단계 점진 스캔으로 토큰을 99% 절약합니다 (풀스캔 200만 → 1.7만 토큰).
5. xlsx 추출
승인된 산출물은 공공 양식 컬럼 순서에 맞춘 xlsx로 즉시 추출할 수 있습니다. 실제 산출물 엑셀에 바로 복사-붙여넣기가 가능합니다.
# CLI에서 직접 사용할 수도 있습니다
python utils/export-xlsx.py --dir 결과물/ --output 산출물.xlsx
프로젝트 흐름
A. 신규 구축 (정방향)
/프로젝트설정 (A유형)
↓
/요구사항정의서 → /화면목록표 → /프로그램정의서 → /테이블정의서
↓ ↓ ↓
/인터페이스정의서 /단위테스트계획서 /통합테스트시나리오
↓ ↓
/추적매트릭스 (누락 탐지)
↓
/테스트결과서 → /감리대응
C. 산출물 정비 (역방향)
/프로젝트설정 (C유형 + 소스경로 + DDL)
↓
/프로그램정의서 ← 소스코드 스캔 역생성
/테이블정의서 ← DDL/Entity 역생성
/인터페이스정의서 ← API 호출 코드 역추출
↓
/추적매트릭스 (누락 탐지)
핵심: ID 추적 체인
공공/SI 프로젝트에서 감리 대응의 핵심은 산출물 간 추적성입니다. gx-pm은 모든 산출물을 하나의 ID 체인으로 연결합니다.
제안요청ID (SFR-027)
└→ 요구사항ID (B-RE-001)
└→ 화면ID (EHR_01_01_010)
└→ 프로그램ID (PG_EHR_01_01_010)
└→ 단위테스트ID (U_EHR_01_01_010)
└→ 통합테스트ID (B-TE-001)
/추적매트릭스로 언제든 추적 상태를 확인할 수 있습니다 (모든 유형에서 사용 가능):
┌─ 제안요청: SFR-027
├─ 요구사항: B-RE-003 (교육 과정 관리)
│ ├─ 화면: EHR_03_01_010 (과정 목록) ✅
│ │ ├─ 프로그램: PG_EHR_03_01_010 ✅
│ │ └─ 단위테스트: U_EHR_03_01_010 ✅
│ ├─ 화면: EHR_03_01_020 (과정 등록) ✅
│ │ ├─ 프로그램: PG_EHR_03_01_020 ✅
│ │ └─ 단위테스트: U_EHR_03_01_020 ⚠ 누락
│ └─ 통합테스트: B-TE-002 ✅
└─ 과업완료: ⚠ 진행중 (단위테스트 1건 누락)