deuk-agent-rule 2.3.1 → 2.4.1

package/CHANGELOG.ko.md

@@ -0,0 +1,83 @@
+# 변경 이력 (Changelog)
+
+이 프로젝트의 모든 주목할 만한 변경 사항은 이 파일에 기록됩니다.
+
+**English:** [CHANGELOG.md](CHANGELOG.md)
+
+형식은 [Keep a Changelog](https://keepachangelog.com/ko/1.1.0/)를 기반으로 하며, 이 프로젝트는 [유의적 버전(Semantic Versioning)](https://semver.org/spec/v2.0.0.html)을 준수합니다.
+
+## [2.4.1] - 2026-04-18
+
+### 추가됨 (Added)
+- **cli:** NPM 최신 버전을 감지하여 터미널에 업데이트를 권고하는 알림 기능(Update Notifier) 추가
+
+### 수정됨 (Fixed)
+- **ticket:** 티켓 생성 시 호스트명 슬러그가 8글자로 엄격히 제한되지 않던 버그 수정
+
+## [2.4.0] - 2026-04-18
+
+### 추가됨 (Added)
+
+- **init:** 깔끔한 마이그레이션을 위한 구버전 템플릿 자동 정리 기능 추가
+- **rules:** `AGENTS.md` 문서 내 티켓 검증 단계(TICKET VERIFICATION RULE) 규약 추가
+- **ticket:** 티켓에 우선순위(Priority) 속성 추가
+- **ticket:** 순차 번호 및 호스트네임 기반의 티켓 식별자(ID) 자동 생성 도입 (`NNN-hostname-topic` 포맷)
+- **ticket:** 호스트네임 길이 제한(8자) 및 자동 순번 부여 로직 개선
+
+### 수정됨 (Fixed)
+
+- **rules:** 전역 `npx` 캐시 이슈(과거 버전 실행 문제)를 우회하기 위해 로컬 최신 스크립트 호출을 강제/권장하도록 수정
+- **scripts:** OSS 미러 저장소 동기화 시 잘못 표기되던 URL 예시 로그 메시지 정정
+
+### 변경됨 (Changed)
+
+- **docs:** 리드미(README) 파일에 [Step 4] 티켓 검증 안내 추가
+- **docs:** 전역 설치(Global Install) 권장 안내 및 운영체제(OS)별 권한 제약 명확화
+- **rules:** 구현 아티팩트(`implementation_plan.md` 등) 내 티켓 번호 참조 의무화
+
+## [2.3.2] - 2026-04-17
+
+### 수정됨 (Fixed)
+
+- **cli:** 배포 환경에서 하드코딩된 `yaml` 의존성 경로 문제(`ERR_MODULE_NOT_FOUND`) 해결
+- **dependencies:** `yaml`을 명시적 의존성 목록에 추가
+
+## [2.3.1] - 2026-04-17
+
+### 변경됨 (Changed)
+
+- **readme:** 체인지로그 및 자동화된 릴리즈 프로세스 가이드 추가
+
+## [2.3.0] - 2026-04-17
+
+### 추가됨 (Added)
+
+- AI 파이프라인 연동 기반 및 선택적 동기화 시스템 고도화
+- **cli:** ticket list 명령에 --submodule 필터 추가
+- **cli:** 티켓 아카이브 및 리포트 워크플로를 모듈형 아키텍처로 복구
+- **rules:** Unity Client, WebApp, C++ 서버 하이브리드 환경을 위한 룰 고도화
+- **ticket:** 분산형 티켓 관리 및 공유 정책 구현
+- **ticket:** V2 YAML Front-matter 및 카테고리화된 리스트로 업그레이드
+
+### 수정됨 (Fixed)
+
+- **ticket:** LATEST.md를 폐기하고 ACTIVE_TICKET.md로 포인터 통일
+- **ticket:** DeukAgentRules 현재 진행 중인 티켓 안 나오던 문제 해결
+
+## [1.0.14] - 2026-04-02
+
+### 추가됨 (Added)
+
+- **cli:** 병합 도구 및 배포 문서 동기화 스크립트 확장
+- **rules:** 커밋 제목 내 'sync' 금지 구문 룰 추가
+- **handoff:** 인덱스 기반 Handoff 워크플로 및 CLI 신설
+- **architecture:** 제로-터치 NPM 번들 스캐폴딩으로 템플릿 아키텍처 개편
+
+### 수정됨 (Fixed)
+
+- **cli:** 템플릿 생성기(init) 내부의 HTML 엔티티 문법 에러 핫픽스
+
+### 변경됨 (Changed)
+
+- **docs:** 외부 공개용 릴리즈 가이드 및 동기화 스크립트 주석 갱신
+- **docs:** 리드미(README)에 토큰 비용 차단 메커니즘 설정 및 제로 터치 스캐폴딩 문서 개편

package/CHANGELOG.md

@@ -4,185 +4,235 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [2.3.1] - 2026-04-17
-
-
-### Changed
-
-- **readme:** add changelog and automated release instructions
-
-## [2.3.0] - 2026-04-17
+## [2.4.1] - 2026-04-18
 
 
 ### Added
 
--  AI 파이프라인 연동 기반 및 선택적 동기화 시스템 고도화
-- **cli:** add --submodule filter to ticket list command
-- **cli:** restore ticket archive and reports workflows to modular architecture
-- **rules:** advance rules for Unity Client, WebApp, and C++ Server hybrid environment
-- **ticket:** implementation of decentralized ticket management & sharing policy
-- **ticket:** upgrade to V2 YAML Front-matter and Categorized List
+- **cli:** add update notifier for checking latest npm version
 
 
 ### Fixed
 
-- **ticket:** deprecate LATEST.md, unify pointer to ACTIVE_TICKET.md
-- **ticket:** DeukAgentRules 현재 진행중인 티켓 안나오던 문제 해결
-
-
-### Changed
-
-- **readme:** clarify YAML front matter preservation and distributed ticket workflow for v2.2.2
-- **readme:** restore count headers and npm badges
-- **rules:** enforce CLI usage for ticket reading to prevent manual JSON parsing
--  update CLI reference with close and migrate commands
-
-## [1.0.18] - 2026-04-12
-
-
-### Added
-
-- **ai:** map conversational ticket requests to implicit CLI execution
-- **cli:** implement ticket archive and reporting workflow
-- **rules:** map conversational ticket aliases to implicit CLI execution
+- **ticket:** strictly enforce 8-character limit on hostname slug
 
 
 ### Changed
 
-- **readme:** add ticket archive and reports CLI usage to documentation
-- **readme:** describe natural language CLI prompting alternatives
-- **readme:** provide explicit conversational prompt examples inside option tables
-- **readme:** provide explicit update guide
-- **rules:** add prompting guide and execution report archival rule
-
-## [1.0.17] - 2026-04-06
-
-
-### Fixed
-
-- **template:** move ticket repo-relative marker to bottom
-
-## [1.0.16] - 2026-04-05
-
-
-### Added
-
-- **workflow:** add auto-verification and final report to agent workflows
+-  add reasons for global installation
+- **changelog:** sync korean changelog with v2.4.0
 
-## [1.0.15] - 2026-04-05
+## [2.4.0] - 2026-04-18
 
 
 ### Added
 
--  migrate and rename handoff terminology to ticket in CLI and templates
-
-
-### Changed
-
--  Add strict rule for DeukPack namespace requirement
--  completely eradicate legacy Handoff references from AGENTS.md, templates, and mdc rules
--  Enforce DeukPack code format and API strictly as a hard rule
--  refactor README usage guide and workflow
-
-## [1.0.14] - 2026-04-02
-
-
-### Added / 추가됨
-
-- **cli:** extend merge tooling and sync publish docs / 병합 도구 및 배포 문서 동기화 스크립트 확장
-- **rules:** forbid 'sync' word in commit titles in agent rules / 커밋 제목 내 'sync' 금지 구문 룰 추가
-- **handoff:** add indexed handoff workflow and CLI / 인덱스 기반 Handoff 워크플로 및 CLI 신설
-- **architecture:** migrate template architecture to zero-touch NPM bundle scaffolding / 제로-터치 NPM 스캐폴딩으로 템플릿 아키텍처 개편
-
-
-### Fixed / 수정됨
-
-- **cli:** resolve html entity syntax error in template generator / 템플릿 생성기(init) 내부의 HTML 엔티티 문법 에러 핫픽스
-
-
-### Changed / 변경됨
-
-- **docs:** public-facing RELEASING and changelog wording; sync-bundle comment / 외부 공개용 릴리즈 가이드 및 동기화 스크립트 주석 갱신
-- **docs:** update README with token efficiency mechanism and zero-touch template scaffolding / 리드미(README)에 토큰 비용 차단 메커니즘 설정 및 제로 터치 스캐폴딩 문서 개편
-
-## [1.0.13] - 2026-03-28
+- **init:** add obsolete template cleanup for cleaner migration
+- **rules:** add TICKET VERIFICATION RULE to original agents.md
+- **ticket:** add priority property to tickets
+- **ticket:** add sequential hostname-aware ticket naming (NNN-hostname-topic)
+- **ticket:** auto-sequence numbering and hostname-based naming (limit 8 chars)
 
 
 ### Fixed
 
-- **deuk-agent-rule:** `printHandoffTip` missing in CLI (handoff tip after `init`)
+- **rules:** force use of local latest deuk-agent-rule to avoid npx cache issues
+- **scripts:** correct log output for OSS repository url example
 
 
 ### Changed
 
-- **docs:** README § Handoffs; GitHub About text; npm keywords; CLI survey adds Claude, Windsurf, JetBrains AI Assistant
-- **agents:** optional `.cursor/plans/*.plan.md` mirror for plan-style UI; chat `Path:` line and optional first-line path in handoff files
-- **deuk-agent-rule:** `init` prints a short handoff tip after ensuring `.deuk-agent-handoff/`
-- **deuk-agent-rule:** default `--rules prefix` overwrites existing `deuk-agent-rule-*.mdc` on repeat `init` (package updates without a separate `merge`)
-- **deuk-agent-rule:** `.deuk-agent-rule.config.json` stores interactive choices; later `init` reuses them (`--interactive` to change; `--non-interactive` for CI only)
-
-
-## [1.0.12] - 2026-03-27
-
-
-### Fixed
+-  add Step 4 (Ticket Verification) to README files
+-  clarify global installation and OS-specific permissions
+-  enforce ticket reference in implementation artifacts
 
-- **ci:** release workflow runs on pushes to `master`
-
-### Changed
-
-- **agents:** require full repo-root paths for handoff file links
-
-## [1.0.11] - 2026-03-26
-
-
-### Added
-
-- **ci:** GitHub Release workflow for version tags and `chore(release):` commits on `main` / `master`
-
-## [1.0.10] - 2026-03-26
-
-
-### Added
-
-- **deuk-agent-rule:** changelog template headers without per-commit links
-
-## [1.0.9] - 2026-03-27
-
-### Added
-
-- **deuk-agent-rule:** release changelog tooling; handoff directory gitignore; pre-work handoff scan; AGENTS inject newline fix
-
-### Changed
-
-- **agents:** DeukAgentRules/handoff/LATEST.md handoff path for consumer repos
-
-## [1.0.8] - 2026-03-27
-
-### Added
-
-- This changelog and npm `files` entry so releases are traceable.
-
-## [1.0.7] - 2026-03-27
-
-### Added
-
-- `init`: create `.deuk-agent-handoff/` and append `.gitignore` rules for local handoffs.
-- CLI: pre-work handoff scan; `publish/AGENTS.md` and `multi-ai-workflow.mdc` updates.
-
-### Fixed
-
-- AGENTS tagged-region merge: trailing newline after injected blocks.
-
-## [1.0.5] - 2026-03-26
-
-### Changed
-
-- README and package metadata (Deuk Family tagline, npm keywords, GitHub Topics note).
-
-## [1.0.4] - 2026-03-26
-
-### Changed
-
-- Release packaging includes `package-lock.json` for reproducible installs.
-- README: absolute links for the npm package page.
+## [2.3.2] - 2026-04-17
+
+
+### Fixed
+
+- **cli:** resolve `ERR_MODULE_NOT_FOUND` in distributed environments by fixing hardcoded `yaml` dependency path
+- **dependencies:** add `yaml` to explicit dependencies list
+
+## [2.3.1] - 2026-04-17
+
+
+### Changed
+
+- **readme:** add changelog and automated release instructions
+
+## [2.3.0] - 2026-04-17
+
+
+### Added
+
+- Advance AI pipeline integration and optional synchronization system
+- **cli:** add --submodule filter to ticket list command
+- **cli:** restore ticket archive and reports workflows to modular architecture
+- **rules:** advance rules for Unity Client, WebApp, and C++ Server hybrid environment
+- **ticket:** implementation of decentralized ticket management & sharing policy
+- **ticket:** upgrade to V2 YAML Front-matter and Categorized List
+
+
+### Fixed
+
+- **ticket:** deprecate LATEST.md, unify pointer to ACTIVE_TICKET.md
+- **ticket:** resolve issue where active tickets were not listed for DeukAgentRules repo
+
+
+### Changed
+
+- **readme:** clarify YAML front matter preservation and distributed ticket workflow for v2.2.2
+- **readme:** restore count headers and npm badges
+- **rules:** enforce CLI usage for ticket reading to prevent manual JSON parsing
+- Update CLI reference with close and migrate commands
+
+## [1.0.18] - 2026-04-12
+
+
+### Added
+
+- **ai:** map conversational ticket requests to implicit CLI execution
+- **cli:** implement ticket archive and reporting workflow
+- **rules:** map conversational ticket aliases to implicit CLI execution
+
+
+### Changed
+
+- **readme:** add ticket archive and reports CLI usage to documentation
+- **readme:** describe natural language CLI prompting alternatives
+- **readme:** provide explicit conversational prompt examples inside option tables
+- **readme:** provide explicit update guide
+- **rules:** add prompting guide and execution report archival rule
+
+## [1.0.17] - 2026-04-06
+
+
+### Fixed
+
+- **template:** move ticket repo-relative marker to bottom
+
+## [1.0.16] - 2026-04-05
+
+
+### Added
+
+- **workflow:** add auto-verification and final report to agent workflows
+
+## [1.0.15] - 2026-04-05
+
+
+### Added
+
+- Migrate and rename handoff terminology to ticket in CLI and templates
+
+
+### Changed
+
+- Add strict rule for DeukPack namespace requirement
+- Completely eradicate legacy Handoff references from AGENTS.md, templates, and mdc rules
+- Enforce DeukPack code format and API strictly as a hard rule
+- Refactor README usage guide and workflow
+
+## [1.0.14] - 2026-04-02
+
+
+### Added
+
+- **cli:** extend merge tooling and sync publish docs
+- **rules:** forbid 'sync' word in commit titles in agent rules
+- **handoff:** add indexed handoff workflow and CLI
+- **architecture:** migrate template architecture to zero-touch NPM bundle scaffolding
+
+
+### Fixed
+
+- **cli:** resolve html entity syntax error in template generator
+
+
+### Changed
+
+- **docs:** public-facing RELEASING and changelog wording; sync-bundle comment
+- **docs:** update README with token efficiency mechanism and zero-touch template scaffolding
+
+## [1.0.13] - 2026-03-28
+
+
+### Fixed
+
+- **deuk-agent-rule:** `printHandoffTip` missing in CLI (handoff tip after `init`)
+
+
+### Changed
+
+- **docs:** README § Handoffs; GitHub About text; npm keywords; CLI survey adds Claude, Windsurf, JetBrains AI Assistant
+- **agents:** optional `.cursor/plans/*.plan.md` mirror for plan-style UI; chat `Path:` line and optional first-line path in handoff files
+- **deuk-agent-rule:** `init` prints a short handoff tip after ensuring `.deuk-agent-handoff/`
+- **deuk-agent-rule:** default `--rules prefix` overwrites existing `deuk-agent-rule-*.mdc` on repeat `init` (package updates without a separate `merge`)
+- **deuk-agent-rule:** `.deuk-agent-rule.config.json` stores interactive choices; later `init` reuses them (`--interactive` to change; `--non-interactive` for CI only)
+
+
+## [1.0.12] - 2026-03-27
+
+
+### Fixed
+
+- **ci:** release workflow runs on pushes to `master`
+
+### Changed
+
+- **agents:** require full repo-root paths for handoff file links
+
+## [1.0.11] - 2026-03-26
+
+
+### Added
+
+- **ci:** GitHub Release workflow for version tags and `chore(release):` commits on `main` / `master`
+
+## [1.0.10] - 2026-03-26
+
+
+### Added
+
+- **deuk-agent-rule:** changelog template headers without per-commit links
+
+## [1.0.9] - 2026-03-27
+
+### Added
+
+- **deuk-agent-rule:** release changelog tooling; handoff directory gitignore; pre-work handoff scan; AGENTS inject newline fix
+
+### Changed
+
+- **agents:** DeukAgentRules/handoff/LATEST.md handoff path for consumer repos
+
+## [1.0.8] - 2026-03-27
+
+### Added
+
+- This changelog and npm `files` entry so releases are traceable.
+
+## [1.0.7] - 2026-03-27
+
+### Added
+
+- `init`: create `.deuk-agent-handoff/` and append `.gitignore` rules for local handoffs.
+- CLI: pre-work handoff scan; `publish/AGENTS.md` and `multi-ai-workflow.mdc` updates.
+
+### Fixed
+
+- AGENTS tagged-region merge: trailing newline after injected blocks.
+
+## [1.0.5] - 2026-03-26
+
+### Changed
+
+- README and package metadata (Deuk Family tagline, npm keywords, GitHub Topics note).
+
+## [1.0.4] - 2026-03-26
+
+### Changed
+
+- Release packaging includes `package-lock.json` for reproducible installs.
+- README: absolute links for the npm package page.

package/README.ko.md

@@ -25,16 +25,26 @@ Cursor, GitHub Copilot, Gemini / Antigravity, Claude, Windsurf, JetBrains AI Ass
 
 ## 🛠️ 워크스페이스 초기화 (Getting Started)
 
-프로젝트 루트에서 최초 1회 패키지를 설치하고 초기화합니다.
+본 패키지는 여러 서브모듈 및 프로젝트 전반에서 빈번하게 사용되는 CLI 도구이므로 **전역(Global) 설치를 강력히 권장**합니다.
 
 ```bash
-npm install deuk-agent-rule
-npx deuk-agent-rule init
+npm install -g deuk-agent-rule
+deuk-agent-rule init
 ```
 
+> [!NOTE]
+> **전역 설치(Global Install) 권한 이슈 해결방안**:
+> - **Linux/macOS**: 기본적으로 `npm install -g` 실행 시 `EACCES` 권한 오류가 발생할 수 있습니다. Node 버전 매니저(`nvm`, `fnm` 등)를 사용하여 권한 제약을 회피하는 것이 가장 좋으나, 시스템 Node를 사용하는 경우 불가피하게 `sudo npm install -g deuk-agent-rule` 명령을 사용해야 합니다.
+> - **Windows**: Node.js가 `Program Files` 등 시스템 폴더에 설치된 경우, 터미널(PowerShell/CMD)을 **관리자 권한**으로 실행한 상태에서 설치해야 오류가 발생하지 않습니다.
+
+### 💡 전역(Global) 설치를 권장하는 이유
+1. **npx 캐시 이슈 예방**: `npx deuk-agent-rule` 명령어는 로컬 npm 캐시에 의존하므로, 새로운 로직(예: 호스트네임 기반 순번 부여 등)이 포함된 최신 배포본을 무시하고 구버전을 실행하는 치명적인 에이전트 오동작을 유발할 수 있습니다.
+2. **실행 속도 최적화**: 매번 임시로 패키지를 다운로드/확인하는 `npx` 방식 대비 챗봇 에이전트가 즉각적으로 CLI 응답을 받을 수 있습니다.
+3. **크로스 레포지토리 일관성**: Deuk Family의 여러 서브모듈 및 독립된 마이크로서비스 저장소들을 오가며 항상 동일한 버전의 에이전트 룰 엔진을 적용할 수 있습니다.
+
 초기화 시 프로젝트의 **기술 스택**, **사용 중인 에이전트 툴**, 그리고 **티켓 공유 정책**을 묻는 대화형 질문이 나타납니다. 
 - **티켓 공유 정책**: 각 저장소 단위의 `.deuk-agent-ticket/` 폴더를 Git으로 추적하여 팀과 공유할지, 아니면 로컬 전용으로 둘지 결정합니다.
-- 스택 변경이 필요 없으면 이후에는 `npx deuk-agent-rule init`만 쳐서 규칙을 최신화할 수 있습니다.
+- 스택 변경이 필요 없으면 이후에는 `deuk-agent-rule init`만 쳐서 규칙을 최신화할 수 있습니다. (전역 설치를 하지 않았다면 `npx deuk-agent-rule init`으로 대체 가능합니다.)
 - CI나 스크립트 환경에서는 대화형 입력을 끄기 위해 `--non-interactive` 파라미터를 추가하세요.
 
 ### 🔄 규칙 패키지 업데이트 (Update Rules)
@@ -54,7 +64,7 @@ npx deuk-agent-rule init --non-interactive
 1. **`.deuk-agent-templates/` (에이전트 템플릿)**: AI가 어떠한 양식으로 작업을 처리하고 보고해야 하는지 정의된 공식 뼈대(`TICKET_TEMPLATE.md`)가 지정됩니다.
 2. **`.deuk-agent-ticket/` (티켓 실행 공간)**: 실제 지시서(`TICKET-XXX.md`)가 발급되는 공간입니다. 서브모듈 단위로 티켓을 분산 관리할 수 있어 서브모듈만 떼어가도 히스토리가 유지됩니다. (공유 정책에 따라 `.gitignore`에 자동으로 기재될 수 있습니다.)
 
-이러한 샌드박스 폴더들을 활용하여 스퍼트를 올리는 **최적의 AI 코딩 3단계**는 다음과 같습니다.
+이러한 샌드박스 폴더들을 활용하여 스퍼트를 올리는 **최적의 AI 코딩 4단계**는 다음과 같습니다.
 
 ### [Step 1] 티켓 발급 및 계층적 관리 (Ticket Creation & Delegation)
 AI에게 중구난방으로 지시하지 마세요. 명확한 티켓을 발급하여 **문맥(Context)을 소속 저장소 단위로 좁혀주어야** 합니다.
@@ -78,23 +88,25 @@ AI는 티켓 내에 정의된 Phase(진행 단계)를 충실히 읽고, **자신
 ### [Step 3] 검증 및 상태 갱신 (Review & Closure)
 AI가 코드를 작성하며 티켓 내 마크업의 체크박스(`[x]`)를 갱신합니다. 에이전트의 세션(기억 한계)이 가득 차면, 티켓 내용만 디스크에 남겨둔 채 챗봇 창을 끄고 새 창을 열어 다시 [Step 2]를 지시하면 깔끔하게 인수인계가 이루어집니다.
 모든 작업이 끝나면 Phase 상태를 `[Phase 완료]`로 승급시킵니다. 터미널 명령어를 직접 치는 대신, **AI 챗봇 프롬프트에 "현재 진행 중인 티켓 리스트를 보여줘" 또는 "완료된 티켓들을 보고서와 함께 아카이브 해 줘"라고 자연어로 지시**하여 AI가 알아서 CLI를 호출해 리스트업 및 관리하게 위임할 수도 있습니다.
-직접 터미널에서 상태를 파악하시려면 아래 명령을 사용하세요:
-
 ```bash
 npx deuk-agent-rule ticket list
 ```
 ```text
-📦 Agent Tickets (Direct System Scan):
-  ✅ [TICKET-DEUKUI-Button.md]
-     Title: 버튼 컴포넌트 추가
-     Target: DeukUI
-     Status: [완료]
-  🔨 [TICKET-ui-refactoring.md]
-     Title: 플러그인 UI 리팩토링
-     Target: DeukUI
-     Status: [진행 중]
+#  STATUS   SUBMODULE   GROUP       PROJECT     CREATED                  TITLE
+1  [ ]      DeukPack    sub         global      2026-04-18T13:34:32.484Z naming-consistency
 ```
 
+### [Step 4] 티켓 검증 (자가 교정)
+모든 진행 단계가 `[x]`로 완료되면, AI에게 마지막으로 다음과 같이 지시합니다:
+> *"이 작업에 대해 **티켓 검증**을 진행해 줘."*
+
+AI는 `AGENTS.md`에 정의된 **[TICKET VERIFICATION RULE]**에 따라 즉시 3단계 정밀 진단을 수행합니다:
+1. **오류 분석**: 잠재적인 빌드 경고나 깨진 의존성(Side Effects) 전수 조사.
+2. **규약 정합성**: 수정된 파일명과 클래스명이 프로젝트 아키텍처 가이드와 완벽히 일치하는지 재검증.
+3. **잠재 이슈 보고**: 하위 호환성 파괴 위험이나 네이티브 빌드 제약사항 등 미검증 시나리오 리스트업.
+
+이 과정을 통해 에이전트의 결과물은 단순한 "기능 구현"을 넘어 "프로덕션 레벨"의 아키텍처 정합성을 갖추게 됩니다.
+
 ---
 
 ## 🤖 에이전트 프롬프팅 가이드 (Prompting Guide)
@@ -113,6 +125,12 @@ npx deuk-agent-rule ticket list
 
 업무 자동화 및 타깃 제어를 위한 상세 옵션입니다.
 
+> [!NOTE]
+> **패키지 메인테이너(기여자) 전용 - 로컬 개발 환경 권한 주의사항**: 
+> 일반 사용자는 해당되지 않습니다. `DeukAgentRules` 저장소 내부 소스코드를 직접 수정하며 로컬 패치를 즉시 테스트하려는 메인테이너의 경우, 글로벌 캐시된 `npx deuk-agent-rule` 대신 `node ./scripts/cli.mjs`를 직접 호출해야 합니다.
+> - **Linux/macOS**: 로컬 심링크(`npm link`) 생성 시 `sudo` 권한이 필요할 수 있으며, 스크립트를 직접 실행(`./scripts/cli.mjs`)할 경우 실행 권한(`chmod +x`) 이슈가 발생할 수 있으므로 `node` 명령어를 통한 명시적 호출이 가장 안전합니다.
+> - **Windows**: `npm link` 사용 시 관리자 권한(또는 개발자 모드)이 필요하며, PowerShell 스크립트 실행 정책(Execution Policy)에 의해 래퍼 스크립트가 차단될 수 있으므로 권한 제약이 없는 `node ./scripts/cli.mjs` 호출 방식을 권장합니다.
+
 ### Ticket 기반 명령
 아래 CLI 명령어들은 터미널에 직접 입력하는 대신, **AI 챗봇에게 자연어 프롬프트로 지시**하여 실행을 위임할 수 있습니다.
 

package/README.md

@@ -25,15 +25,25 @@ It standardizes project rules (`AGENTS.md`, `.cursor/rules`) and strongly preven
 
 ## 🛠️ Getting Started (Workspace Initialization)
 
-Install and initialize the package once at the project root.
+Since this CLI tool is used frequently across multiple repositories and submodules, a **global installation is highly recommended**.
 
 ```bash
-npm install deuk-agent-rule
-npx deuk-agent-rule init
+npm install -g deuk-agent-rule
+deuk-agent-rule init
 ```
 
+> [!NOTE]
+> **Global Install Permission Troubleshooting**:
+> - **Linux/macOS**: Running `npm install -g` may result in `EACCES` permission errors. It is highly recommended to use a Node version manager (`nvm`, `fnm`, etc.) to bypass these constraints. If using the system Node installation, you may unavoidably need to use `sudo npm install -g deuk-agent-rule`.
+> - **Windows**: If Node.js is installed in a system directory like `Program Files`, you must run your terminal (PowerShell/CMD) as an **Administrator** for the global installation to complete successfully.
+
+### 💡 Why Global Installation?
+1. **Preventing `npx` Cache Issues**: Running `npx deuk-agent-rule` relies on the local npm cache, which may silently execute an outdated version of the CLI. This has been proven to cause severe agent hallucinations or ticket formatting errors (e.g., missing hostname sequence IDs).
+2. **Execution Speed**: The chatbot agent receives instant CLI responses without the overhead of `npx` checking for temporary package downloads.
+3. **Cross-Repository Consistency**: It allows you to reliably apply the exact same version of the agent rules across various submodules and independent microservices in the Deuk Family ecosystem.
+
 Upon initialization, interactive questions will ask for the project's **tech stack** and **agent tools in use**. Based on your selections, optimized markdown templates and rule files (`.cursor/rules/*`) will be automatically generated and synchronized.
-- If you don't need to change the tech stack later, simply run `npx deuk-agent-rule init` to refresh the rules.
+- If you don't need to change the tech stack later, simply run `deuk-agent-rule init` to refresh the rules. (If not installed globally, you can fallback to `npx deuk-agent-rule init`).
 - Suppress interactive prompts in CI or script environments by appending the `--non-interactive` flag.
 
 ### 🔄 Updating the Rules Package
@@ -53,7 +63,7 @@ Running `npx deuk-agent-rule init` deploys a **zero-touch scaffolding sandbox**
 1. **`.deuk-agent-templates/` (Agent Templates)**: Houses the official blueprint (`TICKET_TEMPLATE.md`) dictating how AIs must process and report tasks. Committed alongside your source code to serve as the team's rulebook.
 2. **`.deuk-agent-ticket/` (Ticket Execution Space)**: The covert space where volatile instructions (`TICKET-XXX.md`) are exchanged between agents and workers. (Automatically hidden by `.gitignore` to prevent security leaks and repository bloat).
 
-The optimal **3-Step AI Coding Sequence** utilizing these sandbox folders is as follows.
+The optimal **4-Step AI Coding Sequence** utilizing these sandbox folders is as follows.
 
 ### [Step 1] Ticket Creation & Submodule Isolation
 Do not issue scattered, unbounded commands to your AI. Narrowing the **context** via a clear ticket is strictly required to prevent astronomical costs and accidental code corruption.
@@ -77,23 +87,25 @@ The AI will faithfully read the defined Phases in the ticket and write optimized
 ### [Step 3] Status Review & Closure
 As the AI writes the code, it will simultaneously update the markup checkboxes (`[x]`) inside the ticket. If the agent's session memory limit is approaching, simply leave the ticket file saved, turn off the chat window, open a fresh session, and issue [Step 2] again. The handoff (session transfer) is seamlessly completed.
 Once all steps are accomplished, promote the Phase status to `[Phase Complete]`. Instead of manually typing terminal commands, **you can simply tell your AI chatbot via natural language prompt: "Show me the list of active tickets" or "Archive the completed tickets with reports"**, and the AI will autonomously invoke the CLI to manage them for you.
-To track tickets manually from the terminal, run:
-
 ```bash
 npx deuk-agent-rule ticket list
 ```
 ```text
-📦 Agent Tickets (Direct System Scan):
-  ✅ [TICKET-DEUKUI-Button.md]
-     Title: Add Button Component
-     Target: DeukUI
-     Status: [Complete]
-  🔨 [TICKET-ui-refactoring.md]
-     Title: Plugin UI Refactoring
-     Target: DeukUI
-     Status: [In Progress]
+#  STATUS   SUBMODULE   GROUP       PROJECT     CREATED                  TITLE
+1  [ ]      DeukPack    sub         global      2026-04-18T13:34:32.484Z naming-consistency
 ```
 
+### [Step 4] Ticket Verification (Self-Correction)
+After all phases are marked as `[x]`, you should issue a final command to the AI:
+> *"Proceed with **Ticket Verification** for this task."*
+
+The AI, following the strictly defined **[TICKET VERIFICATION RULE]** in `AGENTS.md`, will then autonomously perform a 3-stage audit:
+1. **Side Effect Analysis**: Detecting potential build warnings or broken dependencies.
+2. **Convention Audit**: Re-verifying if filenames and classes perfectly match project architecture documents.
+3. **Potential Issue Reporting**: Listing breaking changes or unverified edge cases (e.g., native build constraints).
+
+This final step ensures that the agent's output is not just "functional" but "production-grade" and architecturally sound.
+
 ---
 
 ## 🤖 AI Agent Prompting Guide
@@ -112,6 +124,12 @@ Even after installing and initializing the package, some AI agents (Cursor, Gemi
 
 Advanced commands for workflow automation and target control.
 
+> [!NOTE]
+> **For Package Maintainers/Contributors Only - Local Development**:
+> This does not apply to general users. If you are modifying the `DeukAgentRules` source code and need to immediately test local patches bypassing the globally cached `npx deuk-agent-rule`, explicitly invoke `node ./scripts/cli.mjs`.
+> - **Linux/macOS**: Creating symlinks (`npm link`) may require `sudo` privileges. Direct script execution (`./scripts/cli.mjs`) may trigger `chmod +x` permission issues, making explicit `node` invocation the safest workaround.
+> - **Windows**: `npm link` requires Administrator rights (or Developer Mode) to create symlinks, and PowerShell execution policies may block `.cmd` wrapper scripts. Explicitly calling `node ./scripts/cli.mjs` safely bypasses these OS-level restrictions.
+
 ### Ticket-based Commands
 Instead of manually typing the CLI commands below into the terminal, you can **delegate their execution to your AI chatbot by giving natural language prompt instructions**.
 

package/bundle/AGENTS.md

@@ -12,6 +12,8 @@
   - For Korean responses, use polite '해요체(-요)' instead of formal '하십시오체(-다/까)'.
 - **핸드오프 저장 후 채팅**: 파일로 남긴 뒤 채팅에 **`Path: \`루트기준/전체/경로.md\``** 형태로 **한 줄**을 반드시 넣어 다음 세션이 동일 파일을 연다.
 - **플랜 UI(선택)**: 플랜 전용 패널에 같은 문서를 띄우려면, 관리 중인 **multi-ai-workflow** 규칙에 적힌 **선택적 미러 경로**(예: `.cursor/plans/*.plan.md`)에 동일 본문을 둘 수 있다. 정본은 지정된 티켓 폴더를 유지하고 두 곳 내용을 맞출 것.
+- **Error Loop Prevention (하드룰)**: 명령 실행이나 컴파일 등에서 동일/유사 에러가 2회 이상 반복 발생 시, 에이전트는 절대 임의로 코드 방향을 틀거나 땜질을 시도해서는 안 됩니다. 즉시 작업을 멈추고 현상을 분석한 후 **티켓을 명시적으로 발행**해야 합니다.
+- **Plan in Ticket (하드룰)**: 문제 해결을 위한 모든 실행 계획과 설계는 `implementation_plan.md` 같은 임의의 부산물이 아닌, **정식 티켓 본문 내**에 작성하고 이를 사용자에게 확인시켜야 합니다.
 
 English sections above are canonical for tooling; this block is a short Korean mirror for the same rules.
 
@@ -64,7 +66,8 @@ When given a ticket, you MUST run commands and write code **strictly within the
 4. **Execute Phase**: Process only the checklist for the **Current Phase**. Do not hallucinate or wander into other architectural areas.
 5. **Update Status**: Mark checkboxes (`[x]`) as tasks are completed.
 6. **Archive on Completion**: When all phases are completed, append the execution report at the bottom under a `## 📜 Execution Report` header. **Then, YOU MUST execute `npx deuk-agent-rule ticket archive <ticket-id>` (or `--latest`)** to properly close and archive the ticket. DO NOT attempt to manually `mv` files.
+7. **[TICKET REFERENCE RULE]**: 부분 개선 또는 기능 추가 시, 구현 아티팩트(`implementation_plan.md`, `task.md`, `walkthrough.md`) 상단에 반드시 해당 티켓 번호(ID)를 명시하여 추적 가능성을 확보하십시오.
 
 All Tickets are volatile and strictly local. Do not attempt to version them or mirror them to obsolete plan directories.
 
-<!-- deuk-agent-rule:end -->
+<!-- deuk-agent-rule:end -->

package/bundle/templates/TICKET_TEMPLATE.md

@@ -1,40 +1,37 @@
-
-# Task: [Task Title / Ticket Number]
-
-> **[CAUTION FOR AI AGENTS]** 
-> You are operating within a locked multi-module monorepo. 
-> 1. Restrict absolutely all analysis, file creation, and modifications to the declared **[Target Submodule]** below.
-> 2. Read the files listed in **[Context Files]** before doing ANY code generation.
-> 3. DO NOT leak configuration, logic, or dependencies from other submodules.
-
-## 🎯 Scope Bounds
-
-- **Target Submodule:** `[e.g., DeukUI | DeukPack | DeukNavigation]`
-- **Context Files:** 
-  - `[e.g., DeukAgentRules/templates/MODULE_RULE_TEMPLATE.md]`
-  - `[e.g., path/to/your/specific/rules.md]`
-
-## 📁 Files to Modify
-- `path/from/root/to/target1`: [Specific instructions. Don't write 'refactor', describe WHAT to refactor.]
-- `path/from/root/to/target2`: [Instructions...]
-
-## 🏗️ Design Decisions (For Context)
-- [Why are we doing this? E.g., "To isolate the IR Layout bindings from DOM events"]
-- [What pattern to use?]
-
-## 🛑 Strict Constraints (Rules to never break)
-- [e.g., Do NOT remove existing @ts-nocheck headers]
-- [e.g., MUST retain C# [SerializeField] directives]
-- [e.g., Do NOT import Vue logic into DeukPack]
-
-## 🔄 Phased Execution Steps
-> Agent: Do NOT attempt to do Phase 3 before Phase 1 is fully tested. Use separate chat messages per phase if the task is large.
-1. [Phase 1> Setup / Parsing]
-2. [Phase 2> Core Logic Change]
-3. [Phase 3> Cleanup / Verification]
-
-## ✅ Verification / QA
-- [e.g., Check CLI command output `npm run test`]
-- [e.g., Validate Inspector mounts properly in Figma]
-
+# Task: [Task Title] | Ticket: [TICKET-XXX]
 
+> **[CAUTION FOR AI AGENTS]** 
+> You are operating within a locked multi-module monorepo. 
+> 1. Restrict absolutely all analysis, file creation, and modifications to the declared **[Target Submodule]** below.
+> 2. Read the files listed in **[Context Files]** before doing ANY code generation.
+> 3. DO NOT leak configuration, logic, or dependencies from other submodules.
+
+## 🎯 Scope Bounds
+
+- **Target Submodule:** `[e.g., DeukUI | DeukPack | DeukNavigation]`
+- **Context Files:** 
+  - `[e.g., DeukAgentRules/templates/MODULE_RULE_TEMPLATE.md]`
+  - `[e.g., path/to/your/specific/rules.md]`
+
+## 📁 Files to Modify
+- `path/from/root/to/target1`: [Specific instructions. Don't write 'refactor', describe WHAT to refactor.]
+- `path/from/root/to/target2`: [Instructions...]
+
+## 🏗️ Design Decisions (For Context)
+- [Why are we doing this? E.g., "To isolate the IR Layout bindings from DOM events"]
+- [What pattern to use?]
+
+## 🛑 Strict Constraints (Rules to never break)
+- [e.g., Do NOT remove existing @ts-nocheck headers]
+- [e.g., MUST retain C# [SerializeField] directives]
+- [e.g., Do NOT import Vue logic into DeukPack]
+
+## 🔄 Phased Execution Steps
+> Agent: Do NOT attempt to do Phase 3 before Phase 1 is fully tested. Use separate chat messages per phase if the task is large.
+1. [Phase 1> Setup / Parsing]
+2. [Phase 2> Core Logic Change]
+3. [Phase 3> Cleanup / Verification]
+
+## ✅ Verification / QA
+- [e.g., Check CLI command output `npm run test`]
+- [e.g., Validate Inspector mounts properly in Figma]

package/package.json

@@ -1,55 +1,49 @@
-{
-  "name": "deuk-agent-rule",
-  "version": "2.3.1",
-  "description": "DeukAgentRules: generic AGENTS.md + .cursor rule templates with init/merge CLI (npm name: deuk-agent-rule).",
-  "keywords": [
-    "agents-md",
-    "cursor-rules",
-    "copilot",
-    "gemini",
-    "claude",
-    "windsurf",
-    "jetbrains",
-    "ticket",
-    "deuk-family",
-    "deukpack-ecosystem"
-  ],
-  "license": "Apache-2.0",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/joygram/DeukAgentRules.git"
-  },
-  "bugs": {
-    "url": "https://github.com/joygram/DeukAgentRules/issues"
-  },
-  "homepage": "https://github.com/joygram/DeukAgentRules#readme",
-  "files": [
-    "bundle/**/*",
-    "scripts/**/*.mjs",
-    "README.md",
-    "README.ko.md",
-    "CHANGELOG.md"
-  ],
-  "scripts": {
-    "sync": "node scripts/sync-bundle.mjs",
-    "prepack": "node scripts/sync-bundle.mjs",
-    "bump": "commit-and-tag-version",
-    "bump:patch": "commit-and-tag-version -r patch",
-    "bump:minor": "commit-and-tag-version -r minor",
-    "bump:major": "commit-and-tag-version -r major",
-    "merge:dry": "node scripts/cli.mjs merge --dry-run --cwd .. --agents skip",
-    "sync:oss": "node scripts/sync-oss.mjs"
-  },
-  "engines": {
-    "node": ">=18"
-  },
-  "bin": {
-    "deuk-agent-rule": "./scripts/cli.mjs"
-  },
-  "devDependencies": {
-    "commit-and-tag-version": "^12.7.1"
-  },
-  "dependencies": {
-    "ejs": "^5.0.2"
-  }
-}
+{
+  "name": "deuk-agent-rule",
+  "version": "2.4.1",
+  "description": "DeukAgentRules: generic AGENTS.md + .cursor rule templates with init/merge CLI (npm name: deuk-agent-rule).",
+  "keywords": [
+    "agents-md",
+    "cursor-rules",
+    "copilot",
+    "gemini",
+    "claude",
+    "windsurf",
+    "jetbrains",
+    "ticket",
+    "deuk-family",
+    "deukpack-ecosystem"
+  ],
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/joygram/DeukAgentRules.git"
+  },
+  "bugs": {
+    "url": "https://github.com/joygram/DeukAgentRules/issues"
+  },
+  "homepage": "https://github.com/joygram/DeukAgentRules#readme",
+  "files": [
+    "LICENSE",
+    "bundle/**/*",
+    "scripts/**/*.mjs",
+    "README.md",
+    "README.ko.md",
+    "CHANGELOG.md",
+    "CHANGELOG.ko.md"
+  ],
+  "scripts": {
+    "sync": "node scripts/sync-bundle.mjs",
+    "prepack": "node scripts/sync-bundle.mjs"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "bin": {
+    "deuk-agent-rule": "./scripts/cli.mjs"
+  },
+  "dependencies": {
+    "ejs": "^5.0.2",
+    "yaml": "^2.8.3"
+  }
+}

package/scripts/cli-args.mjs

@@ -19,6 +19,7 @@ export function parseTicketArgs(argv) {
     else if (a === "--all") out.all = true;
     else if (a === "--status") out.status = argv[++i];
     else if (a === "--archived") out.archived = true;
+    else if (a === "--priority") out.priority = argv[++i];
     else if (a === "--report") out.report = argv[++i];
     else if (a === "--json") out.json = true;
     else if (a === "--remote") out.remote = argv[++i];

package/scripts/cli-init-commands.mjs

@@ -11,13 +11,27 @@ function syncTemplates(cwd, bundleRoot, dryRun) {
   if (!existsSync(tplSrcDir)) return;
   if (!dryRun) mkdirSync(tplDestDir, { recursive: true });
 
-  for (const name of readdirSync(tplSrcDir)) {
-    if (!name.endsWith(".md")) continue;
+  const srcFiles = readdirSync(tplSrcDir).filter(n => n.endsWith(".md"));
+  const destFiles = existsSync(tplDestDir) ? readdirSync(tplDestDir).filter(n => n.endsWith(".md")) : [];
+
+  // 1. Copy/Update new templates
+  for (const name of srcFiles) {
     const src = join(tplSrcDir, name);
     const dest = join(tplDestDir, name);
     if (!dryRun) copyFileSync(src, dest);
     console.log(`template synced: ${dest}`);
   }
+
+  // 2. Cleanup obsolete templates (Migration)
+  for (const name of destFiles) {
+    if (!srcFiles.includes(name)) {
+      const obsolete = join(tplDestDir, name);
+      if (!dryRun) {
+        import("fs").then(fs => fs.unlinkSync(obsolete));
+      }
+      console.log(`template removed (obsolete): ${obsolete}`);
+    }
+  }
 }
 
 

package/scripts/cli-ticket-commands.mjs

@@ -1,4 +1,5 @@
 import { existsSync, mkdirSync, readFileSync, writeFileSync, unlinkSync, copyFileSync, readdirSync, rmSync, statSync } from "fs";
+import { hostname } from "os";
 import { basename, join, dirname, relative, resolve } from "path";
 import { toSlug, toRepoRelativePath, inferRefTitleAndTopic, resolveReferencedTicketPath, toPosixPath, stringifyFrontMatter } from "./cli-utils.mjs";
 import { TICKET_DIR_NAME, appendTicketEntry, rebuildTicketIndexFromTopicFilesIfNeeded, detectConsumerTicketDir, readTicketIndexJson, writeTicketIndexJson, writeTicketListFile, syncActiveTicketPointer, generateTicketId, syncToPipeline } from "./cli-ticket-logic.mjs";
@@ -31,7 +32,28 @@ export async function runTicketCreate(opts) {
 
     // Find nearest or create in CWD if missing
     const ticketDir = detectConsumerTicketDir(opts.cwd, { createIfMissing: true });
-    const abs = join(ticketDir, group, `${topic}-${Date.now()}.md`);
+    
+    // Calculate next sequence number by scanning existing files
+    let maxSeq = 0;
+    const allFiles = [];
+    const scanDirs = [join(ticketDir, "sub"), join(ticketDir, "main"), join(ticketDir, "archive/sub"), join(ticketDir, "archive/main")];
+    for (const d of scanDirs) {
+      if (existsSync(d)) {
+        const files = readdirSync(d);
+        for (const f of files) {
+          const match = f.match(/^(\d+)-/);
+          if (match) {
+            const num = parseInt(match[1], 10);
+            if (num > maxSeq) maxSeq = num;
+          }
+        }
+      }
+    }
+    const nextSeq = String(maxSeq + 1).padStart(3, "0");
+    const hName = hostname().toLowerCase().slice(0, 8);
+    const finalFileName = `${nextSeq}-${hName}-ticket-${topic}.md`;
+
+    const abs = join(ticketDir, group, finalFileName);
     mkdirSync(join(ticketDir, group), { recursive: true });
     path = toRepoRelativePath(opts.cwd, abs);
 

package/scripts/cli-ticket-logic.mjs

@@ -1,6 +1,7 @@
 import { existsSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSync, unlinkSync, copyFileSync } from "fs";
 import { basename, dirname, join, relative } from "path";
 import { createHash } from "crypto";
+import { hostname as osHostname } from "os";
 import { toPosixPath, toRepoRelativePath, toSlug, formatTimestampForFile, makeEntryId, detectProjectFromBody, deriveTopicFromBaseName, parseFrontMatter, stringifyFrontMatter, loadInitConfig } from "./cli-utils.mjs";
 
 export const TICKET_DIR_NAME = ".deuk-agent-ticket";
@@ -82,10 +83,10 @@ export function renderTicketListMarkdown(cwd, entries) {
   const activeRows = sorted.filter(e => e.status !== "archived").map((e, i) => renderLine(e, i, ticketDir, cwd));
   const archivedRows = sorted.filter(e => e.status === "archived").slice(0, 50).map((e, i) => renderLine(e, i, ticketDir, cwd));
 
-  let combinedRows = "### 🚀 Active Tickets\n\n| # | Status | Title | Group | Project | Created | Path |\n|---|---|---|---|---|---|---|\n" + 
-                     (activeRows.join("\n") || "| - | - | No active tickets | - | - | - | - |") + 
-                     "\n\n### 📦 Archived Tickets\n\n| # | Status | Title | Group | Project | Created | Path |\n|---|---|---|---|---|---|---|\n" + 
-                     (archivedRows.join("\n") || "| - | - | No archived tickets | - | - | - | - |");
+  let combinedRows = "### 🚀 Active Tickets\n\n| # | Status | Pri | Title | Group | Project | Created | Path |\n|---|---|---|---|---|---|---|---|\n" + 
+                     (activeRows.join("\n") || "| - | - | - | No active tickets | - | - | - | - |") + 
+                     "\n\n### 📦 Archived Tickets\n\n| # | Status | Pri | Title | Group | Project | Created | Path |\n|---|---|---|---|---|---|---|---|\n" + 
+                     (archivedRows.join("\n") || "| - | - | - | No archived tickets | - | - | - | - |");
 
   return template
     .replaceAll("{{SOURCE_INDEX}}", `${TICKET_DIR_NAME}/${TICKET_INDEX_FILENAME}`)
@@ -99,7 +100,8 @@ function renderLine(e, i, ticketDir, cwd) {
   const relPath = toPosixPath(relative(ticketDir, join(cwd, e.path)));
   const statusIcon = e.status === "active" ? "🔥 " : (e.status === "archived" ? "📦 " : "[ ] ");
   const safeTitle = String(e.title || "").replace(/\|/g, '|').replace(/(\n|\\n)+/g, ' ');
-  return `| ${i + 1} | ${statusIcon}${e.status} | ${safeTitle} | ${e.group} | ${e.project} | ${e.createdAt.split('T')[0]} | [open](${relPath}) |`;
+  const prio = e.priority || "P2";
+  return `| ${i + 1} | ${statusIcon}${e.status} | ${prio} | ${safeTitle} | ${e.group} | ${e.project} | ${e.createdAt.split('T')[0]} | [open](${relPath}) |`;
 }
 
 export function writeTicketListFile(cwd, entries, opts = {}) {
@@ -471,9 +473,61 @@ export function syncActiveTicketPointer(cwd) {
 
 
 /**
- * Deterministic or Hash-based ID to prevent collisions in multi-device sync
+ * Returns the machine hostname slug (lowercase, alphanumeric + hyphen only).
  */
-export function generateTicketId(title) {
+export function getHostnameSlug() {
+  try {
+    const slug = osHostname().toLowerCase().replace(/[^a-z0-9\-]/g, '-').replace(/-+/g, '-').replace(/^-|-$/g, '');
+    return slug.slice(0, 8).replace(/-$/, '') || 'local';
+  } catch {
+    return 'local';
+  }
+}
+
+/**
+ * Computes next sequential 3-digit ticket number by scanning all entries
+ * in the current INDEX.json for IDs matching `ticket_NNN_*`.
+ * Safe to call cross-device: each hostname produces an independent sequence,
+ * but the number is always calculated from the current local INDEX state.
+ *
+ * @param {object[]} existingEntries - entries array from INDEX.json
+ * @returns {{ num: number, hostname: string }}
+ */
+export function computeNextTicketNumber(existingEntries) {
+  const hostname = getHostnameSlug();
+  // Match both old format `ticket_NNN_hostname_*` and new `ticket_NNN_*`
+  const numRe = /^ticket_(\d{3,})_/;
+  let max = 0;
+  for (const e of (existingEntries || [])) {
+    const m = String(e.id || '').match(numRe);
+    if (m) {
+      const n = parseInt(m[1], 10);
+      if (n > max) max = n;
+    }
+  }
+  return { num: max + 1, hostname };
+}
+
+/**
+ * Sequential hostname-aware ticket ID.
+ * Format: ticket_NNN_<hostname>_<topic-slug>
+ * NNN starts at 001 and increments per local INDEX.json state.
+ *
+ * @param {string} topicSlug
+ * @param {object[]} existingEntries - entries array from INDEX.json (may be empty)
+ */
+export function generateTicketId(topicSlug, existingEntries) {
+  const { num, hostname } = computeNextTicketNumber(existingEntries);
+  const numStr = String(num).padStart(3, '0');
+  const slug = toSlug(topicSlug || 'ticket').slice(0, 32);
+  return `ticket_${numStr}_${hostname}_${slug}`;
+}
+
+/**
+ * @deprecated Use generateTicketId(topicSlug, existingEntries)
+ * Kept for backwards compatibility.
+ */
+export function generateTicketIdLegacy(title) {
   const seed = `${title}-${Date.now()}-${Math.random()}`;
   try {
     return "ticket_" + createHash("md5").update(seed).digest("hex").slice(0, 12);

package/scripts/cli-utils.mjs

@@ -1,6 +1,6 @@
 import { existsSync, readFileSync, writeFileSync } from "fs";
 import { basename, dirname, join, relative } from "path";
-import YAML from "../node_modules/yaml/dist/index.js";
+import YAML from "yaml";
 
 export const INIT_CONFIG_FILENAME = ".deuk-agent-rule.config.json";
 export const INIT_CONFIG_VERSION = 1;
@@ -143,3 +143,24 @@ export function stringifyFrontMatter(meta, content) {
   const yamlStr = YAML.stringify(meta).trim();
   return `---\n${yamlStr}\n---\n\n${content.trim()}\n`;
 }
+
+export async function checkUpdateNotifier() {
+  try {
+    const { fileURLToPath } = await import("url");
+    const pkgPath = join(dirname(fileURLToPath(import.meta.url)), "..", "package.json");
+    const pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
+    const currentVersion = pkg.version;
+    const res = await fetch("https://registry.npmjs.org/deuk-agent-rule/latest", {
+      signal: AbortSignal.timeout(800)
+    });
+    if (res.ok) {
+      const data = await res.json();
+      if (data.version && data.version !== currentVersion) {
+        console.warn(`\n\x1b[33m💡 Update available! ${currentVersion} → ${data.version}\x1b[0m`);
+        console.warn(`\x1b[36mRun 'npm install -g deuk-agent-rule' to update.\x1b[0m\n`);
+      }
+    }
+  } catch(e) {
+    // Ignore timeout or network errors silently
+  }
+}

package/scripts/cli.mjs

@@ -6,9 +6,11 @@ import { parseArgs, parseTicketArgs } from "./cli-args.mjs";
 import { runInit, runMerge } from "./cli-init-commands.mjs";
 import { runTicketCreate, runTicketList, runTicketUse, runTicketClose, runTicketArchive, runTicketReports, runTicketMeta, runTicketConnect } from "./cli-ticket-commands.mjs";
 import { performUpgradeMigration } from "./cli-ticket-logic.mjs";
-import { loadInitConfig, writeInitConfig } from "./cli-utils.mjs";
+import { loadInitConfig, writeInitConfig, checkUpdateNotifier } from "./cli-utils.mjs";
 import { runInteractive } from "./cli-prompts.mjs";
 
+const updatePromise = checkUpdateNotifier();
+
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const pkgRoot = join(__dirname, "..");
 const bundleRoot = join(pkgRoot, "bundle");
@@ -118,7 +120,10 @@ Ticket Options:
 `);
 }
 
-main().catch(err => {
+main().then(async () => {
+  await updatePromise;
+}).catch(async err => {
+  await updatePromise;
   console.error(err.message || err);
   process.exit(1);
 });

package/scripts/sync-bundle.mjs

@@ -44,6 +44,18 @@ for (const name of readdirSync(publishRulesDir)) {
   copyFileSync(join(publishRulesDir, name), join(rulesDest, name));
 }
 
+const templatesSrc = join(publishDir, "templates");
+const templatesDest = join(pkgRoot, "bundle", "templates");
+if (existsSync(templatesSrc)) {
+  if (existsSync(templatesDest)) {
+    rmSync(templatesDest, { recursive: true });
+  }
+  mkdirSync(templatesDest, { recursive: true });
+  for (const name of readdirSync(templatesSrc)) {
+    copyFileSync(join(templatesSrc, name), join(templatesDest, name));
+  }
+}
+
 const agentsBody = readFileSync(agentsSrc, "utf8");
 writeFileSync(agentsDest, agentsBody, "utf8");
 copyFileSync(cursorrulesSrc, cursorrulesDest);

package/scripts/sync-oss.mjs

@@ -49,6 +49,9 @@ cpSync(join(pkgRoot, "README.ko.md"), join(ossRoot, "README.ko.md"), { force: tr
 if (existsSync(join(pkgRoot, "CHANGELOG.md"))) {
   cpSync(join(pkgRoot, "CHANGELOG.md"), join(ossRoot, "CHANGELOG.md"), { force: true });
 }
+if (existsSync(join(pkgRoot, "CHANGELOG.ko.md"))) {
+  cpSync(join(pkgRoot, "CHANGELOG.ko.md"), join(ossRoot, "CHANGELOG.ko.md"), { force: true });
+}
 if (existsSync(join(pkgRoot, "package-lock.json"))) {
   cpSync(join(pkgRoot, "package-lock.json"), join(ossRoot, "package-lock.json"), { force: true });
 }
@@ -91,6 +94,7 @@ const outPkg = {
     "README.md",
     "README.ko.md",
     "CHANGELOG.md",
+    "CHANGELOG.ko.md",
   ],
 };
 delete outPkg.private;

package/scripts/changelog-polish.mjs

@@ -1,22 +0,0 @@
-/**
- * Post-process CHANGELOG.md after commit-and-tag-version: drop internal "sync" wording
- * from user-facing bullets (OSS mirror / sync-oss / release automation noise).
- */
-import { readFileSync, writeFileSync } from "fs";
-import { dirname, join } from "path";
-import { fileURLToPath } from "url";
-
-const root = join(dirname(fileURLToPath(import.meta.url)), "..");
-const file = join(root, "CHANGELOG.md");
-let s = readFileSync(file, "utf8");
-
-s = s.replace(/,\s*and OSS sync\b/g, "");
-s = s.replace(/\s+and OSS sync\b/g, "");
-s = s.replace(
-  /- `sync-oss` copies (`package-lock\.json`) for reproducible installs\./g,
-  "- Release packaging includes $1 for reproducible installs.",
-);
-s = s.replace(/\bCLI and publish AGENTS sync\b/gi, "CLI and publish AGENTS updates");
-s = s.replace(/\bpublish AGENTS sync\b/gi, "publish AGENTS alignment");
-
-writeFileSync(file, s, "utf8");