deuk-agent-rule 3.3.3 → 4.0.20

package/README.md

@@ -1,174 +1,16 @@
-<div align="center">
-  <br />
-  <img src="docs/assets/architecture-v3.png" width="800" alt="DeukAgentRules Architecture" />
-  <br />
-  <h1>DeukAgentRules v3.3.3</h1>
-  <p>
-    <a href="https://www.npmjs.com/package/deuk-agent-rule"><img src="https://img.shields.io/npm/v/deuk-agent-rule.svg" alt="npm version" /></a>
-    <a href="https://www.npmjs.com/package/deuk-agent-rule"><img src="https://img.shields.io/npm/dt/deuk-agent-rule.svg" alt="npm downloads" /></a>
-  </p>
-  <p><b>AI coding agent guardrails for every repo</b></p>
-  <p><i>Ticketed scope, verification, and memory for Codex, Copilot, Claude Code, Cursor, and more</i></p>
-  <p>Part of the <a href="https://deukpack.app">Deuk Family</a> ecosystem.</p>
-  <p><a href="README.ko.md">한국어</a> · <a href="README.md">English</a></p>
-</div>
+# Deuk Agent Flow
 
----
-
-**DeukAgentRules** gives AI coding agents a shared way to work through tickets, scope contracts, verification, and durable project memory.
-
-It is more than a prompt pack. It is a repository-level workflow layer that standardizes collaboration through the **Hub-Spoke Architecture** and a **Ticket-Driven Execution Model** while keeping `AGENTS.md`, Copilot instructions, Cursor rules, Claude skills, and related agent surfaces aligned.
-
-Ticket management lives under `.deuk-agent/`, with active work tracked in `.deuk-agent/tickets/` and related docs, plans, and archive data kept alongside it.
-
-> **Current readiness:**
-> v3.3.3 is deployment-ready for agent-driven repositories. It is currently most reliable in **OpenAI Codex** and **GitHub Copilot** workflows. Cursor, Windsurf, Claude Code, and MCP remain supported through pointer-style integration, but they should be validated per workspace before rollout. MCP server registration is separate from `init`.
-
-> **Architecture foundation:**
-> We have officially deprecated monolithic `.cursorrules`. v3.0 introduces the **Hub-Spoke model** where `AGENTS.md` is the single source of truth, and IDE-specific rules act as thin entry-point pointers.
-
-### 🗺️ Main Features & Architecture
-
-DeukAgentRules brings four core capabilities to day-to-day AI engineering:
-
-1. **Zero-Copy Hub-Spoke Architecture**
-   - **Hub**: `AGENTS.md` acts as the global single source of truth.
-   - **Spoke**: IDE-specific rules (like `.cursorrules`) or `PROJECT_RULE.md` act as thin pointers.
-   - **Benefit**: Eliminates rule duplication, preventing conflicting instructions and context hallucination across different IDEs (Cursor, Copilot, Windsurf).
-
-2. **Ticket-Driven Workflow (TDW)**
-   - Guides work through a clear lifecycle: Plan → Execute → Verify → Archive.
-   - Keeps changes connected to an active ticket in `.deuk-agent/tickets/`, so scope and progress stay visible.
-
-3. **Platform Co-existence & Mode-Aware Workflow Gate**
-   - Uses strong Agent Permission Contracts (APC) through a **Mode-Aware** workflow.
-   - In **Plan Mode**, agents focus on analysis and planning artifacts before moving into approved execution.
-   - Integrates with MCP Soft Gates to keep code changes aligned with the current ticket context.
-
-4. **Zero-Token Knowledge Distillation**
-   - When a ticket is archived, it is distilled into a zero-token summary and moved to `reports/`.
-   - These reports are vectorized into DeukAgentContext, building a permanent Engineering Memory Engine without cluttering the agent's active context window.
-
-### Why Not Just Instructions?
-
-The agent tooling space already has useful building blocks: `AGENTS.md`, GitHub Copilot instructions, Cursor rules, Claude skills, agent launchers, and general LLM guardrail frameworks. DeukAgentRules is positioned one layer above plain instruction sync: it turns those surfaces into a ticketed repository workflow.
-
-| Similar approach | What it helps with | DeukAgentRules adds |
-|---|---|---|
-| `AGENTS.md` open format | A predictable instruction file for coding agents | Ticket lifecycle, phase gates, verification, and archiveable memory |
-| Copilot instructions / Cursor rules / Claude memory | Tool-specific guidance | One repo-owned workflow shared across agent clients |
-| Claude or Copilot custom agents and skills | Reusable task playbooks | Skills route into scoped, ticketed execution instead of replacing the workflow |
-| Agent launchers and harnesses | Running many coding agents from one place | Lifecycle control inside the repository, independent of the chosen agent |
-| General LLM/MCP guardrails | Runtime policy checks for AI systems | Developer-facing work orders, scope contracts, Git-visible history, and closeout evidence |
-
-Use DeukAgentRules when you want AI coding work to stay coordinated, reviewable, and easy to carry forward across sessions and teammates.
-
-### Better Together With Karpathy-Style Skills
-
-Karpathy-style skills are great at improving how an agent behaves inside a task. DeukAgentRules is great at making that task ticketed, scoped, verified, and remembered at the repository level.
-
-Used together, skills can improve the quality of the move, while DeukAgentRules keeps the move connected to team workflow. The result is a better session and a better project record: behavior playbooks on the front end, ticket lifecycle and DeukAgentContext memory on the back end.
-
-### What's Next
-
-The next step is to make this workflow even easier to see and adopt: clearer first-run checks, compact CLI/RAG reminders for agents, stronger README/npm positioning, and companion surfaces that show active ticket, phase, open-ticket count, and DeukAgentContext memory status without asking teams to switch coding agents.
-
-### 📚 Detailed Documentation
-| Doc | Purpose |
-|---|---|
-| [docs/architecture.md](docs/architecture.md) | High-level system structure and visual infographics |
-| [docs/how-it-works.md](docs/how-it-works.md) | Detailed CLI mechanics, initialization lifecycle, and file roles |
-| [docs/principles.md](docs/principles.md) | Design philosophy: Hub-Spoke, Zero-Legacy, and Source Sovereignty |
-| **Korean Docs** | [README.ko.md](README.ko.md) · [docs/architecture.ko.md](docs/architecture.ko.md) |
-
----
-
-## 🛠️ Installation & Setup
-
-### 1. Global Installation (Standard User)
-To prevent `npx` cache issues and "Local Traps", a global installation is strictly required.
-
-```bash
-npm install -g deuk-agent-rule
-deuk-agent-rule init
-```
-
-### 2. Local Source Development (Maintainer/Power User)
-v3.0 introduces a **Global CLI Proxy**. If you are developing inside the `DeukAgentRules` workspace, the global command will automatically delegate execution to your local source.
+`deuk-agent-rule` is the legacy compatibility npm package.
+It forwards to the primary `deuk-agent-flow` CLI implementation.
 
 ```bash
-cd ~/workspace/DeukAgentRules
-sudo npm link
-deuk-agent-rule init  # Routes to local scripts/cli.mjs automatically
+npm install -g deuk-agent-flow
+deuk-agent-flow init
 ```
 
