projectops 4.30.1 → 4.31.1

package/README.md

@@ -1,17 +1,13 @@
 <div align="center">
 
-# 🚀 Projectops
-
-**GitHub Actions 자동화 + Agent AI Skills — 개발 사이클 전체를 자동화하는 DevOps 템플릿**
-
-> 이슈 등록부터 커밋, 보고서, 배포까지. 개발자는 코드만 작성하세요.
+<img src="https://raw.githubusercontent.com/Cassiiopeia/projectops/main/docs/images/hero.webp" alt="Projectops — 이슈부터 배포까지" width="100%">
 
 **한국어** | [English](https://github.com/Cassiiopeia/projectops/blob/main/docs/i18n/README.en.md) | [简体中文](https://github.com/Cassiiopeia/projectops/blob/main/docs/i18n/README.zh-CN.md) | [日本語](https://github.com/Cassiiopeia/projectops/blob/main/docs/i18n/README.ja.md)
 
-[![npm](https://img.shields.io/npm/v/projectops?label=npm)](https://www.npmjs.com/package/projectops) [![Release](https://img.shields.io/github/v/release/Cassiiopeia/projectops?label=release)](https://github.com/Cassiiopeia/projectops/releases) [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![npm](https://img.shields.io/npm/v/projectops?label=npm)](https://www.npmjs.com/package/projectops) [![Release](https://img.shields.io/github/v/release/Cassiiopeia/projectops?label=release)](https://github.com/Cassiiopeia/projectops/releases) [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE) [![Docs](https://img.shields.io/badge/docs-site-4f46e5)](https://cassiiopeia.github.io/projectops/)
 
 <!-- AUTO-VERSION-SECTION: DO NOT EDIT MANUALLY -->
-## 최신 버전 : v4.30.0 (2026-10-02)
+## 최신 버전 : v4.31.0 (2026-10-02)
 
 [전체 버전 기록 보기](CHANGELOG.md)
 
@@ -19,12 +15,29 @@
 
 ---
 
+## 30초 시작
+
+| 하고 싶은 일 | 실행할 것 |
+|---|---|
+| 새 프로젝트를 시작한다 | GitHub에서 **Use this template** 클릭 (1분 내 자동 초기화) |
+| 기존 프로젝트에 붙인다 | `npx projectops` |
+| Agent Skills만 설치한다 | `npx projectops --mode skills` |
+| 설치 상태를 점검한다 (읽기 전용) | `npx projectops --mode doctor` |
+
+> Node.js 20.12 이상만 있으면 됩니다. 별도 설치 없이 대화형 마법사가 실행됩니다.
+
+![npx projectops 대화형 마법사 실행 화면](https://raw.githubusercontent.com/Cassiiopeia/projectops/main/docs/images/cli-wizard.gif)
+
+> 위 화면은 샘플 Spring 프로젝트에서 **실제로 실행한 화면**입니다. 비대화형 실행과 옵션 전체는 [CLI 레퍼런스](https://cassiiopeia.github.io/projectops/CLI)를 보세요.
+
+---
+
 ## 왜 이 템플릿인가?
 
 이 프로젝트는 두 축으로 개발 워크플로우를 자동화합니다.
 
 **① GitHub Actions** — main 푸시 한 번으로 버전 관리, 체인지로그, CI/CD 배포까지 자동 처리  
-**② Agent Skills** — `/github`, `/commit`, `/report` 등 AI가 이슈 작성부터 커밋 메시지, 구현 보고서까지 대신 생성
+**② Agent Skills** — `/pro-github`, `/pro-commit`, `/pro-report` 등 AI가 이슈 작성부터 커밋 메시지, 구현 보고서까지 대신 생성
 
 | 기존 방식 | Projectops |
 |----------|---------------------|
@@ -65,7 +78,64 @@
 
 ---
 
-## AI 개발 사이클
+## 구성 요소
+
+| 구성 | 하는 일 | 문서 |
+|---|---|---|
+| **GitHub Actions** | main 푸시 한 번으로 버전 관리, 체인지로그, CI/CD 배포를 자동 처리합니다 | [버전 관리](https://cassiiopeia.github.io/projectops/VERSION-CONTROL) |
+| **Agent Skills** (20종) | `/pro-github`, `/pro-commit`, `/pro-report` 등으로 AI가 이슈·커밋 메시지·구현 보고서를 대신 만듭니다 | [Skills 가이드](https://cassiiopeia.github.io/projectops/SKILLS) |
+| **npx CLI** | 기존 프로젝트에 워크플로우를 설치·업데이트하고 상태를 진단합니다 | [CLI 레퍼런스](https://cassiiopeia.github.io/projectops/CLI) |
+
+<details>
+<summary>Agent Skills 20종 전체 보기</summary>
+
+### 🔄 개발 사이클 자동화
+
+| 스킬 | 용도 |
+|------|------|
+| `/pro-init-worktree` | Git worktree 생성 + 민감 파일 자동 복사 |
+| `/pro-commit` | 이슈 컨텍스트 기반 커밋 메시지 자동 완성 (superpowers 준수) |
+| `/pro-report` | git diff 분석 → 구현 보고서 생성 + GitHub 댓글 자동 포스팅 |
+| `/pro-changelog-deploy` | develop push → main 릴리스 PR 생성 + 릴리스 노트 작성 + automerge |
+| `/pro-github` | GitHub 전반: 이슈 생성(설명 한 줄 → 템플릿 작성+등록)/조회/수정/댓글/라벨/담당자, PR 생성/머지/조회, 레포 탐색, Actions/Secret 관리 |
+
+### 📊 분석형 (코드 수정 없음)
+
+| 스킬 | 용도 |
+|------|------|
+| `/pro-review` | 보안/성능/버그/품질 6관점 리뷰, Critical/Major/Minor 분류 |
+| `/pro-note` | 막혔을 때 과거 기록 검색, 알아낸 것을 실행 가능한 기록으로 저장 |
+
+### 🔧 구현형 (실제 코드 작성)
+
+| 스킬 | 용도 |
+|------|------|
+| `/pro-figma-verify` | Figma 시안을 코드로 옮기고, 옮긴 것이 시안과 같은지 픽셀로 센다 |
+| `/pro-build` | 프로젝트 빌드 실행, 에러 분석, 최적화 제안 |
+| `/pro-launch` | 앱·웹·서버를 띄우고 조작하고 찍는다 — 상태바 고정 캡처, 폭 바꾸기, 응답 바꿔치기(빈 목록·실패 연출), 코드 렌더 |
+| `/pro-design-brief` | 시안보다 먼저 만든 화면의 디자인 요청서 — 상태별 캡처·대안·문구 후보·꼭 지킬 것을 보드로 만들어 디자이너에게 |
+| `/pro-oss-consult` | GitHub 레포를 오픈소스로서 진단 — 성격 판별, 6축 채점, 성숙도 단계, 승인받은 것만 About·topics·라벨·파일 수정. 단일 레포·계정 전체 일괄 |
+
+> 설계·계획·구현 흐름은 `superpowers`(brainstorming → writing-plans → executing-plans)가 담당합니다.
+> `/pro-plan` · `/pro-analyze` · `/pro-implement`는 같은 역할의 이전 세대 경로로, 명시적으로 호출할 때만 동작합니다.
+> 위 표의 17종과 이 3종을 합쳐 총 20종입니다.
+
+### 📝 문서/산출물 생성형
+
+| 스킬 | 용도 |
+|------|------|
+| `/pro-testcase` | 이슈 분석 → QA 체크리스트 생성 |
+| `/pro-agent-test` | 앱·웹·서버를 실제로 실행해 밟으며 버그를 찾는 QA — 재현 절차·근거·심각도와 함께 보고 (코드는 고치지 않음) |
+| `/pro-synology-expose` | Synology NAS 외부 도메인 노출 설정 가이드 |
+| `/pro-ssh` | 원격 서버 SSH 접속·명령 실행 (AWS EC2, 시놀로지 NAS, Linux 등 범용) |
+| `/pro-skill-creator` | Skill 생성/리뷰/개선 (CREATE·REVIEW·IMPROVE 3모드) |
+
+</details>
+
+<details>
+<summary>개발 사이클과 자동화 파이프라인 흐름도 보기</summary>
+
+### AI 개발 사이클
 
 Agent Skills가 개발 사이클 전체를 커버합니다.
 
@@ -90,9 +160,7 @@ flowchart TD
 
 > Skills 전체 목록 및 상세 사용법: **[docs/SKILLS.md](docs/SKILLS.md)**
 
----
-
-## GitHub Actions 자동화 파이프라인
+### GitHub Actions 자동화 파이프라인
 
 ```mermaid
 flowchart TD
@@ -104,27 +172,10 @@ flowchart TD
     F --> G([완료])
 ```
 
----
-
-## 빠른 시작
-
-### 새 프로젝트
-
-GitHub에서 **"Use this template"** 클릭 → 1분 내 자동 초기화 완료
-
-### 기존 프로젝트에 통합
-
-**권장 — npx (macOS · Linux · Windows 공통)**
-
-```bash
-npx projectops
-```
-
-> Node.js 20.12+ 만 있으면 별도 설치 없이 대화형 마법사가 실행됩니다. 비대화형: `npx projectops --mode full --type spring,react --force`
-
-> ⚠️ 구 `template_integrator.sh` / `.ps1`은 **지원 종료(EOF)** 되었습니다 (#458). 실행하면 `npx projectops` 안내만 출력하며, 다음 minor에서 파일이 제거됩니다.
+</details>
 
-### Agent Skills만 설치
+<details>
+<summary>Agent Skills만 설치하기 (Claude Code, Gemini CLI, Codex CLI, Cursor)</summary>
 
 ```bash
 # Claude Code
@@ -155,65 +206,7 @@ npx projectops --mode skills
 
 > Claude Code는 `/pro-` 자동완성, Gemini는 extension, Codex는 plugin marketplace를 우선 사용합니다. 자세한 설치 방식은 [Skills 가이드](docs/SKILLS.md)를 확인하세요.
 
----
-
-## 주요 기능
-
-| 기능 | 설명 | 문서 |
-|------|------|------|
-| **Agent Skills** | Claude Code, Cursor, Gemini CLI, Codex CLI에서 쓰는 20종 AI DevOps Skills | [상세](docs/SKILLS.md) |
-| **버전 자동화** | 릴리스 시 커밋 제목으로 major/minor/patch 판정 + Git 태그 | [상세](docs/VERSION-CONTROL.md) |
-| **AI 체인지로그** | 생성 사다리(PR 본문 → OpenAI 호환 AI 키(Gemini·Groq 등) → 커밋 분석) 기반 CHANGELOG 자동 생성 — 키가 없어도 무료로 완주 | [상세](docs/CHANGELOG-AUTOMATION.md) |
-| **PR Preview** | 댓글 한 줄로 임시 서버 배포, 닫으면 자동 삭제 | [상세](docs/PR-PREVIEW.md) |
-| **이슈 자동화** | 브랜치명/커밋 메시지 자동 제안, QA 이슈 생성 | [상세](docs/ISSUE-AUTOMATION.md) |
-| **Flutter CI/CD** | iOS TestFlight + Android Play Store 자동 배포 | [상세](docs/FLUTTER-CICD-OVERVIEW.md) |
-| **배포 설정 마법사** | Play Store / TestFlight / Firebase App Distribution 5단계 HTML 마법사 | `.github/util/flutter/{playstore,testflight,firebase}-wizard/` |
-| **SSH+Docker 배포** | SSH 접속 서버에 Docker 무중단 배포 (Synology·AWS EC2 등) | [상세](docs/SSH-DOCKER-DEPLOYMENT-GUIDE.md) |
-
----
-
-## Agent Skills (20종)
-
-### 🔄 개발 사이클 자동화
-
-| 스킬 | 용도 |
-|------|------|
-| `/pro-init-worktree` | Git worktree 생성 + 민감 파일 자동 복사 |
-| `/pro-commit` | 이슈 컨텍스트 기반 커밋 메시지 자동 완성 (superpowers 준수) |
-| `/pro-report` | git diff 분석 → 구현 보고서 생성 + GitHub 댓글 자동 포스팅 |
-| `/pro-changelog-deploy` | develop push → main 릴리스 PR 생성 + 릴리스 노트 작성 + automerge |
-| `/pro-github` | GitHub 전반: 이슈 생성(설명 한 줄 → 템플릿 작성+등록)/조회/수정/댓글/라벨/담당자, PR 생성/머지/조회, 레포 탐색, Actions/Secret 관리 |
-
-### 📊 분석형 (코드 수정 없음)
-
-| 스킬 | 용도 |
-|------|------|
-| `/pro-review` | 보안/성능/버그/품질 6관점 리뷰, Critical/Major/Minor 분류 |
-| `/pro-note` | 막혔을 때 과거 기록 검색, 알아낸 것을 실행 가능한 기록으로 저장 |
-
-### 🔧 구현형 (실제 코드 작성)
-
-| 스킬 | 용도 |
-|------|------|
-| `/pro-figma-verify` | Figma 시안을 코드로 옮기고, 옮긴 것이 시안과 같은지 픽셀로 센다 |
-| `/pro-build` | 프로젝트 빌드 실행, 에러 분석, 최적화 제안 |
-| `/pro-launch` | 앱·웹·서버를 띄우고 조작하고 찍는다 — 상태바 고정 캡처, 폭 바꾸기, 응답 바꿔치기(빈 목록·실패 연출), 코드 렌더 |
-| `/pro-design-brief` | 시안보다 먼저 만든 화면의 디자인 요청서 — 상태별 캡처·대안·문구 후보·꼭 지킬 것을 보드로 만들어 디자이너에게 |
-| `/pro-oss-consult` | GitHub 레포를 오픈소스로서 진단 — 성격 판별, 6축 채점, 성숙도 단계, 승인받은 것만 About·topics·라벨·파일 수정. 단일 레포·계정 전체 일괄 |
-
-> 설계·계획·구현 흐름은 `superpowers`(brainstorming → writing-plans → executing-plans)가 담당합니다.
-> `/pro-plan` · `/pro-analyze` · `/pro-implement`는 같은 역할의 이전 세대 경로로, 명시적으로 호출할 때만 동작합니다.
-> 위 표의 17종과 이 3종을 합쳐 총 20종입니다.
-
-### 📝 문서/산출물 생성형
-
-| 스킬 | 용도 |
-|------|------|
-| `/pro-testcase` | 이슈 분석 → QA 체크리스트 생성 |
-| `/pro-agent-test` | 앱·웹·서버를 실제로 실행해 밟으며 버그를 찾는 QA — 재현 절차·근거·심각도와 함께 보고 (코드는 고치지 않음) |
-| `/pro-synology-expose` | Synology NAS 외부 도메인 노출 설정 가이드 |
-| `/pro-ssh` | 원격 서버 SSH 접속·명령 실행 (AWS EC2, 시놀로지 NAS, Linux 등 범용) |
-| `/pro-skill-creator` | Skill 생성/리뷰/개선 (CREATE·REVIEW·IMPROVE 3모드) |
+</details>
 
 ---
 
@@ -270,30 +263,6 @@ Settings → Actions → General
 
 ---
 
-## 문서
-
-전체 목록은 **[문서 인덱스](docs/README.md)**를 참고하세요.
-
-| 문서 | 설명 |
-|------|------|
-| [📚 문서 인덱스](docs/README.md) | docs 전체를 목적별로 안내 |
-| [Agent Skills 가이드](docs/SKILLS.md) | 20종 Skills 용도, 사용법, 전체 개발 사이클 흐름 |
-| [NPX 마법사 가이드](docs/NPX-WIZARD.md) | npx projectops 통합, 프로젝트 성격(intent), 배포/publish 2축, 레거시 자동 마이그레이션 |
-| [통합 스크립트 가이드](docs/TEMPLATE-INTEGRATOR.md) | 구 integrator 지원 종료(EOF) 안내 |
-| [버전 관리](docs/VERSION-CONTROL.md) | version.yml, 자동 버전 증가 |
-| [체인지로그 자동화](docs/CHANGELOG-AUTOMATION.md) | 릴리스 PR 흐름, 릴리스 노트 provider 사다리, CodeRabbit 연동 |
-| [PR Preview](docs/PR-PREVIEW.md) | 임시 서버 배포 시스템 |
-| [Flutter CI/CD](docs/FLUTTER-CICD-OVERVIEW.md) | iOS/Android 자동 배포, GitHub Secrets 전체 목록 |
-| [Flutter 마법사](docs/FLUTTER-TESTFLIGHT-WIZARD.md) | [TestFlight](docs/FLUTTER-TESTFLIGHT-WIZARD.md) / [Play Store](docs/FLUTTER-PLAYSTORE-WIZARD.md) / [Firebase](docs/FLUTTER-FIREBASE-WIZARD.md) 배포 설정 마법사 |
-| [SSH+Docker 배포](docs/SSH-DOCKER-DEPLOYMENT-GUIDE.md) | SSH 접속 서버에 Docker 배포 (Synology·AWS EC2 등) |
-| [이슈 자동화](docs/ISSUE-AUTOMATION.md) | Issue Helper, QA 봇 |
-| [GitHub Projects 동기화](docs/PROJECTS-SYNC.md) | Issue Label ↔ Projects Status 동기화 ([마법사](docs/GITHUB-PROJECTS-SYNC-WIZARD.md)) |
-| [브랜치 네이밍 규칙](docs/BRANCH-CONVENTION.md) | `YYYYMMDD_#번호_제목` 규칙과 의존 소비자 (유지보수자용) |
-| [워크플로우 주석 표준](docs/WORKFLOW-COMMENT-GUIDELINES.md) | 주석 컨벤션, 파일별 적용 현황 (기여자용) |
-| [트러블슈팅](docs/TROUBLESHOOTING.md) | 자주 발생하는 문제 해결 |
-
----
-
 ## 알아둘 것
 
 맞지 않는 경우를 먼저 알려 드립니다.
@@ -305,6 +274,23 @@ Settings → Actions → General
 
 ---
 
+## 문서
+
+전체 문서는 **[문서 사이트](https://cassiiopeia.github.io/projectops/)** 에서 검색하며 볼 수 있습니다.
+
+- [시작하기](https://cassiiopeia.github.io/projectops/GETTING-STARTED)
+- [CLI 레퍼런스](https://cassiiopeia.github.io/projectops/CLI)
+- [Agent Skills 가이드](https://cassiiopeia.github.io/projectops/SKILLS)
+- [버전 관리](https://cassiiopeia.github.io/projectops/VERSION-CONTROL)
+- [체인지로그 자동화](https://cassiiopeia.github.io/projectops/CHANGELOG-AUTOMATION)
+- [PR Preview](https://cassiiopeia.github.io/projectops/PR-PREVIEW)
+- [이슈 자동화](https://cassiiopeia.github.io/projectops/ISSUE-AUTOMATION)
+- [SSH + Docker 배포](https://cassiiopeia.github.io/projectops/SSH-DOCKER-DEPLOYMENT-GUIDE)
+- [Flutter CI/CD](https://cassiiopeia.github.io/projectops/FLUTTER-CICD-OVERVIEW)
+- [트러블슈팅](https://cassiiopeia.github.io/projectops/TROUBLESHOOTING)
+
+---
+
 ## 지원
 
 - [Issues](https://github.com/Cassiiopeia/projectops/issues) — 버그 리포트, 기능 요청

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "projectops",
-  "version": "4.30.1",
+  "version": "4.31.1",
   "description": "ProjectOps — 완전 자동화 GitHub 프로젝트 관리 템플릿 통합 CLI",
   "keywords": [
     "devops",

package/src/core/exclusions.js

@@ -24,7 +24,9 @@ export const PLUGIN_ITEMS_TO_REMOVE = [
   "harness",
   "bin",
   "src",
+  "site",
   ".github/workflows/PROJECT-TEMPLATE-PLUGIN-VERSION-SYNC.yaml",
   ".github/workflows/PROJECT-TEMPLATE-NPM-PUBLISH.yaml",
+  ".github/workflows/PROJECT-TEMPLATE-DOCS-DEPLOY.yaml",
 ];
 // ⚠️ skills/ 는 제외하지 않는다 (Cursor 설치 소스로 보존)