projectops 4.31.5 → 4.33.0

package/README.md

@@ -1,179 +1,180 @@
 <div align="center">
 
-<img src="https://raw.githubusercontent.com/Cassiiopeia/projectops/main/docs/images/hero.webp" alt="Projectops — 이슈부터 배포까지" width="100%">
+<img src="https://raw.githubusercontent.com/Cassiiopeia/projectops/main/docs/images/hero-en.webp" alt="Projectops: from issue to release" 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)
+[한국어](docs/i18n/README.ko.md) | **English** | [简体中文](docs/i18n/README.zh-CN.md) | [日本語](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) [![Docs](https://img.shields.io/badge/docs-site-4f46e5)](https://cassiiopeia.github.io/projectops/)
 
+**Status: actively maintained.** Releases are batched about once a day; see [CONTRIBUTING](CONTRIBUTING.md#releases).
+
 <!-- AUTO-VERSION-SECTION: DO NOT EDIT MANUALLY -->
-## 최신 버전 : v4.31.4 (2026-10-02)
+## Latest version : v4.33.0 (2026-10-06)
 
-[전체 버전 기록 보기](CHANGELOG.md)
+[View full version history](CHANGELOG.md)
 
 </div>
 
 ---
 
-## 30초 시작
+## Get started in 30 seconds
 
-| 하고 싶은 일 | 실행할 것 |
+| I want to... | Run this |
 |---|---|
-| 새 프로젝트를 시작한다 | GitHub에서 **Use this template** 클릭 (1분 내 자동 초기화) |
-| 기존 프로젝트에 붙인다 | `npx projectops` |
-| Agent Skills만 설치한다 | `npx projectops --mode skills` |
-| 설치 상태를 점검한다 (읽기 전용) | `npx projectops --mode doctor` |
+| Start a new project | Click **Use this template** on GitHub (auto-setup in about a minute) |
+| Add it to an existing project | `npx projectops` |
+| Install Agent Skills only | `npx projectops --mode skills` |
+| Check the install state (read-only) | `npx projectops --mode doctor` |
 
-> Node.js 20.12 이상만 있으면 됩니다. 별도 설치 없이 대화형 마법사가 실행됩니다.
+> You only need Node.js 20.12+. An interactive wizard runs with no separate install.
 
-![npx projectops 대화형 마법사 실행 화면](https://raw.githubusercontent.com/Cassiiopeia/projectops/main/docs/images/cli-wizard.gif)
+![npx projectops interactive wizard](https://raw.githubusercontent.com/Cassiiopeia/projectops/main/docs/images/cli-wizard.gif)
 
-> 위 화면은 샘플 Spring 프로젝트에서 **실제로 실행한 화면**입니다. 화면에 보이는 버전 표기는 녹화 시점 기준입니다. 비대화형 실행과 옵션 전체는 [CLI 레퍼런스](https://cassiiopeia.github.io/projectops/CLI)를 보세요.
+> This is a **real run** on a sample Spring project (the wizard follows your system language, or use `--lang en|ko`). Version numbers shown were current when it was recorded. For non-interactive use and every option, see the [CLI reference](https://cassiiopeia.github.io/projectops/en/cli).
 
 ---
 
-## 왜 이 템플릿인가?
+## Why this template?
 
-이 프로젝트는 두 축으로 개발 워크플로우를 자동화합니다.
+This project automates your development workflow on two axes.
 
-**① GitHub Actions** — main 푸시 한 번으로 버전 관리, 체인지로그, CI/CD 배포까지 자동 처리  
-**② Agent Skills** — `/pro-github`, `/pro-commit`, `/pro-report` 등 AI가 이슈 작성부터 커밋 메시지, 구현 보고서까지 대신 생성
+**① GitHub Actions**: one push to main handles versioning, changelogs, and CI/CD deployment.
+**② Agent Skills**: commands such as `/pro-github`, `/pro-commit`, and `/pro-report` let an AI agent write issues, commit messages, and implementation reports for you.
 
-| 기존 방식 | Projectops |
+| The usual way | With Projectops |
 |----------|---------------------|
-| 버전 수동 관리, 태그 직접 생성 | 릴리스 시 커밋 내용에 맞는 버전 자동 증가 + 태그 생성 |
-| 체인지로그 직접 작성 (30분+) | 릴리스 PR마다 자동 생성 (커밋 분석, AI 키가 있으면 AI 요약) |
-| CI/CD 처음부터 설정 | 프로젝트 타입별 워크플로우 즉시 구성 |
-| 이슈 매번 형식 맞춰 작성 (5분+) | `/pro-github` 한 번에 표준 템플릿 생성 + 등록 |
-| 커밋 메시지 이슈 URL 수동 복사 | `/pro-commit` 이슈 컨텍스트 기반 자동 완성 |
-| PR 설명/보고서 직접 작성 | `/pro-report` git diff 분석 후 자동 생성 |
-| 코드 리뷰·분석 매번 프롬프트 입력 | 20종 Skills로 일관된 결과, 매번 재입력 불필요 |
+| Bump versions and create tags by hand | At release time the version is bumped from your commit titles and a tag is created |
+| Write the changelog yourself (30+ min) | Generated for every release PR (commit analysis, or an AI summary if you add an AI key) |
+| Set up CI/CD from scratch | Workflows for your project type, ready immediately |
+| Format every issue by hand (5+ min) | `/pro-github` writes and files an issue from the standard template in one step |
+| Copy the issue URL into commit messages | `/pro-commit` completes the message from the issue context |
+| Write PR descriptions and reports by hand | `/pro-report` analyzes the git diff and generates one |
+| Re-type prompts for every code review or analysis | 20 Skills give consistent results without re-typing |
 
 ---
 
-## 실제로 이렇게 동작합니다
+## What it actually looks like
 
-아래는 테스트 조직의 샘플 레포에 projectops를 설치하고 **실제로 실행하며 녹화한 화면**입니다. 우측 상단 타이머는 실제 경과 시간이고, 기다리는 구간만 빠르게 재생합니다.
+Below is a **real run, recorded** after installing projectops in a sample repo in a test organization. The timer in the top right is real elapsed time; only the waiting parts are played back fast.
 
-### ① 이슈를 열면 브랜치명과 커밋 메시지가 자동으로 달립니다
+### 1. Open an issue and a branch name and commit message arrive automatically
 
-![이슈를 열면 자동 안내 댓글이 달리는 화면](https://raw.githubusercontent.com/Cassiiopeia/projectops/main/docs/images/feature-issue.gif)
+![Automatic guide comment after opening an issue](https://raw.githubusercontent.com/Cassiiopeia/projectops/main/docs/images/feature-issue.gif)
 
-이슈를 열면 GitHub Actions가 스스로 실행되어 **브랜치명과 커밋 메시지 템플릿**을 댓글로 알려 줍니다. 이 브랜치명으로 작업하면 이슈 번호가 커밋·보고서에 자동으로 연동됩니다.
+When an issue is opened, GitHub Actions runs on its own and comments a **branch name and a commit message template**. Work on that branch name and the issue number links into your commits and reports automatically.
 
-### ② PR을 열면 변경 요약이 자동으로 달립니다
+### 2. Open a PR and a change summary arrives automatically
 
-![PR을 열면 변경 요약 댓글이 달리는 화면](https://raw.githubusercontent.com/Cassiiopeia/projectops/main/docs/images/feature-pr-summary.gif)
+![Change summary comment after opening a PR](https://raw.githubusercontent.com/Cassiiopeia/projectops/main/docs/images/feature-pr-summary.gif)
 
-작업 브랜치로 PR을 열면 커밋을 분석한 **변경 요약**이 댓글로 달립니다. 커밋을 더 올리면 새 댓글을 쌓지 않고 같은 댓글을 갱신합니다.
+Open a PR from a work branch and a **change summary** built from the commits is posted as a comment. Push more commits and the same comment is updated instead of piling up new ones.
 
-### ③ 릴리스 PR을 열면 버전 확정부터 머지, 태그까지 자동입니다
+### 3. Open a release PR and everything from versioning to merge and tag is automatic
 
-![릴리스 PR이 자동으로 머지되고 태그가 생기는 화면](https://raw.githubusercontent.com/Cassiiopeia/projectops/main/docs/images/feature-release.gif)
+![Release PR merging automatically and a tag appearing](https://raw.githubusercontent.com/Cassiiopeia/projectops/main/docs/images/feature-release.gif)
 
-개발 브랜치에서 `main`으로 PR을 열면 릴리스 노트를 쓰고, 커밋 제목(`feat`, `fix` 등)으로 버전을 정해 PR 제목에 반영한 뒤, 자동으로 머지하고 **버전 태그**까지 만듭니다. 위 예시는 `feat` 커밋이라 minor 버전이 올랐습니다.
+Open a PR from the development branch to `main` and it writes the release notes, decides the version from commit titles (`feat`, `fix`, ...) and puts it in the PR title, merges automatically, and creates the **version tag**. This example had `feat` commits, so the minor version went up.
 
-> 한글 브랜치명에 GitHub이 띄우는 경고 배너는 화면에서 가렸습니다. 그 외에는 가공하지 않은 실제 화면입니다.
+> The warning banner GitHub shows for Korean branch names is hidden in the recording. Everything else is the unedited screen.
 ---
 
-## 구성 요소
+## What is inside
 
-| 구성 | 하는 일 | 문서 |
+| Part | What it does | Docs |
 |---|---|---|
-| **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) |
+| **GitHub Actions** | One push to main handles versioning, changelogs, and CI/CD deployment | [Versioning](https://cassiiopeia.github.io/projectops/VERSION-CONTROL) (Korean) |
+| **Agent Skills** (20) | `/pro-github`, `/pro-commit`, `/pro-report` and more let an AI agent write issues, commit messages, and implementation reports | [Skills guide](https://cassiiopeia.github.io/projectops/SKILLS) (Korean) |
+| **npx CLI** | Installs and updates workflows in an existing project, and diagnoses its state | [CLI reference](https://cassiiopeia.github.io/projectops/en/cli) |
 
 <details>
-<summary>Agent Skills 20종 전체 보기</summary>
+<summary>See all 20 Agent Skills</summary>
 
-### 🔄 개발 사이클 자동화
+### 🔄 Development cycle automation
 
-| 스킬 | 용도 |
+| Skill | Purpose |
 |------|------|
-| `/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-init-worktree` | Create a Git worktree and copy sensitive files automatically |
+| `/pro-commit` | Complete a commit message from the issue context (follows superpowers) |
+| `/pro-report` | Analyze the git diff → generate an implementation report and post it as a GitHub comment |
+| `/pro-changelog-deploy` | Push develop → open the main release PR + write release notes + automerge |
+| `/pro-github` | GitHub in general: create issues (one-line description → template + file), view/edit/comment/label/assign, create/merge/view PRs, explore repos, manage Actions and Secrets |
 
-### 📊 분석형 (코드 수정 없음)
+### 📊 Analysis (no code changes)
 
-| 스킬 | 용도 |
+| Skill | Purpose |
 |------|------|
-| `/pro-review` | 보안/성능/버그/품질 6관점 리뷰, Critical/Major/Minor 분류 |
-| `/pro-note` | 막혔을 때 과거 기록 검색, 알아낸 것을 실행 가능한 기록으로 저장 |
+| `/pro-review` | Review from 6 angles (security, performance, bugs, quality...), classified Critical/Major/Minor |
+| `/pro-note` | When stuck, search past notes; save what you found out as an actionable note |
 
-### 🔧 구현형 (실제 코드 작성)
+### 🔧 Implementation (writes real code)
 
-| 스킬 | 용도 |
+| Skill | Purpose |
 |------|------|
-| `/pro-figma-verify` | Figma 시안을 코드로 옮기고, 옮긴 것이 시안과 같은지 픽셀로 센다 |
-| `/pro-build` | 프로젝트 빌드 실행, 에러 분석, 최적화 제안 |
-| `/pro-launch` | 앱·웹·서버를 띄우고 조작하고 찍는다 — 상태바 고정 캡처, 폭 바꾸기, 응답 바꿔치기(빈 목록·실패 연출), 코드 렌더 |
-| `/pro-design-brief` | 시안보다 먼저 만든 화면의 디자인 요청서 — 상태별 캡처·대안·문구 후보·꼭 지킬 것을 보드로 만들어 디자이너에게 |
-| `/pro-oss-consult` | GitHub 레포를 오픈소스로서 진단 — 성격 판별, 6축 채점, 성숙도 단계, 승인받은 것만 About·topics·라벨·파일 수정. 단일 레포·계정 전체 일괄 |
+| `/pro-figma-verify` | Move a Figma design into code, then compare the result with the design pixel by pixel |
+| `/pro-build` | Run the project build, analyze errors, suggest optimizations |
+| `/pro-launch` | Launch, drive, and capture apps, web, and servers: fixed status bar, width changes, response mocking (empty list, failures), render from code |
+| `/pro-design-brief` | A design request for a screen you built before the mockup exists: state captures, alternatives, copy candidates, and must-keep rules as a board for the designer |
+| `/pro-oss-consult` | Diagnose a GitHub repo as an open-source project: type detection, 6-axis scoring, maturity stage, and edits to About, topics, labels, and files only after approval. One repo or a whole account |
 
-> 설계·계획·구현 흐름은 `superpowers`(brainstorming → writing-plans → executing-plans)가 담당합니다.
-> `/pro-plan` · `/pro-analyze` · `/pro-implement`는 같은 역할의 이전 세대 경로로, 명시적으로 호출할 때만 동작합니다.
-> 위 표의 17종과 이 3종을 합쳐 총 20종입니다.
+> Design, planning, and implementation flow is handled by `superpowers` (brainstorming → writing-plans → executing-plans).
+> `/pro-plan`, `/pro-analyze`, and `/pro-implement` are the previous generation of the same roles and only run when invoked explicitly. Together with the 17 in the tables above, that makes 20 in total.
 
-### 📝 문서/산출물 생성형
+### 📝 Documents and artifacts
 
-| 스킬 | 용도 |
+| Skill | Purpose |
 |------|------|
-| `/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모드) |
+| `/pro-testcase` | Analyze an issue → generate a QA checklist |
+| `/pro-agent-test` | QA that actually runs apps, web, and servers to find bugs, reporting reproduction steps, evidence, and severity (it does not fix code) |
+| `/pro-synology-expose` | Guide to exposing a Synology NAS service on an external domain |
+| `/pro-ssh` | Connect to a remote server over SSH and run commands (AWS EC2, Synology NAS, Linux, and more) |
+| `/pro-skill-creator` | Create, review, and improve a Skill (CREATE / REVIEW / IMPROVE modes) |
 
 </details>
 
 <details>
-<summary>개발 사이클과 자동화 파이프라인 흐름도 보기</summary>
+<summary>See the development cycle and pipeline diagrams</summary>
 
-### AI 개발 사이클
+### AI development cycle
 
-Agent Skills가 개발 사이클 전체를 커버합니다.
+Agent Skills cover the entire development cycle.
 
 ```mermaid
 flowchart TD
-    A(["작업 시작"]) --> B["/pro-github<br/>이슈 등록"]
-    B --> C["/pro-init-worktree<br/>worktree + 민감파일 복사"]
-    C --> D{"작업 유형"}
+    A(["Start work"]) --> B["/pro-github<br/>File an issue"]
+    B --> C["/pro-init-worktree<br/>worktree + copy sensitive files"]
+    C --> D{"Type of work"}
 
-    D -->|새 기능·설계·리팩토링| E1["superpowers:brainstorming<br/>무엇을 왜 만들지 확정"]
-    D -->|버그·장애| E2["/pro-note<br/>과거 기록 검색 + 조사"]
+    D -->|New feature / design / refactor| E1["superpowers:brainstorming<br/>Decide what and why"]
+    D -->|Bug / outage| E2["/pro-note<br/>Search past notes + investigate"]
 
-    E1 --> P["superpowers:writing-plans<br/>구현 계획"]
-    P --> F["superpowers:executing-plans<br/>계획 실행"]
+    E1 --> P["superpowers:writing-plans<br/>Implementation plan"]
+    P --> F["superpowers:executing-plans<br/>Run the plan"]
     E2 --> F
-    F --> H["/pro-review<br/>셀프 리뷰"]
-    H --> I["/pro-commit<br/>이슈 연동 커밋"]
-    I --> J["/pro-report<br/>구현 보고서 + GitHub 댓글"]
-    J --> K(["PR 등록"])
-    K --> L["/pro-changelog-deploy<br/>릴리스 PR + automerge"]
+    F --> H["/pro-review<br/>Self-review"]
+    H --> I["/pro-commit<br/>Issue-linked commit"]
+    I --> J["/pro-report<br/>Implementation report + GitHub comment"]
+    J --> K(["Open PR"])
+    K --> L["/pro-changelog-deploy<br/>Release PR + automerge"]
 ```
 
-> Skills 전체 목록 및 상세 사용법: **[docs/SKILLS.md](docs/SKILLS.md)**
+> Full list of Skills and usage: **[docs/SKILLS.md](docs/SKILLS.md)** (Korean)
 
-### GitHub Actions 자동화 파이프라인
+### GitHub Actions pipeline
 
 ```mermaid
 flowchart TD
-    A([develop 푸시]) --> B[개발 통합]
-    B --> C[develop→main 릴리스 PR]
-    C --> D["PR 내 버전 확정<br/>커밋 기반 승격 + 태그 + AI 체인지로그"]
-    D --> E[자동 머지]
-    E --> F["main push → CI/CD 배포<br/>Flutter / Spring / React 등"]
-    F --> G([완료])
+    A([Push to develop]) --> B[Integrate]
+    B --> C[develop→main release PR]
+    C --> D["Finalize version in the PR<br/>commit-based bump + tag + AI changelog"]
+    D --> E[Auto-merge]
+    E --> F["Push to main → CI/CD deploy<br/>Flutter / Spring / React, etc."]
+    F --> G([Done])
 ```
 
 </details>
 
 <details>
-<summary>Agent Skills만 설치하기 (Claude Code, Gemini CLI, Codex CLI, Cursor)</summary>
+<summary>Install Agent Skills only (Claude Code, Gemini CLI, Codex CLI, Cursor)</summary>
 
 ```bash
 # Claude Code
@@ -191,67 +192,65 @@ gemini extensions install https://github.com/Cassiiopeia/projectops
 codex plugin marketplace add Cassiiopeia/projectops
 ```
 
-`--mode skills` 마법사는 Codex marketplace를 등록한 뒤 native skills fallback도 자동 준비합니다. `/plugins`는 설치 확인/관리용으로만 사용하면 됩니다.
+The `--mode skills` wizard registers the Codex marketplace and also prepares the native skills fallback. Use `/plugins` only to check or manage the install.
 
-Codex plugin marketplace를 사용할 수 없는 환경에서는 [Skills 가이드](docs/SKILLS.md)의 fallback 설치 방식을 사용하세요.
+Where the Codex plugin marketplace is unavailable, use the fallback install described in the [Skills guide](docs/SKILLS.md).
 
 ```bash
-# Cursor / 전체 Agent Skills 설치 메뉴 (권장 — npx)
+# Cursor / the full Agent Skills install menu (recommended: npx)
 npx projectops --mode skills
 ```
 
-
-
-> Claude Code는 `/pro-` 자동완성, Gemini는 extension, Codex는 plugin marketplace를 우선 사용합니다. 자세한 설치 방식은 [Skills 가이드](docs/SKILLS.md)를 확인하세요.
+> Claude Code prefers `/pro-` autocomplete, Gemini prefers its extension, and Codex prefers its plugin marketplace. See the [Skills guide](docs/SKILLS.md) for details.
 
 </details>
 
 ---
 
-## 지원 프로젝트 타입
+## Supported project types
 
-| 타입 | 버전 파일 | CI/CD |
+| Type | Version file | CI/CD |
 |------|----------|-------|
-| `spring` | build.gradle | SSH+Docker 배포, Nexus |
+| `spring` | build.gradle | SSH + Docker deploy, Nexus |
 | `flutter` | pubspec.yaml | TestFlight, Play Store |
-| `react` (Next.js 포함) | package.json | Docker |
+| `react` (including Next.js) | package.json | Docker |
 | `node` | package.json | Docker |
-| `python` | pyproject.toml | SSH+Docker 배포 |
+| `python` | pyproject.toml | SSH + Docker deploy |
 | `react-native` | Info.plist + build.gradle | — |
 | `react-native-expo` | app.json | — |
-| `basic` | version.yml만 | — |
+| `basic` | version.yml only | — |
 
 ---
 
-## 댓글 명령어
+## Comment commands
 
-Issue나 PR에 댓글로 자동화를 실행합니다.
+Run automation by commenting on an issue or PR.
 
-| 명령어 | 기능 | 대상 |
+| Command | What it does | Applies to |
 |--------|------|------|
-| `@projectops server build` | 임시 서버 배포 | Spring, Python |
-| `@projectops server destroy` | 서버 삭제 | Spring, Python |
-| `@projectops server status` | 서버 상태 확인 | Spring, Python |
-| `@projectops build app` | iOS + Android 빌드 | Flutter |
-| `@projectops apk build` | Android만 빌드 | Flutter |
-| `@projectops ios build` | iOS만 빌드 | Flutter |
-| `@projectops create qa` | QA 이슈 자동 생성 | 모든 프로젝트 |
+| `@projectops server build` | Deploy a temporary server | Spring, Python |
+| `@projectops server destroy` | Delete the server | Spring, Python |
+| `@projectops server status` | Check server status | Spring, Python |
+| `@projectops build app` | Build iOS + Android | Flutter |
+| `@projectops apk build` | Build Android only | Flutter |
+| `@projectops ios build` | Build iOS only | Flutter |
+| `@projectops create qa` | Create a QA issue automatically | All projects |
 
-> 상세: [PR Preview](docs/PR-PREVIEW.md) | [Flutter 빌드](docs/FLUTTER-TEST-BUILD-TRIGGER.md) | [이슈 자동화](docs/ISSUE-AUTOMATION.md)
+> Details: [PR Preview](docs/PR-PREVIEW.md) | [Flutter builds](docs/FLUTTER-TEST-BUILD-TRIGGER.md) | [Issue automation](docs/ISSUE-AUTOMATION.md)
 
 ---
 
-## 설정
+## Setup
 
-### 필수 Secret
+### Required secret
 
 ```
 Repository Settings → Secrets → Actions → New repository secret
 Name: _GITHUB_PAT_TOKEN
-Value: [Personal Access Token - repo, workflow 권한]
+Value: [Personal Access Token - repo and workflow scopes]
 ```
 
-### Organization 설정
+### Organization settings
 
 ```
 Settings → Actions → General
@@ -261,40 +260,40 @@ Settings → Actions → General
 
 ---
 
-## 알아둘 것
+## Things to know
 
-맞지 않는 경우를 먼저 알려 드립니다.
+We would rather tell you up front when this is not a fit.
 
-- **GitHub 전용입니다.** GitHub Actions와 GitHub 이슈·PR을 전제로 하므로 GitLab 등은 지원하지 않습니다.
-- **릴리스는 개발 브랜치 → 기본 브랜치 PR 구조를 전제로 합니다.** 브랜치 이름은 `version.yml`에서 바꿀 수 있지만, 두 브랜치를 나눠 쓰지 않는 저장소에는 맞지 않습니다.
-- **이슈·PR 자동화에는 개인 액세스 토큰(PAT) 등록이 필요합니다.** 위 [설정](#설정)을 따라 주세요.
-- **서버 배포 워크플로우는 SSH로 접속하는 Docker 서버를 전제로 합니다.**
+- **GitHub only.** It assumes GitHub Actions and GitHub issues/PRs, so GitLab and others are not supported.
+- **Releases assume a develop branch → default branch PR flow.** Branch names can be changed in `version.yml`, but it does not suit a repo that does not use two branches.
+- **Issue and PR automation needs a personal access token (PAT).** Follow [Setup](#setup) above.
+- **Server deploy workflows assume a Docker server reachable over SSH.**
 
 ---
 
-## 문서
+## Documentation
 
-전체 문서는 **[문서 사이트](https://cassiiopeia.github.io/projectops/)** 에서 검색하며 볼 수 있습니다.
+Browse and search everything on the **[docs site](https://cassiiopeia.github.io/projectops/en/)**. Most guides are currently Korean only.
 
-- [시작하기](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)
+- [Getting started](https://cassiiopeia.github.io/projectops/en/getting-started)
+- [CLI reference](https://cassiiopeia.github.io/projectops/en/cli)
+- [Agent Skills guide (Korean)](https://cassiiopeia.github.io/projectops/SKILLS)
+- [Versioning (Korean)](https://cassiiopeia.github.io/projectops/VERSION-CONTROL)
+- [Changelog automation (Korean)](https://cassiiopeia.github.io/projectops/CHANGELOG-AUTOMATION)
+- [PR Preview (Korean)](https://cassiiopeia.github.io/projectops/PR-PREVIEW)
+- [Issue automation (Korean)](https://cassiiopeia.github.io/projectops/ISSUE-AUTOMATION)
+- [SSH + Docker deploy (Korean)](https://cassiiopeia.github.io/projectops/SSH-DOCKER-DEPLOYMENT-GUIDE)
+- [Flutter CI/CD (Korean)](https://cassiiopeia.github.io/projectops/FLUTTER-CICD-OVERVIEW)
+- [Troubleshooting (Korean)](https://cassiiopeia.github.io/projectops/TROUBLESHOOTING)
 
 ---
 
-## 지원
+## Support
 
-- [Issues](https://github.com/Cassiiopeia/projectops/issues) — 버그 리포트, 기능 요청
-  - 이 레포는 완료된 이슈를 닫지 않고 `작업완료` 라벨로 표시합니다. 열린 이슈 수가 많아 보이는 이유입니다.
-- [CONTRIBUTING.md](CONTRIBUTING.md) — 기여 가이드
-- [SECURITY.md](SECURITY.md) — 보안 취약점은 공개 이슈가 아니라 비공개로 신고해 주세요
+- [Issues](https://github.com/Cassiiopeia/projectops/issues): bug reports and feature requests
+  - This repo does not close finished issues; it marks them with the `작업완료` (done) label. That is why the open-issue count looks high.
+- [CONTRIBUTING.md](CONTRIBUTING.md): contribution guide
+- [SECURITY.md](SECURITY.md): please report security vulnerabilities privately, not in a public issue
 
 ---
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "projectops",
-  "version": "4.31.5",
-  "description": "ProjectOps — 완전 자동화 GitHub 프로젝트 관리 템플릿 통합 CLI",
+  "version": "4.33.0",
+  "description": "ProjectOps: installer CLI for a fully automated GitHub project management template (versioning, CI/CD, release notes, agent skills)",
   "keywords": [
     "devops",
     "automation",