{
  "markdown": "<div align=\"center\">\n\n# 🚀 Projectops\n\n**GitHub Actions 자동화 + Agent AI Skills — 개발 사이클 전체를 자동화하는 DevOps 템플릿**\n\n> 이슈 등록부터 커밋, 보고서, 배포까지. 개발자는 코드만 작성하세요.\n\n<!-- AUTO-VERSION-SECTION: DO NOT EDIT MANUALLY -->\n## 최신 버전 : v4.2.45 (2026-08-08)\n\n[전체 버전 기록 보기](CHANGELOG.md)\n\n</div>\n\n---\n\n## 왜 이 템플릿인가?\n\n이 프로젝트는 두 축으로 개발 워크플로우를 자동화합니다.\n\n**① GitHub Actions** — main 푸시 한 번으로 버전 관리, 체인지로그, CI/CD 배포까지 자동 처리  \n**② Agent Skills** — `/github`, `/commit`, `/report` 등 AI가 이슈 작성부터 커밋 메시지, 구현 보고서까지 대신 생성\n\n| 기존 방식 | Projectops |\n|----------|---------------------|\n| 버전 수동 관리, 태그 직접 생성 | 릴리스(develop→main PR) 시 patch 버전 자동 증가 + 태그 생성 |\n| 체인지로그 직접 작성 (30분+) | CodeRabbit AI가 PR마다 자동 생성 |\n| CI/CD 처음부터 설정 | 프로젝트 타입별 워크플로우 즉시 구성 |\n| 이슈 매번 형식 맞춰 작성 (5분+) | `/pro-github` 한 번에 표준 템플릿 생성 + 등록 |\n| 커밋 메시지 이슈 URL 수동 복사 | `/pro-commit` 이슈 컨텍스트 기반 자동 완성 |\n| PR 설명/보고서 직접 작성 | `/pro-report` git diff 분석 후 자동 생성 |\n| 코드 리뷰·분석 매번 프롬프트 입력 | 17종 Skills로 일관된 결과, 매번 재입력 불필요 |\n\n---\n\n## AI 개발 사이클\n\nAgent Skills가 개발 사이클 전체를 커버합니다.\n\n```mermaid\nflowchart TD\n    A([\"작업 시작\"]) --> B[\"/pro-github<br/>이슈 등록\"]\n    B --> C[\"/pro-init-worktree<br/>worktree + 민감파일 복사\"]\n    C --> D{\"작업 유형\"}\n\n    D -->|새 기능·설계·리팩토링| E1[\"superpowers:brainstorming<br/>무엇을 왜 만들지 확정\"]\n    D -->|버그·장애| E2[\"/pro-note<br/>과거 기록 검색 + 조사\"]\n\n    E1 --> P[\"superpowers:writing-plans<br/>구현 계획\"]\n    P --> F[\"superpowers:executing-plans<br/>계획 실행\"]\n    E2 --> F\n    F --> H[\"/pro-review<br/>셀프 리뷰\"]\n    H --> I[\"/pro-commit<br/>이슈 연동 커밋\"]\n    I --> J[\"/pro-report<br/>구현 보고서 + GitHub 댓글\"]\n    J --> K([\"PR 등록\"])\n    K --> L[\"/pro-changelog-deploy<br/>릴리스 PR + automerge\"]\n```\n\n> Skills 전체 목록 및 상세 사용법: **[docs/SKILLS.md](docs/SKILLS.md)**\n\n---\n\n## GitHub Actions 자동화 파이프라인\n\n```mermaid\nflowchart TD\n    A([develop 푸시]) --> B[개발 통합]\n    B --> C[develop→main 릴리스 PR]\n    C --> D[\"PR 내 버전 확정<br/>patch +1 + 태그 + AI 체인지로그\"]\n    D --> E[자동 머지]\n    E --> F[\"main push → CI/CD 배포<br/>Flutter / Spring / React 등\"]\n    F --> G([완료])\n```\n\n---\n\n## 빠른 시작\n\n### 새 프로젝트\n\nGitHub에서 **\"Use this template\"** 클릭 → 1분 내 자동 초기화 완료\n\n### 기존 프로젝트에 통합\n\n**권장 — npx (macOS · Linux · Windows 공통)**\n\n```bash\nnpx projectops\n```\n\n> Node.js 20.12+ 만 있으면 별도 설치 없이 대화형 마법사가 실행됩니다. 비대화형: `npx projectops --mode full --type spring,react --force`\n\n> ⚠️ 구 `template_integrator.sh` / `.ps1`은 **지원 종료(EOF)** 되었습니다 (#458). 실행하면 `npx projectops` 안내만 출력하며, 다음 minor에서 파일이 제거됩니다.\n\n### Agent Skills만 설치\n\n```bash\n# Claude Code\nclaude plugin marketplace add Cassiiopeia/projectops\nclaude plugin install projectops@projectops-marketplace --scope user\n```\n\n```bash\n# Gemini CLI\ngemini extensions install https://github.com/Cassiiopeia/projectops\n```\n\n```bash\n# Codex CLI (macOS / Linux)\ncodex plugin marketplace add Cassiiopeia/projectops\n```\n\n`--mode skills` 마법사는 Codex marketplace를 등록한 뒤 native skills fallback도 자동 준비합니다. `/plugins`는 설치 확인/관리용으로만 사용하면 됩니다.\n\nCodex plugin marketplace를 사용할 수 없는 환경에서는 [Skills 가이드](docs/SKILLS.md)의 fallback 설치 방식을 사용하세요.\n\n```bash\n# Cursor / 전체 Agent Skills 설치 메뉴 (권장 — npx)\nnpx projectops --mode skills\n```\n\n\n\n> Claude Code는 `/pro-` 자동완성, Gemini는 extension, Codex는 plugin marketplace를 우선 사용합니다. 자세한 설치 방식은 [Skills 가이드](docs/SKILLS.md)를 확인하세요.\n\n---\n\n## 주요 기능\n\n| 기능 | 설명 | 문서 |\n|------|------|------|\n| **Agent Skills** | Claude Code, Cursor, Gemini CLI, Codex CLI에서 쓰는 17종 AI DevOps Skills | [상세](docs/SKILLS.md) |\n| **버전 자동화** | 릴리스(develop→main PR) 시 patch 버전 자동 증가 + Git 태그 | [상세](docs/VERSION-CONTROL.md) |\n| **AI 체인지로그** | provider 사다리(CodeRabbit/GitHub Models/OpenAI 계열/commit) 기반 CHANGELOG 자동 생성 | [상세](docs/CHANGELOG-AUTOMATION.md) |\n| **PR Preview** | 댓글 한 줄로 임시 서버 배포, 닫으면 자동 삭제 | [상세](docs/PR-PREVIEW.md) |\n| **이슈 자동화** | 브랜치명/커밋 메시지 자동 제안, QA 이슈 생성 | [상세](docs/ISSUE-AUTOMATION.md) |\n| **Flutter CI/CD** | iOS TestFlight + Android Play Store 자동 배포 | [상세](docs/FLUTTER-CICD-OVERVIEW.md) |\n| **배포 설정 마법사** | Play Store / TestFlight / Firebase App Distribution 5단계 HTML 마법사 | `.github/util/flutter/{playstore,testflight,firebase}-wizard/` |\n| **SSH+Docker 배포** | SSH 접속 서버에 Docker 무중단 배포 (Synology·AWS EC2 등) | [상세](docs/SSH-DOCKER-DEPLOYMENT-GUIDE.md) |\n\n---\n\n## Agent Skills (17종)\n\n### 🔄 개발 사이클 자동화\n\n| 스킬 | 용도 |\n|------|------|\n| `/pro-init-worktree` | Git worktree 생성 + 민감 파일 자동 복사 |\n| `/pro-commit` | 이슈 컨텍스트 기반 커밋 메시지 자동 완성 (superpowers 준수) |\n| `/pro-report` | git diff 분석 → 구현 보고서 생성 + GitHub 댓글 자동 포스팅 |\n| `/pro-changelog-deploy` | develop push → main 릴리스 PR 생성 + 릴리스 노트 작성 + automerge |\n| `/pro-github` | GitHub 전반: 이슈 생성(설명 한 줄 → 템플릿 작성+등록)/조회/수정/댓글/라벨/담당자, PR 생성/머지/조회, 레포 탐색, Actions/Secret 관리 |\n\n### 📊 분석형 (코드 수정 없음)\n\n| 스킬 | 용도 |\n|------|------|\n| `/pro-review` | 보안/성능/버그/품질 6관점 리뷰, Critical/Major/Minor 분류 |\n| `/pro-note` | 막혔을 때 과거 기록 검색, 알아낸 것을 실행 가능한 기록으로 저장 |\n\n### 🔧 구현형 (실제 코드 작성)\n\n| 스킬 | 용도 |\n|------|------|\n| `/pro-figma` | Figma CSS → React/RN/Flutter 반응형 코드 변환 |\n| `/pro-build` | 프로젝트 빌드 실행, 에러 분석, 최적화 제안 |\n\n> 설계·계획·구현 흐름은 `superpowers`(brainstorming → writing-plans → executing-plans)가 담당합니다.\n> `/pro-plan` · `/pro-analyze` · `/pro-implement`는 같은 역할의 이전 세대 경로로, 명시적으로 호출할 때만 동작합니다.\n\n### 📝 문서/산출물 생성형\n\n| 스킬 | 용도 |\n|------|------|\n| `/pro-testcase` | 이슈 분석 → QA 체크리스트 생성 |\n| `/pro-spring-test` | Spring Boot 테스트 샘플 코드 생성 |\n| `/pro-synology-expose` | Synology NAS 외부 도메인 노출 설정 가이드 |\n| `/pro-ssh` | 원격 서버 SSH 접속·명령 실행 (AWS EC2, 시놀로지 NAS, Linux 등 범용) |\n| `/pro-skill-creator` | Skill 생성/리뷰/개선 (CREATE·REVIEW·IMPROVE 3모드) |\n\n---\n\n## 지원 프로젝트 타입\n\n| 타입 | 버전 파일 | CI/CD |\n|------|----------|-------|\n| `spring` | build.gradle | SSH+Docker 배포, Nexus |\n| `flutter` | pubspec.yaml | TestFlight, Play Store |\n| `react` (Next.js 포함) | package.json | Docker |\n| `node` | package.json | Docker |\n| `python` | pyproject.toml | SSH+Docker 배포 |\n| `react-native` | Info.plist + build.gradle | — |\n| `react-native-expo` | app.json | — |\n| `basic` | version.yml만 | — |\n\n---\n\n## 댓글 명령어\n\nIssue나 PR에 댓글로 자동화를 실행합니다.\n\n| 명령어 | 기능 | 대상 |\n|--------|------|------|\n| `@projectops server build` | 임시 서버 배포 | Spring, Python |\n| `@projectops server destroy` | 서버 삭제 | Spring, Python |\n| `@projectops server status` | 서버 상태 확인 | Spring, Python |\n| `@projectops build app` | iOS + Android 빌드 | Flutter |\n| `@projectops apk build` | Android만 빌드 | Flutter |\n| `@projectops ios build` | iOS만 빌드 | Flutter |\n| `@projectops create qa` | QA 이슈 자동 생성 | 모든 프로젝트 |\n\n> 상세: [PR Preview](docs/PR-PREVIEW.md) | [Flutter 빌드](docs/FLUTTER-TEST-BUILD-TRIGGER.md) | [이슈 자동화](docs/ISSUE-AUTOMATION.md)\n\n---\n\n## 설정\n\n### 필수 Secret\n\n```\nRepository Settings → Secrets → Actions → New repository secret\nName: _GITHUB_PAT_TOKEN\nValue: [Personal Access Token - repo, workflow 권한]\n```\n\n### Organization 설정\n\n```\nSettings → Actions → General\n├─ ✅ Allow GitHub Actions to create and approve pull requests\n└─ ✅ Read and write permissions\n```\n\n---\n\n## 문서\n\n전체 목록은 **[문서 인덱스](docs/README.md)**를 참고하세요.\n\n| 문서 | 설명 |\n|------|------|\n| [📚 문서 인덱스](docs/README.md) | docs 전체를 목적별로 안내 |\n| [Agent Skills 가이드](docs/SKILLS.md) | 17종 Skills 용도, 사용법, 전체 개발 사이클 흐름 |\n| [NPX 마법사 가이드](docs/NPX-WIZARD.md) | npx projectops 통합, 프로젝트 성격(intent), 배포/publish 2축, 레거시 자동 마이그레이션 |\n| [통합 스크립트 가이드](docs/TEMPLATE-INTEGRATOR.md) | 구 integrator 지원 종료(EOF) 안내 |\n| [버전 관리](docs/VERSION-CONTROL.md) | version.yml, 자동 버전 증가 |\n| [체인지로그 자동화](docs/CHANGELOG-AUTOMATION.md) | 릴리스 PR 흐름, 릴리스 노트 provider 사다리, CodeRabbit 연동 |\n| [PR Preview](docs/PR-PREVIEW.md) | 임시 서버 배포 시스템 |\n| [Flutter CI/CD](docs/FLUTTER-CICD-OVERVIEW.md) | iOS/Android 자동 배포, GitHub Secrets 전체 목록 |\n| [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) 배포 설정 마법사 |\n| [SSH+Docker 배포](docs/SSH-DOCKER-DEPLOYMENT-GUIDE.md) | SSH 접속 서버에 Docker 배포 (Synology·AWS EC2 등) |\n| [이슈 자동화](docs/ISSUE-AUTOMATION.md) | Issue Helper, QA 봇 |\n| [GitHub Projects 동기화](docs/PROJECTS-SYNC.md) | Issue Label ↔ Projects Status 동기화 ([마법사](docs/GITHUB-PROJECTS-SYNC-WIZARD.md)) |\n| [브랜치 네이밍 규칙](docs/BRANCH-CONVENTION.md) | `YYYYMMDD_#번호_제목` 규칙과 의존 소비자 (유지보수자용) |\n| [워크플로우 주석 표준](docs/WORKFLOW-COMMENT-GUIDELINES.md) | 주석 컨벤션, 파일별 적용 현황 (기여자용) |\n| [트러블슈팅](docs/TROUBLESHOOTING.md) | 자주 발생하는 문제 해결 |\n\n---\n\n## 지원\n\n- [Issues](https://github.com/Cassiiopeia/projectops/issues) — 버그 리포트, 기능 요청\n- [CONTRIBUTING.md](CONTRIBUTING.md) — 기여 가이드\n\n---\n\n<div align=\"center\">\n\n**MIT License**\n\n</div>\n",
  "bytes": 8320,
  "sha": "c16f70d038c2a16d5fdd92cfda230cda1a559c7959510588118ee48e762d78d1",
  "repo_slug": "cassiiopeia/projectops",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_cassiiopeia_projectops_42db568e/readme"
}