-If you primarily work in Codex or Copilot, this is the recommended day-to-day setup. Those clients currently have the smoothest behavior with the hub-spoke and ticket-driven workflow.
-
----
-
-## 🎯 The Protocol Workflow
-
-The workflow is governed by a **Ticket-Driven Execution Contract**.
-
-1. **Scaffolding**: `init` deploys `.deuk-agent/templates/` and `AGENTS.md` (or local pointers like `PROJECT_RULE.md`).
-2. **Ticketing (Plan Phase)**: `ticket create --topic feature-x` generates a bounded work order in `.deuk-agent/tickets/`. During this phase, agents operate in **Plan Mode** and are restricted from mutating files.
-3. **Execution (Execute Phase)**: Once authorized, the AI agent reads the ticket, locks onto the **Target Submodule**, and executes code changes. MCP Soft Gates ensure that unauthorized modifications are blocked.
-4. **Verification**: The agent performs a side-effect audit and convention (e.g., DC-DUP) check before closure.
-5. **Archiving (Archive Phase)**: Completed tickets undergo Zero-Token Knowledge Distillation and move to `reports/` to build the **Engineering Memory Engine** via DeukAgentContext.
-
----
-
-## ⚙️ CLI Reference
-
-Delegate these to your AI agent via natural language prompts!
-
-| Command | Description / Example Prompt |
-|--------|------|
-| `deuk-agent-rule init` | Synchronizes the rule Hub and Spoke pointers. <br>💬 *"Initialize project rules"* |
-| `deuk-agent-rule ticket create` | Issues a new execution contract. Use `--summary` plus `--plan-body` for a one-pass Phase 1 ticket. <br>💬 *"Create ticket: refactor-ui with filled APC"* |
-| `deuk-agent-rule ticket list` | Displays active work orders. <br>💬 *"Show active tickets"* |
-| `deuk-agent-rule ticket archive` | Securely stores completed work. <br>💬 *"Archive ticket 068"* |
-| `deuk-agent-rule skill list` | Shows first-party thin skills such as `safe-refactor`, `generated-file-guard`, and `context-recall`. |
-| `deuk-agent-rule skill add --skill safe-refactor` | Installs a skill into the local registry without changing the TDW/APC authority model. |
-| `deuk-agent-rule skill expose --platform claude` | Exposes installed skills as platform-specific thin wrappers. Supported MVP platforms: `claude`, `cursor`. |
-| `deuk-agent-rule skill lint` | Audits skill files for duplicate workflow contracts and unsafe generated-file guidance. |
-
-### Ticket File Git Hygiene
-
-- Treat `.deuk-agent/tickets/**/*.md` and `INDEX*.json` as CLI-managed lifecycle artifacts.
-- Do not commit a ticket body without the related index updates. The next session can restore the wrong active/archive state.
-- After `ticket create` fails, do not create or repair ticket files manually.
-- Do not flip ticket status by editing frontmatter directly. Use `ticket move`, `ticket close`, or `ticket archive`.
-- `telemetry.jsonl` is usually operational log noise, so it is better left out of normal code commits unless your repo intentionally tracks it.
-- When possible, commit completed work after `ticket archive` so the active/archive transition lands in one history step.
-
-For more day-to-day examples, see [docs/how-it-works.md](docs/how-it-works.md).
-
----
-
-## Related Ideas & Inspiration
-
-DeukAgentRules shares the same concern as guideline-first projects like
-[andrej-karpathy-skills](https://github.com/forrestchang/andrej-karpathy-skills):
-AI coding agents often over-assume, over-engineer, and edit outside the requested scope.
-
-Where prompt-level guideline files improve agent behavior inside one client,
-DeukAgentRules adds a repository-level workflow layer: tickets, phase gates,
-scoped permissions, verification, and archiveable engineering memory.
-
-The first-party skill MVP keeps that boundary explicit: skills are short
-`SKILL.md` playbooks for recurring failure patterns, while `core-rules/AGENTS.md`
-remains the workflow authority. Use `skill add` and `skill expose` to make those
-playbooks visible to Claude or Cursor without copying the full rule contract.
+Compatibility install:
 
 ```bash
-npx deuk-agent-rule init
-npx deuk-agent-rule skill list
-npx deuk-agent-rule skill add --skill safe-refactor
-npx deuk-agent-rule skill expose --platform claude
+npm install -g deuk-agent-rule
+deuk-agent-rule init
 ```
-
----
-
-### 🏷️ Keywords
-`#AI-Orchestration` `#Agentic-Workflow` `#DeukFamily` `#Engineering-Intelligence` `#Zero-Legacy` `#High-Signal-Coding` `#AI-Protocol` `#CursorRules` `#CopilotInstructions` `#ClaudeCode` `#ClaudeMD` `#AgentsMD` `#AgentSkills` `#CodingAgent` `#AI-Guardrails` `#LLM-Control-Plane`

package/bin/deuk-agent-rule.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+require("deuk-agent-flow/bin/deuk-agent-flow.js");

package/package.json

@@ -1,77 +1,36 @@
 {
   "name": "deuk-agent-rule",
-  "version": "3.3.3",
-  "description": "AI coding agent guardrails for every repo: ticketed scope, verification, and shared AGENTS.md workflows.",
+  "version": "4.0.20",
+  "description": "Compatibility wrapper for legacy deuk-agent-rule installs.",
   "keywords": [
     "agents-md",
-    "cursor-rules",
-    "copilot",
-    "gemini",
-    "claude",
-    "windsurf",
-    "jetbrains",
-    "ticket",
+    "agent-flow",
+    "agent-workflow",
     "ai-guardrails",
     "agent-guardrails",
-    "deuk-family",
-    "deukpack-ecosystem"
+    "deuk-family"
   ],
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/joygram/DeukAgentRules.git"
+    "url": "git+https://github.com/joygram/DeukAgentFlow.git"
   },
   "bugs": {
-    "url": "https://github.com/joygram/DeukAgentRules/issues"
+    "url": "https://github.com/joygram/DeukAgentFlow/issues"
   },
-  "homepage": "https://github.com/joygram/DeukAgentRules#readme",
+  "homepage": "https://github.com/joygram/DeukAgentFlow#readme",
   "files": [
-    "LICENSE",
     "bin/**/*",
-    "docs/architecture.md",
-    "docs/architecture.ko.md",
-    "docs/how-it-works.md",
-    "docs/how-it-works.ko.md",
-    "docs/principles.md",
-    "docs/principles.ko.md",
-    "docs/usage-guide.ko.md",
-    "docs/assets/**/*",
-    "templates/**/*",
-    "scripts/cli.mjs",
-    "scripts/cli-args.mjs",
-    "scripts/cli-init-commands.mjs",
-    "scripts/cli-init-logic.mjs",
-    "scripts/cli-prompts.mjs",
-    "scripts/cli-rule-compiler.mjs",
-    "scripts/cli-skill-commands.mjs",
-    "scripts/cli-telemetry-commands.mjs",
-    "scripts/cli-ticket-commands.mjs",
-    "scripts/cli-ticket-index.mjs",
-    "scripts/cli-ticket-migration.mjs",
-    "scripts/cli-ticket-parser.mjs",
-    "scripts/cli-utils.mjs",
-    "scripts/lint-md.mjs",
-    "scripts/lint-rules.mjs",
-    "scripts/merge-logic.mjs",
-    "scripts/plan-parser.mjs",
-    "README.md",
-    "README.ko.md",
-    "CHANGELOG.md",
-    "CHANGELOG.ko.md"
+    "README.md"
   ],
-  "scripts": {
-    "lint:md": "node scripts/lint-md.mjs",
-    "test": "node --test scripts/tests/*.test.mjs"
-  },
-  "engines": {
-    "node": ">=18"
-  },
   "bin": {
     "deuk-agent-rule": "./bin/deuk-agent-rule.js",
     "deukagentrule": "./bin/deuk-agent-rule.js"
   },
+  "engines": {
+    "node": ">=18"
+  },
   "dependencies": {
-    "ejs": "^5.0.2",
-    "yaml": "^2.8.3"
+    "deuk-agent-flow": "4.0.20"
   }
 }

