projectops 3.0.183

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 Cassiiopeia
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/README.md

@@ -0,0 +1,274 @@
+<div align="center">
+
+# 🚀 SUH-DEVOPS-TEMPLATE
+
+**GitHub Actions 자동화 + Agent AI Skills — 개발 사이클 전체를 자동화하는 DevOps 템플릿**
+
+> 이슈 등록부터 커밋, 보고서, 배포까지. 개발자는 코드만 작성하세요.
+
+<!-- AUTO-VERSION-SECTION: DO NOT EDIT MANUALLY -->
+## 최신 버전 : v3.0.182 (2026-07-02)
+
+[전체 버전 기록 보기](CHANGELOG.md)
+
+</div>
+
+---
+
+## 왜 이 템플릿인가?
+
+이 프로젝트는 두 축으로 개발 워크플로우를 자동화합니다.
+
+**① GitHub Actions** — main 푸시 한 번으로 버전 관리, 체인지로그, CI/CD 배포까지 자동 처리  
+**② Agent Skills** — `/issue`, `/commit`, `/report` 등 AI가 이슈 작성부터 커밋 메시지, 구현 보고서까지 대신 생성
+
+| 기존 방식 | SUH-DEVOPS-TEMPLATE |
+|----------|---------------------|
+| 버전 수동 관리, 태그 직접 생성 | main 푸시 시 patch 버전 자동 증가 + 태그 생성 |
+| 체인지로그 직접 작성 (30분+) | CodeRabbit AI가 PR마다 자동 생성 |
+| CI/CD 처음부터 설정 | 프로젝트 타입별 워크플로우 즉시 구성 |
+| 이슈 매번 형식 맞춰 작성 (5분+) | `/cassiiopeia:suh-issue` 한 번에 표준 템플릿 생성 |
+| 커밋 메시지 이슈 URL 수동 복사 | `/cassiiopeia:suh-commit` 이슈 컨텍스트 기반 자동 완성 |
+| PR 설명/보고서 직접 작성 | `/cassiiopeia:suh-report` git diff 분석 후 자동 생성 |
+| 코드 리뷰·분석 매번 프롬프트 입력 | 25종 Skills로 일관된 결과, 매번 재입력 불필요 |
+
+---
+
+## AI 개발 사이클
+
+Agent Skills가 개발 사이클 전체를 커버합니다.
+
+```mermaid
+flowchart TD
+    A([작업 시작]) --> B["/cassiiopeia:suh-issue\n이슈 등록 + GitHub 자동 생성"]
+    B --> C["/cassiiopeia:suh-init-worktree\nworktree + 민감파일 자동 복사"]
+    C --> D{작업 유형}
+
+    D -->|새 기능| E1["/cassiiopeia:suh-plan\n전략 수립"]
+    D -->|버그| E2["/cassiiopeia:suh-troubleshoot\n원인 분석"]
+    D -->|리팩토링| E3["/cassiiopeia:suh-refactor-analyze\nSmell 탐지"]
+
+    E1 --> F["/cassiiopeia:suh-implement\n구현"]
+    E2 --> F
+    E3 --> F
+    F --> G["/cassiiopeia:suh-test\n테스트"]
+    G --> H["/cassiiopeia:suh-review\n셀프 리뷰"]
+    H --> I["/cassiiopeia:suh-commit\n이슈 연동 커밋 자동 완성"]
+    I --> J["/cassiiopeia:suh-report\n구현 보고서 + GitHub 댓글"]
+    J --> K([PR 등록])
+    K --> L["/cassiiopeia:suh-changelog-deploy\nmain push → deploy PR + automerge"]
+```
+
+> Skills 전체 목록 및 상세 사용법: **[docs/SKILLS.md](docs/SKILLS.md)**
+
+---
+
+## GitHub Actions 자동화 파이프라인
+
+```mermaid
+flowchart TD
+    A([main 푸시]) --> B[버전 자동 증가\npatch +1 + 태그]
+    B --> C[deploy PR 자동 생성]
+    C --> D[AI 체인지로그\nCodeRabbit 분석]
+    D --> E[자동 머지]
+    E --> F[CI/CD 배포\nFlutter / Spring / React 등]
+    F --> G([완료])
+```
+
+---
+
+## 빠른 시작
+
+### 새 프로젝트
+
+GitHub에서 **"Use this template"** 클릭 → 1분 내 자동 초기화 완료
+
+### 기존 프로젝트에 통합
+
+```bash
+# macOS / Linux
+bash <(curl -fsSL "https://raw.githubusercontent.com/Cassiiopeia/SUH-DEVOPS-TEMPLATE/main/template_integrator.sh")
+```
+
+```powershell
+# Windows PowerShell
+$wc=New-Object Net.WebClient;$wc.Encoding=[Text.Encoding]::UTF8;iex $wc.DownloadString("https://raw.githubusercontent.com/Cassiiopeia/SUH-DEVOPS-TEMPLATE/main/template_integrator.ps1")
+```
+
+### Agent Skills만 설치
+
+```bash
+# Claude Code
+claude plugin marketplace add Cassiiopeia/SUH-DEVOPS-TEMPLATE
+claude plugin install cassiiopeia@cassiiopeia-marketplace --scope user
+```
+
+```bash
+# Gemini CLI
+gemini extensions install https://github.com/Cassiiopeia/SUH-DEVOPS-TEMPLATE
+```
+
+```bash
+# Codex CLI (macOS / Linux)
+codex plugin marketplace add Cassiiopeia/SUH-DEVOPS-TEMPLATE
+```
+
+`template_integrator --mode skills` 마법사는 Codex marketplace를 등록한 뒤 native skills fallback도 자동 준비합니다. `/plugins`는 설치 확인/관리용으로만 사용하면 됩니다.
+
+Codex plugin marketplace를 사용할 수 없는 환경에서는 [Skills 가이드](docs/SKILLS.md)의 fallback 설치 방식을 사용하세요.
+
+```bash
+# Cursor / 전체 Agent Skills 설치 메뉴
+bash <(curl -fsSL "https://raw.githubusercontent.com/Cassiiopeia/SUH-DEVOPS-TEMPLATE/main/template_integrator.sh") --mode skills
+```
+
+> Claude Code는 `/cassiiopeia:` 자동완성, Gemini는 extension, Codex는 plugin marketplace를 우선 사용합니다. 자세한 설치 방식은 [Skills 가이드](docs/SKILLS.md)를 확인하세요.
+
+---
+
+## 주요 기능
+
+| 기능 | 설명 | 문서 |
+|------|------|------|
+| **Agent Skills** | Claude Code, Cursor, Gemini CLI, Codex CLI에서 쓰는 25종 AI DevOps Skills | [상세](docs/SKILLS.md) |
+| **버전 자동화** | main 푸시 시 patch 버전 자동 증가 + Git 태그 | [상세](docs/VERSION-CONTROL.md) |
+| **AI 체인지로그** | CodeRabbit 리뷰 기반 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 (25종)
+
+### 🔄 개발 사이클 자동화
+
+| 스킬 | 용도 |
+|------|------|
+| `/cassiiopeia:suh-issue` | 설명 한 줄 → GitHub 이슈 템플릿 자동 작성 + 등록 |
+| `/cassiiopeia:suh-init-worktree` | Git worktree 생성 + 민감 파일 자동 복사 |
+| `/cassiiopeia:suh-commit` | 이슈 컨텍스트 기반 커밋 메시지 자동 완성 (superpowers 준수) |
+| `/cassiiopeia:suh-report` | git diff 분석 → 구현 보고서 생성 + GitHub 댓글 자동 포스팅 |
+| `/cassiiopeia:suh-changelog-deploy` | main push → deploy PR 생성 + 릴리스 노트 작성 + automerge |
+| `/cassiiopeia:suh-github` | GitHub 이슈/PR/댓글 독립 조회 및 관리 |
+
+### 📊 분석형 (코드 수정 없음)
+
+| 스킬 | 용도 |
+|------|------|
+| `/cassiiopeia:suh-analyze` | 구현 전 현재 코드 상태 분석 및 영향 범위 평가 |
+| `/cassiiopeia:suh-plan` | 요구사항 명확화 + 2가지 이상 접근 방식 비교로 전략 수립 |
+| `/cassiiopeia:suh-design-analyze` | 아키텍처/API/DB/UI 설계 분석 (구현 X) |
+| `/cassiiopeia:suh-refactor-analyze` | Code Smell 탐지 + Before/After 기반 리팩토링 계획 |
+| `/cassiiopeia:suh-review` | 보안/성능/버그/품질 6관점 리뷰, Critical/Major/Minor 분류 |
+| `/cassiiopeia:suh-troubleshoot` | 가설-검증 방식 근본 원인 분석, Quick Fix/Root Fix 제시 |
+
+### 🔧 구현형 (실제 코드 작성)
+
+| 스킬 | 용도 |
+|------|------|
+| `/cassiiopeia:suh-implement` | 계획/분석 결과 기반 코드 구현 (기존 스타일 100% 준수) |
+| `/cassiiopeia:suh-design` | 아키텍처/API/DB/UI 설계 + 구현까지 |
+| `/cassiiopeia:suh-refactor` | Extract Method, DRY 등 리팩토링 기법 단계별 적용 |
+| `/cassiiopeia:suh-test` | AAA 패턴 단위/통합/E2E 테스트 코드 작성 |
+| `/cassiiopeia:suh-figma` | Figma CSS → React/RN/Flutter 반응형 코드 변환 |
+| `/cassiiopeia:suh-build` | 프로젝트 빌드 실행, 에러 분석, 최적화 제안 |
+
+### 📝 문서/산출물 생성형
+
+| 스킬 | 용도 |
+|------|------|
+| `/cassiiopeia:suh-document` | 코드 주석/README/API 문서 작성 |
+| `/cassiiopeia:suh-testcase` | 이슈 분석 → QA 체크리스트 생성 |
+| `/cassiiopeia:suh-ppt` | 트러블슈팅/구현 사례 → 5섹션 발표자료 |
+| `/cassiiopeia:suh-spring-test` | Spring Boot 테스트 샘플 코드 생성 |
+| `/cassiiopeia:suh-synology-expose` | Synology NAS 외부 도메인 노출 설정 가이드 |
+| `/cassiiopeia:suh-ssh` | 원격 서버 SSH 접속·명령 실행 (AWS EC2, 시놀로지 NAS, Linux 등 범용) |
+| `/cassiiopeia:suh-skill-creator` | Skill 생성/리뷰/개선 (CREATE·REVIEW·IMPROVE 3모드) |
+
+---
+
+## 지원 프로젝트 타입
+
+| 타입 | 버전 파일 | CI/CD |
+|------|----------|-------|
+| `spring` | build.gradle | SSH+Docker 배포, Nexus |
+| `flutter` | pubspec.yaml | TestFlight, Play Store |
+| `react` | package.json | Docker |
+| `next` | package.json | Docker |
+| `node` | package.json | Docker |
+| `python` | pyproject.toml | SSH+Docker 배포 |
+| `react-native` | Info.plist + build.gradle | — |
+| `react-native-expo` | app.json | — |
+| `basic` | version.yml만 | — |
+
+---
+
+## 댓글 명령어
+
+Issue나 PR에 댓글로 자동화를 실행합니다.
+
+| 명령어 | 기능 | 대상 |
+|--------|------|------|
+| `@suh-lab server build` | 임시 서버 배포 | Spring, Python |
+| `@suh-lab server destroy` | 서버 삭제 | Spring, Python |
+| `@suh-lab server status` | 서버 상태 확인 | Spring, Python |
+| `@suh-lab build app` | iOS + Android 빌드 | Flutter |
+| `@suh-lab apk build` | Android만 빌드 | Flutter |
+| `@suh-lab ios build` | iOS만 빌드 | Flutter |
+| `@suh-lab create qa` | QA 이슈 자동 생성 | 모든 프로젝트 |
+
+> 상세: [PR Preview](docs/PR-PREVIEW.md) | [Flutter 빌드](docs/FLUTTER-TEST-BUILD-TRIGGER.md) | [이슈 자동화](docs/ISSUE-AUTOMATION.md)
+
+---
+
+## 설정
+
+### 필수 Secret
+
+```
+Repository Settings → Secrets → Actions → New repository secret
+Name: _GITHUB_PAT_TOKEN
+Value: [Personal Access Token - repo, workflow 권한]
+```
+
+### Organization 설정
+
+```
+Settings → Actions → General
+├─ ✅ Allow GitHub Actions to create and approve pull requests
+└─ ✅ Read and write permissions
+```
+
+---
+
+## 문서
+
+| 문서 | 설명 |
+|------|------|
+| [Agent Skills 가이드](docs/SKILLS.md) | 25종 Skills 용도, 사용법, 전체 개발 사이클 흐름 |
+| [통합 스크립트 가이드](docs/TEMPLATE-INTEGRATOR.md) | 기존 프로젝트에 템플릿 통합 |
+| [버전 관리](docs/VERSION-CONTROL.md) | version.yml, 자동 버전 증가 |
+| [체인지로그 자동화](docs/CHANGELOG-AUTOMATION.md) | CodeRabbit 연동, AI 문서화 |
+| [PR Preview](docs/PR-PREVIEW.md) | 임시 서버 배포 시스템 |
+| [Flutter CI/CD](docs/FLUTTER-CICD-OVERVIEW.md) | iOS/Android 자동 배포 |
+| [SSH+Docker 배포](docs/SSH-DOCKER-DEPLOYMENT-GUIDE.md) | SSH 접속 서버에 Docker 배포 (Synology·AWS EC2 등) |
+| [이슈 자동화](docs/ISSUE-AUTOMATION.md) | Issue Helper, QA 봇 |
+| [트러블슈팅](docs/TROUBLESHOOTING.md) | 자주 발생하는 문제 해결 |
+
+---
+
+## 지원
+
+- [Issues](https://github.com/Cassiiopeia/SUH-DEVOPS-TEMPLATE/issues) — 버그 리포트, 기능 요청
+- [CONTRIBUTING.md](CONTRIBUTING.md) — 기여 가이드
+
+---
+
+<div align="center">
+
+**MIT License**
+
+</div>

package/bin/projectops.js

@@ -0,0 +1,45 @@
+#!/usr/bin/env node
+// projectops 스텁 CLI — 이름 선점 및 배포 파이프라인 검증용 (SP1)
+// 마법사 본체(SP2)가 이식되기 전까지 기존 template_integrator 안내를 제공한다.
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+
+const nodeMajor = Number(process.versions.node.split(".")[0]);
+if (nodeMajor < 18) {
+  console.error(`Node.js 18 이상이 필요합니다 (현재: ${process.versions.node})`);
+  process.exit(1);
+}
+
+const pkg = JSON.parse(
+  readFileSync(join(dirname(fileURLToPath(import.meta.url)), "..", "package.json"), "utf8"),
+);
+
+const args = process.argv.slice(2);
+if (args.includes("--version") || args.includes("-v")) {
+  console.log(pkg.version);
+  process.exit(0);
+}
+
+const RESET = "\x1b[0m";
+const CYAN = "\x1b[36m";
+const GREEN = "\x1b[32m";
+const YELLOW = "\x1b[33m";
+const DIM = "\x1b[2m";
+
+console.log(`
+${CYAN}=========================================================
+  ProjectOps v${pkg.version}
+  완전 자동화 GitHub 프로젝트 관리 템플릿 통합 CLI
+=========================================================${RESET}
+
+${YELLOW}npx 마법사는 준비 중입니다.${RESET} 지금은 아래 기존 방식으로 통합하세요.
+
+${GREEN}macOS / Linux:${RESET}
+  bash <(curl -fsSL "https://raw.githubusercontent.com/Cassiiopeia/SUH-DEVOPS-TEMPLATE/main/template_integrator.sh")
+
+${GREEN}Windows (PowerShell):${RESET}
+  $wc=New-Object Net.WebClient;$wc.Encoding=[Text.Encoding]::UTF8;iex $wc.DownloadString("https://raw.githubusercontent.com/Cassiiopeia/SUH-DEVOPS-TEMPLATE/main/template_integrator.ps1")
+
+${DIM}문서: https://github.com/Cassiiopeia/SUH-DEVOPS-TEMPLATE${RESET}
+`);

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "projectops",
+  "version": "3.0.183",
+  "description": "ProjectOps — 완전 자동화 GitHub 프로젝트 관리 템플릿 통합 CLI (구 SUH-DEVOPS-TEMPLATE 마법사)",
+  "keywords": [
+    "devops",
+    "automation",
+    "github-actions",
+    "template",
+    "cli",
+    "pi-package"
+  ],
+  "license": "MIT",
+  "author": {
+    "name": "Cassiiopeia",
+    "url": "https://github.com/Cassiiopeia"
+  },
+  "homepage": "https://github.com/Cassiiopeia/SUH-DEVOPS-TEMPLATE",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Cassiiopeia/SUH-DEVOPS-TEMPLATE.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Cassiiopeia/SUH-DEVOPS-TEMPLATE/issues"
+  },
+  "type": "module",
+  "bin": {
+    "projectops": "bin/projectops.js"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "bin/"
+  ],
+  "pi": {
+    "skills": [
+      "./skills"
+    ]
+  }
+}