v1.1.6 - 스킬 워크플로우 Phase/Step 체계 전면 재구조화

v1.1.6 - 스킬 워크플로우 Phase/Step 체계 전면 재구조화

릴리스 날짜: 2026-04-28
릴리스 유형: Minor

핵심 변경사항

• Phase·Step 계층 체계 도입: plan/design/develop/deploy/cicd 5개 핵심 스킬을 Phase·Step 트리로 재구조화하여 워크플로우 가시성·일관성 강화
• SKILL.md 슬림화: develop·deploy·cicd 가이드 추출로 SKILL.md 사이즈 평균 50% 감축, 컨텍스트 로딩 비용 절감
• OMC 부스트 표기 제거: /ralph, /ralplan, /ultraqa 등 OMC 스킬 부스트 의존성 제거하여 표준 워크플로우만 유지
• 표준 섹션 도입: 활성화 조건, 작업 환경 변수 로드, 진행상황 업데이트 및 재개 섹션을 모든 스킬에 일관 적용
• MCP / Gemini / OAuth 가이드 신설: 환경 셋업·인증·이미지 생성 도구 자동화 지원

상세 변경사항

새로운 기능 (New Features)

• 물리 아키텍처 설계 커맨드 추가: 별도 커맨드로 물리 아키텍처 설계 단계 분리 (v1.0.1)
• MCP 설정 가이드 신설: MCP 서버 설치·설정 가이드 + 플러그인 통합 (v1.1.2)
• Gemini 워크플로우 추가: Gemini API 연동 + Nano Banana 이미지 생성 도구
• OAuth 인증 가이드 추가: GitHub/Google/Kakao Provider 통합 인증 가이드
• convert-to-markdown 도구 추가: 외부 문서 마크다운 변환 도구 + 설명 문서
• 프론트엔드 검증 POST_ACTION: develop 스킬에 프론트엔드 통합 후 검증 단계 추가 (v1.0.5)
• 프론트엔드 개발 가이드 G1~G10 갭 해소: 모노레포·라우팅·상태관리 등 갭 식별·개선

개선사항 (Improvements)

스킬 워크플로우 재구조화

• Phase·Step 계층 체계 전면 도입: plan(Phase 06), design(Phase 04), develop(Phase 05), deploy(Phase 06), cicd(Phase 0~4)
• 각 Phase 하위 Step 1부터 시작, sub-step Step N-M 형식 통일, sub-sub N-Ma 형식
• MUST 규칙·완료 조건·검증 프로토콜을 Phase/Step 체계에 맞게 일관 보정

가이드 추출로 SKILL.md 슬림화

• develop/SKILL.md: 970 → 500라인 (46% 감축, 6개 신규 가이드 분리: phase0-presetup, conditional-branching-protocol, test-browser-auto, test-browser-manual, product-verify, dev-complete)
• deploy/SKILL.md: 848 → 328라인 (61% 감축, 4개 신규 가이드 분리: phase0-deploy-mode, deploy-env-info, nginx-proxy-setup, vm-git-sync)
• cicd/SKILL.md: 784 → 377라인 (52% 감축, 4개 신규 가이드 분리: phase0-presetup, phase2-argocd-setup, phase3-pipeline-creation, cicd-runinfo-templates)

표준 섹션 도입

• ## 활성화 조건 신설 (모든 핵심 스킬)
• ## 작업 환경 변수 로드 신설
• ## 진행상황 업데이트 및 재개 신설 (기존 상태 기록 섹션 흡수)
• ## 취소·## 재개 섹션 삭제 (진행상황 섹션이 대체)
• 프롬프트 조립 단순화 (combine-prompt.md 형식 통일)

OMC 부스트 제거

• /ralph·/ralplan·/ultraqa 표기 모두 제거 (35건)
• 에이전트 모드 매핑 표 단순화/제거

경로/변수 체계

• PLUGIN_DIR 변수 해석 추가 + 모든 SKILL.md/commands에 {PLUGIN_DIR}/ 접두사 적용
• NPD_PLUGIN_DIR 중복 설정 방지 로직 추가

문서/가이드

• README 및 환경 준비 가이드 갱신 (구독별 셋업 안내, 새탭 열기)
• create 스킬: 플러그인 디렉토리 권한 설정 Step 추가 + 파일명 정규화
• 스킬별 분산 settings 파일을 통합 settings.md로 대체
• subagent 호출 의무 규칙 추가 (모든 SKILL.md MUST 규칙)
• advisor 활용 가이드 추가

테스트/품질

• Phase 4 / Step 2 (제품 검증) 단순화: 회귀 TC 별도 재실행 제거 → PO/SP 재검증 4종 범위로 통합 (변경 페이지·직접 의존 페이지·핵심 사용자 플로우·데이터 정합성 spot check)

기타

• generate_image.py: .env 위치를 호출 시점의 현재 작업 디렉토리(프로젝트 루트)로 변경
• 파일명 정규화 및 디렉토리 정리 (gemini-workflows, output 등)

다음 단계

• 스킬별 smoke test 진행 (/npd:plan, /npd:design, /npd:develop, /npd:deploy, /npd:cicd)
• 가이드 분리 후 잔여 본문 정합성 검증
• 통합 settings.md 기반 환경 셋업 워크플로우 검증