package/CHANGELOG.ko.md

@@ -1,189 +0,0 @@
-# 변경 이력 (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)을 준수합니다.
-
-## [3.3.3] - 2026-05-06
-
-### 수정됨 (Fixed)
-
-- npm과 GitHub 첫 화면에서 영어/한국어 README를 바로 오갈 수 있도록 언어 전환 링크를 복구했습니다.
-- README 문서 표에는 공개 문서 링크만 남기고, 내부 리서치와 성장 전략 문서는 npm/OSS 공개 표면에서 제외했습니다.
-
-## [3.3.2] - 2026-05-06
-
-### 포지셔닝 (Positioning)
-
-- npm/GitHub에서 보이는 정체성을 **모든 레포를 위한 AI 코딩 에이전트 가드레일**로 재정리했습니다.
-- `AGENTS.md`, Copilot instructions, Cursor rules, Claude skills, 에이전트 실행기, 일반 LLM/MCP 가드레일과 비교해 DeukAgentRules가 더하는 티켓 생명주기, 범위 계약, 검증, 아카이브 가능한 기억을 README에 드러냈습니다.
-- 다음 개선 방향으로 첫 실행 점검, CLI/RAG 재각인 신호, active ticket/phase/open ticket count/DeukAgentContext memory status를 보여주는 companion 표면을 명시했습니다.
-
-## [3.3.0] - 2026-05-02
-
-### 추가됨 (Added)
-
-- **docs:** VS Code, Open VSX, GitHub, skill 기반 발견 루프를 포함한 AI 코딩 에이전트 가드레일 포지셔닝, 비전, 오가닉 유입 리서치 문서를 추가했습니다.
-- **docs:** Karpathy식 skill, DeukAgentRules, DeukAgentContext 심층 비교 문서를 추가했습니다. Skill은 행동 playbook, DeukAgentRules는 workflow/permission control, DeukAgentContext는 ticketed engineering memory로 포지셔닝했습니다.
-- **seo:** `andrej-karpathy-skills` 관련 아이디어 링크와 Claude Code, AGENTS.md, Cursor rules, agent skills, AI guardrails 검색 유입 키워드를 보강했습니다.
-
-### 변경됨 (Changed)
-
-- **ticket:** 열린 티켓이 설정된 한도를 넘을 때 자동 정리 대신 사용자가 목록을 보고 결정할 수 있는 cleanup flow를 강화했습니다.
-- **ticket:** 닫힌 티켓은 자동 아카이브할 수 있게 하고, 아카이브된 티켓은 년월/일 단위로 정리되도록 했습니다.
-- **docs:** README 문서 목록과 GitHub topic 가이드를 agent guardrail, instruction hub, skill registry, project memory 포지셔닝에 맞게 갱신했습니다.
-
-### 수정됨 (Fixed)
-
-- **ticket:** 새 작업 진입 전에 정리 결정을 노출하여 열린 티켓 수가 의도한 운영 한도를 조용히 넘는 문제를 방지했습니다.
-
-## [3.2.0] - 2026-04-29
-
-### 추가됨 (Added)
-- **agent:** 플랫폼 공존(Platform Coexistence) 및 모드 인지형(Mode-aware) 워크플로우 구현. (Plan Mode에서 TDW Phase 자동 매핑, `platform-coexistence.md` 규칙 추가, 수정 제어 및 `PROJECT_RULE.md` 포인터 연동 등)
-
-### 변경됨 (Changed)
-- **agents:** Co-existence Protocol 및 Workflow Gate 기능 도입 (T-120).
-- v3.1.0 아키텍처 원칙 및 사용법 문서 개선.
-
-## [3.1.0] - 2026-04-28
-
-### 추가됨 (Added)
-- **arch:** 제로카피(Zero-Copy) 포인터 아키텍처 도입 (`PROJECT_RULE.md` 연동) 및 구조 간소화
-- **cli:** 엄격한 Phase 기반 티켓 워크플로우 및 APC(Agent Permission Contract) 검증 기능 추가
-- **cli:** `--plan-body` 옵션을 통한 채워진 Phase 1 티켓 본문 입력 기능 추가
-- **ticket:** 티켓 아카이브 시 불필요한 토큰 낭비를 막는 Zero-Token 지식 증류(Knowledge Distillation) 구현
-- **telemetry:** 로컬 환경에 최적화된 Telemetry CLI 추가
-- **rules:** `PROJECT_RULE.md` 템플릿 추가 (AI 에이전트 폴백 가이드 포함) 및 이중 언어(한/영) 지원
-
-### 수정됨 (Fixed)
-- **rules:** `PROJECT_RULE.md` 내 중복된 코어 룰 링크 제거 및 Frontmatter 렌더링 복구
-- **telemetry:** 모델 및 설정에서 클라이언트 도구를 자동으로 감지하도록 수정
-- **agent:** 티켓 탐색 중 에이전트 무한 루프 문제 해결
-
-### 변경됨 (Changed)
-- **agent:** TDD 용어를 TDW (Ticket-Driven Workflow)로 변경 및 전역 `AGENTS.md`에서 낡은 규칙 제거
-- **cli:** 상태 기반(State-driven) 경로 탐색 로직으로 구조 개편 및 상세한 사용 가이드 추가
-
-## [3.0.0] - 2026-04-25
-
-### 🚀 대규모 업데이트: Hub-Spoke 아키텍처
-- **Canonical Rule Hub**: 모든 AI 에이전트의 단일 진실 공급원(SSOT)으로 `AGENTS.md` 도입.
-- **Thin Spoke Pointers**: IDE별 룰(Cursor, Copilot 등)을 중앙 Hub를 가리키는 가벼운 포인터로 변경하여 중복 및 동기화 오류 제거.
-- **Global CLI Proxy**: 로컬 워크스페이스 소스를 자동 감지하여 실행을 위임하는 프록시 도입으로 지연 없는(Zero-latency) 개발 환경 구축.
-
-### 🧹 제로 레거시 & 환경 정리
-- **Auto-Purge**: `init` 실행 시 더 이상 사용되지 않는 레거시 `.cursorrules` 파일을 무조건 삭제.
-- **Smart Backups**: 사용자 정의 규칙을 감지하여 삭제 대신 `.bak` 파일로 백업하는 로직 추가.
-- **Submodule Scrubbing**: 비어 있는 서브모듈 디렉터리 스텁 및 `.gitmodules` 자동 정리 기능.
-
-### 🏗️ 리브랜딩 & 인프라스텍
-- **Identity Overhaul**: "Zero-Latency, High-Signal AI Orchestration Protocol"로 리브랜딩.
-- **Documentation v3**: 고품질 3D 인포그래픽 및 구조, 원리, 작동 방식 등 개념 가이드 전면 개편.
-- **Domain Agnostic**: 도메인별 하드코딩을 제거하고 모든 기술 스택을 지원하도록 `bundle/AGENTS.md` 일반화.
-
-### ⚙️ CLI 개선 사항
-- **Proxy Routing**: `bin/deuk-agent-rule.js`가 디렉터리를 탐색하여 로컬 스크립트를 찾아 실행하도록 수정.
-- **Synchronized IO**: CLI의 안정성을 높이기 위해 핵심 로직을 동기적 파일 시스템 연산으로 리팩터링.
-## [2.4.6] - 2026-04-19
-
-### 수정됨 (Fixed)
-
-- **cli:** 로컬 버전이 registry 버전 이상일 경우 업데이트 알림을 표시하지 않도록 수정 (로컬 개발 symlink 환경에서의 역방향 스팸 알림 해소)
-- **ticket:** `NNN` 정규식을 최대 4자리로 제한하여 유닉스 타임스탬프가 티켓 순번으로 잘못 파싱되는 버그 수정 — 올바른 `NNN-topic-hostname` 포맷 생성 복원
-
-## [2.4.4] - 2026-04-19
-
-### 변경됨 (Changed)
-
-- **rules:** 서브모듈 전용 규칙(DeukPack, C++, Unity)을 해당 워크스페이스의 `MODULE_RULE.md`로 이동하여 `AGENTS.md`를 일반화된 규약 중심으로 개편
-- **templates:** `publish/` 소스에 맞춰 `bundle/` 내의 레거시 템플릿 정리
-
-## [2.4.3] - 2026-04-18
-
-### 변경됨 (Changed)
-- **ticket:** 티켓 ID 포맷을 `NNN-topic-hostname` (예: `001-add-feature-joy-nucb`)으로 변경. 레거시 `ticket_NNN_hostname_topic` 형식 대체
-- **ticket:** INDEX.json 파싱 시 기존 포맷과 신규 포맷 모두 역호환 지원
-
-## [2.4.2] - 2026-04-18
-
-### 수정됨 (Fixed)
-- **ticket:** 파일명(File name)과 본문 내 티켓 ID 생성 로직 간의 불일치(Discrepancy) 해결 (단일 출처로 통합)
-
-## [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

@@ -1,189 +0,0 @@
-# Changelog
-
-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).
-
-## [3.3.3] - 2026-05-06
-
-### Fixed
-
-- Restored the README language switch links so npm and GitHub readers can move between English and Korean documentation from the first screen.
-- Published only public documentation links in the README tables while keeping internal research and growth notes out of the npm/OSS surface.
-
-## [3.3.2] - 2026-05-06
-
-### Positioning
-
-- Reframed the npm/GitHub identity around **AI coding agent guardrails for every repo**, with ticketed scope, verification, and shared `AGENTS.md` workflows visible in package metadata.
-- Added README comparison against `AGENTS.md`, Copilot instructions, Cursor rules, Claude skills, agent harnesses, and general guardrail frameworks to show where DeukAgentRules sits in the ecosystem.
-- Added a short "What's Next" section to set expectations for clearer first-run checks, compact CLI/RAG reminders, and visible companion surfaces for active ticket, phase, open-ticket count, and DeukAgentContext memory status.
-
-
-### Added
-
--  AGENTS.md v12 + summary mandatory guard + PROJECT_RULE optimization
-- **cli:** add 'ticket next' command for instant task discovery (T[#295](https://github.com/joygram/DeukAgentRules/issues/295))
-- **cli:** enforce required frontmatter keys in lint:md (T-118)
--  harden ticket paths and add DeukPack RAG schemas
-- **migration:** add summary/planLink/caution auto-enrichment for legacy tickets
--  Phase 0 search limiter - max 2 MCP calls, skip when context sufficient
--  replace legacy fill-in-the-blank rule check with Version Gating and Task Relevance check
-- **rules:** enforce hard guardrails, add hotfix protocol and urgency response
-- **rules:** harden document boundary workflow
-- **spoke:** add fill-in completion template for rule enforcement
-- **T-114:** 1-CALL ticket discovery rule + CLI max call limits
-- **T-115:** HARD BLOCK on write tools without active ticket
-- **T-116:** auto-close stale tickets on ticket create + Phase 4 NEVER skip
-- **T-116:** smart close based on checklist + phase state
-- **ticket:** enforce filled create flow and phase1 status guard
-- **ticket:** enforce open ticket cleanup flow
-- **ticket:** partition archive index by month
-
-
-### Fixed
-
--  add Refactor Safety Guard and Halt-and-Replan hard rules
--  agent degradation remediation — planLink, inline TDW, token optimization
--  align ticket APC template with phase gate
-- **docs:** correct frontmatter keys in AGENTS.md (remove fm_ prefix)
-- **init:** deploy Antigravity spoke to project root AGENTS.md
--  register legitimate DR-04/DR-05 exceptions and update PROJECT_RULE.md
--  remove duplicate phase key in ticket template and repair broken tickets
-- **rules:** announce active ticket at start
-- **rules:** keep planlink free of progress checkboxes
-- **rules:** make planlink capture agent analysis
-- **rules:** separate ticket and plan content
-- **spoke:** GLOBAL_AGENTS.md link text to actual filename AGENTS.md
--  SSOT — init removes .deuk-agent/templates/ unconditionally (bundle is single source of truth)
-- **T-116:** parallel-safe auto-close - only close activeTicketId, warn others
-- **T-116:** replace auto-close with activeTicketId switch + warning
-- **ticket:** honor project and submodule filters
-- **ticket:** Sync close/archive status to frontmatter to prevent rebuild reversion
-
-
-### Changed
-
--  add Dependency Integrity Guard (HARD RULE) to AGENTS.md
--  add lite accessibility vision plan
--  add skill positioning release notes
--  add version frontmatter to AGENTS.md for rule loading optimization
--  align bad examples with plan/archive convention
--  archive bmt coordination ticket 142
--  archive bmt frontmatter cleanup ticket 144
--  archive bmt go ticket 140
--  archive bmt java ticket 139
--  archive bmt matrix ticket 133
--  archive bmt rust ticket 141
--  bump AGENTS.md to v15 and strengthen dependency guards
--  clarify ticket creation flow
--  document rationale for docs/plan and fix section numbering
--  Enforce strict rules for Scope Creep Handling
--  enhance main features and workflow intro for v3.2.0
--  optimize AGENTS.md — merge Dependency Integrity into Refactor Guard, compress Scope Creep
--  position agent guardrail growth loop
-- **rules:** clarify phase one execution semantics
-- **rules:** mandate enrich_frontmatter for all plan/report files (T-118)
-- **spoke:** hard rule single directive
--  update legacy path guidance to plan/archive layout
-
-## [3.3.0] - 2026-05-02
-
-### Added
-
-- **docs:** add AI coding agent guardrail positioning, vision, and organic growth research for VS Code, Open VSX, GitHub, and skill-driven discovery.
-- **docs:** add a deep comparison of Karpathy-style skills, DeukAgentRules, and DeukAgentContext, positioning skills as behavior playbooks, DeukAgentRules as workflow/permission control, and DeukAgentContext as ticketed engineering memory.
-- **seo:** add related-project positioning for `andrej-karpathy-skills` plus discovery keywords for Claude Code, AGENTS.md, Cursor rules, agent skills, and AI guardrails.
-
-### Changed
-
-- **ticket:** enforce a decision-first cleanup flow when open tickets exceed the configured limit, while allowing closed tickets to be archived automatically.
-- **ticket:** organize archived tickets by year-month and day to reduce active ticket repository clutter.
-- **docs:** update README document indexes and GitHub topic guidance to emphasize the agent guardrail, instruction hub, skill registry, and project memory positioning.
-
-### Fixed
-
-- **ticket:** prevent open ticket growth from silently exceeding the intended operating limit by surfacing cleanup decisions before new work proceeds.
-
-## [3.2.0] - 2026-04-28
-
-
-### Added
-
-- **agent:** implement platform coexistence and mode-aware workflow
-
-
-### Changed
-
-- **agents:** add Co-existence Protocol and Workflow Gate (T-120)
--  update usage, architecture, and principles for v3.1.0
-
-## [3.1.0] - 2026-04-28
-
-
-### Added
-
--  add ArchitectureGuard.test.mjs and create technical debt ticket T-103
--  add first-class copilot and codex support
-- **arch:** implement APC v3 and simplify repository structure
-- **cli:** restrict --skip-phase0 based on MCP server status and update rules
--  consolidate rule cleanup logic and enforce thin pointers for entry points
--  enforce unidirectional AGENTS.md single source of truth
--  enhance CLI reporting and add practical usage guide
--  implement strict phase-driven ticket workflow with APC validation
--  implement Zero-Copy architecture with absolute path pointing and frontmatter-based PROJECT_RULE.md
--  implement zero-token knowledge distillation on ticket archive and cleanup dead code
-- **rules:** add AI Agent fallback guide to PROJECT_RULE.md template
-- **rules:** normalize canonical rules and decouple DeukPack rules
-- **telemetry:** add local-first telemetry CLI and update AGENTS.md
-- **ticket:** implement --plan-body for filled Phase 1 ticket body input and update project rules
-
-
-### Fixed
-
--  auto-detect client tool from model and config in telemetry
--  resolve agent loop on ticket navigation + archive 37 dead tickets
-- **rules:** bilingual ko/en PROJECT_RULE.md template
-- **rules:** remove redundant core rules link from PROJECT_RULE.md
-- **rules:** restore frontmatter in PROJECT_RULE.md
-- **rules:** restore mandatory ticket workflow and anti-shoveling rules
-- **rules:** sync restored strict workflow AGENTS.md and unified templates
-
-
-### Changed
-
--  add markdown lint policy and workflow docs
-- **agent:** rename TDD to TDW, archive ticket 101, and remove DOMAIN_RULES
--  AGENTS.md full cleanup - eliminate redundancy, unify English, remove dead rules
--  finalize ticket 066 rule normalization
--  modernize CLI architecture, implement state-driven path resolution, and comprehensive audit cleanup
-- **rules:** decouple DeukPack rules and fix merge injection logic
--  update principles and cli compiler to DeukAgentContext
-
-## [3.0.0] - 2026-04-25
-
-### 🚀 Major Breakthrough: Hub-Spoke Architecture
-- **Canonical Rule Hub**: Introduced `AGENTS.md` as the single source of truth for all AI agents.
-- **Thin Spoke Pointers**: IDE-specific rules (Cursor, Copilot, etc.) are now lightweight pointers to the central Hub, eliminating duplication and sync errors.
-- **Global CLI Proxy**: Implemented a smart entry point that automatically detects and routes execution to local workspace sources, ensuring zero-latency development.
-
-### 🧹 Zero-Legacy & Cleanliness
-- **Auto-Purge**: `init` now unconditionally deletes deprecated `.cursorrules` files.
-- **Smart Backups**: Added logic to detect custom user rules and rename files to `.bak` instead of deletion.
-- **Submodule Scrubbing**: Automatically cleans empty submodule directory stubs and scrubs `.gitmodules`.
-
-### 🏗️ Branding & Infrastructure
-- **Identity Overhaul**: Rebranded as a "Zero-Latency, High-Signal AI Orchestration Protocol".
-- **Documentation v3**: New high-end 3D visual infographics and overhauled conceptual guides (Architecture, Principles, How-it-works).
-- **Domain Agnostic**: Generalized `bundle/AGENTS.md` to support any technology stack, removing domain-specific hardcoding.
-
-### ⚙️ CLI Enhancements
-- **Proxy Routing**: `bin/deuk-agent-rule.js` performs directory traversal to find local scripts.
-- **Synchronized IO**: Refactored core logic to use synchronous FS operations for rock-solid CLI stability.
-
----
-
-## [2.4.0] - 2026-04-18
-- add Codex CLI support (.codexrules) and apply globally
-- implement ticket chaining (--chain) for automated ticket linkage
-- improve submodule isolation logic