deuk-agent-rule 2.5.14 → 3.3.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (52) hide show
  1. package/CHANGELOG.ko.md +81 -0
  2. package/CHANGELOG.md +144 -322
  3. package/README.ko.md +131 -154
  4. package/README.md +118 -153
  5. package/docs/architecture.ko.md +34 -0
  6. package/docs/architecture.md +33 -0
  7. package/docs/assets/architecture-v3.png +0 -0
  8. package/docs/how-it-works.ko.md +52 -0
  9. package/docs/how-it-works.md +71 -0
  10. package/docs/principles.ko.md +68 -0
  11. package/docs/principles.md +68 -0
  12. package/docs/usage-guide.ko.md +139 -0
  13. package/package.json +37 -7
  14. package/scripts/cli-args.mjs +87 -3
  15. package/scripts/cli-init-commands.mjs +1382 -223
  16. package/scripts/cli-init-logic.mjs +28 -16
  17. package/scripts/cli-prompts.mjs +13 -4
  18. package/scripts/cli-rule-compiler.mjs +44 -34
  19. package/scripts/cli-skill-commands.mjs +172 -0
  20. package/scripts/cli-telemetry-commands.mjs +429 -0
  21. package/scripts/cli-ticket-commands.mjs +1934 -161
  22. package/scripts/cli-ticket-index.mjs +298 -0
  23. package/scripts/cli-ticket-migration.mjs +320 -0
  24. package/scripts/cli-ticket-parser.mjs +207 -0
  25. package/scripts/cli-utils.mjs +381 -59
  26. package/scripts/cli.mjs +99 -19
  27. package/scripts/lint-md.mjs +247 -0
  28. package/scripts/lint-rules.mjs +143 -0
  29. package/scripts/merge-logic.mjs +13 -324
  30. package/scripts/plan-parser.mjs +53 -0
  31. package/templates/MODULE_RULE_TEMPLATE.md +11 -0
  32. package/templates/PROJECT_RULE.md +47 -0
  33. package/templates/TICKET_TEMPLATE.ko.md +21 -0
  34. package/templates/TICKET_TEMPLATE.md +21 -0
  35. package/templates/rules.d/deukcontext-mcp.md +31 -0
  36. package/templates/rules.d/platform-coexistence.md +29 -0
  37. package/templates/skills/context-recall/SKILL.md +25 -0
  38. package/templates/skills/generated-file-guard/SKILL.md +25 -0
  39. package/templates/skills/safe-refactor/SKILL.md +25 -0
  40. package/bundle/.cursorrules +0 -11
  41. package/bundle/AGENTS.md +0 -146
  42. package/bundle/gemini.md +0 -26
  43. package/bundle/rules/delivery-and-parallel-work.mdc +0 -26
  44. package/bundle/rules/git-commit.mdc +0 -24
  45. package/bundle/rules/multi-ai-workflow.mdc +0 -104
  46. package/bundle/rules.d/core-workflow.md +0 -48
  47. package/bundle/rules.d/deukrag-mcp.md +0 -37
  48. package/bundle/templates/MODULE_RULE_TEMPLATE.md +0 -24
  49. package/bundle/templates/TICKET_TEMPLATE.md +0 -58
  50. package/scripts/cli-ticket-logic.mjs +0 -568
  51. package/scripts/sync-bundle.mjs +0 -77
  52. package/scripts/sync-oss.mjs +0 -126
package/CHANGELOG.ko.md CHANGED
@@ -6,6 +6,87 @@
6
6
 
7
7
  형식은 [Keep a Changelog](https://keepachangelog.com/ko/1.1.0/)를 기반으로 하며, 이 프로젝트는 [유의적 버전(Semantic Versioning)](https://semver.org/spec/v2.0.0.html)을 준수합니다.
8
8
 
9
+ ## [3.3.3] - 2026-05-06
10
+
11
+ ### 수정됨 (Fixed)
12
+
13
+ - npm과 GitHub 첫 화면에서 영어/한국어 README를 바로 오갈 수 있도록 언어 전환 링크를 복구했습니다.
14
+ - README 문서 표에는 공개 문서 링크만 남기고, 내부 리서치와 성장 전략 문서는 npm/OSS 공개 표면에서 제외했습니다.
15
+
16
+ ## [3.3.2] - 2026-05-06
17
+
18
+ ### 포지셔닝 (Positioning)
19
+
20
+ - npm/GitHub에서 보이는 정체성을 **모든 레포를 위한 AI 코딩 에이전트 가드레일**로 재정리했습니다.
21
+ - `AGENTS.md`, Copilot instructions, Cursor rules, Claude skills, 에이전트 실행기, 일반 LLM/MCP 가드레일과 비교해 DeukAgentRules가 더하는 티켓 생명주기, 범위 계약, 검증, 아카이브 가능한 기억을 README에 드러냈습니다.
22
+ - 다음 개선 방향으로 첫 실행 점검, CLI/RAG 재각인 신호, active ticket/phase/open ticket count/DeukAgentContext memory status를 보여주는 companion 표면을 명시했습니다.
23
+
24
+ ## [3.3.0] - 2026-05-02
25
+
26
+ ### 추가됨 (Added)
27
+
28
+ - **docs:** VS Code, Open VSX, GitHub, skill 기반 발견 루프를 포함한 AI 코딩 에이전트 가드레일 포지셔닝, 비전, 오가닉 유입 리서치 문서를 추가했습니다.
29
+ - **docs:** Karpathy식 skill, DeukAgentRules, DeukAgentContext 심층 비교 문서를 추가했습니다. Skill은 행동 playbook, DeukAgentRules는 workflow/permission control, DeukAgentContext는 ticketed engineering memory로 포지셔닝했습니다.
30
+ - **seo:** `andrej-karpathy-skills` 관련 아이디어 링크와 Claude Code, AGENTS.md, Cursor rules, agent skills, AI guardrails 검색 유입 키워드를 보강했습니다.
31
+
32
+ ### 변경됨 (Changed)
33
+
34
+ - **ticket:** 열린 티켓이 설정된 한도를 넘을 때 자동 정리 대신 사용자가 목록을 보고 결정할 수 있는 cleanup flow를 강화했습니다.
35
+ - **ticket:** 닫힌 티켓은 자동 아카이브할 수 있게 하고, 아카이브된 티켓은 년월/일 단위로 정리되도록 했습니다.
36
+ - **docs:** README 문서 목록과 GitHub topic 가이드를 agent guardrail, instruction hub, skill registry, project memory 포지셔닝에 맞게 갱신했습니다.
37
+
38
+ ### 수정됨 (Fixed)
39
+
40
+ - **ticket:** 새 작업 진입 전에 정리 결정을 노출하여 열린 티켓 수가 의도한 운영 한도를 조용히 넘는 문제를 방지했습니다.
41
+
42
+ ## [3.2.0] - 2026-04-29
43
+
44
+ ### 추가됨 (Added)
45
+ - **agent:** 플랫폼 공존(Platform Coexistence) 및 모드 인지형(Mode-aware) 워크플로우 구현. (Plan Mode에서 TDW Phase 자동 매핑, `platform-coexistence.md` 규칙 추가, 수정 제어 및 `PROJECT_RULE.md` 포인터 연동 등)
46
+
47
+ ### 변경됨 (Changed)
48
+ - **agents:** Co-existence Protocol 및 Workflow Gate 기능 도입 (T-120).
49
+ - v3.1.0 아키텍처 원칙 및 사용법 문서 개선.
50
+
51
+ ## [3.1.0] - 2026-04-28
52
+
53
+ ### 추가됨 (Added)
54
+ - **arch:** 제로카피(Zero-Copy) 포인터 아키텍처 도입 (`PROJECT_RULE.md` 연동) 및 구조 간소화
55
+ - **cli:** 엄격한 Phase 기반 티켓 워크플로우 및 APC(Agent Permission Contract) 검증 기능 추가
56
+ - **cli:** `--plan-body` 옵션을 통한 채워진 Phase 1 티켓 본문 입력 기능 추가
57
+ - **ticket:** 티켓 아카이브 시 불필요한 토큰 낭비를 막는 Zero-Token 지식 증류(Knowledge Distillation) 구현
58
+ - **telemetry:** 로컬 환경에 최적화된 Telemetry CLI 추가
59
+ - **rules:** `PROJECT_RULE.md` 템플릿 추가 (AI 에이전트 폴백 가이드 포함) 및 이중 언어(한/영) 지원
60
+
61
+ ### 수정됨 (Fixed)
62
+ - **rules:** `PROJECT_RULE.md` 내 중복된 코어 룰 링크 제거 및 Frontmatter 렌더링 복구
63
+ - **telemetry:** 모델 및 설정에서 클라이언트 도구를 자동으로 감지하도록 수정
64
+ - **agent:** 티켓 탐색 중 에이전트 무한 루프 문제 해결
65
+
66
+ ### 변경됨 (Changed)
67
+ - **agent:** TDD 용어를 TDW (Ticket-Driven Workflow)로 변경 및 전역 `AGENTS.md`에서 낡은 규칙 제거
68
+ - **cli:** 상태 기반(State-driven) 경로 탐색 로직으로 구조 개편 및 상세한 사용 가이드 추가
69
+
70
+ ## [3.0.0] - 2026-04-25
71
+
72
+ ### 🚀 대규모 업데이트: Hub-Spoke 아키텍처
73
+ - **Canonical Rule Hub**: 모든 AI 에이전트의 단일 진실 공급원(SSOT)으로 `AGENTS.md` 도입.
74
+ - **Thin Spoke Pointers**: IDE별 룰(Cursor, Copilot 등)을 중앙 Hub를 가리키는 가벼운 포인터로 변경하여 중복 및 동기화 오류 제거.
75
+ - **Global CLI Proxy**: 로컬 워크스페이스 소스를 자동 감지하여 실행을 위임하는 프록시 도입으로 지연 없는(Zero-latency) 개발 환경 구축.
76
+
77
+ ### 🧹 제로 레거시 & 환경 정리
78
+ - **Auto-Purge**: `init` 실행 시 더 이상 사용되지 않는 레거시 `.cursorrules` 파일을 무조건 삭제.
79
+ - **Smart Backups**: 사용자 정의 규칙을 감지하여 삭제 대신 `.bak` 파일로 백업하는 로직 추가.
80
+ - **Submodule Scrubbing**: 비어 있는 서브모듈 디렉터리 스텁 및 `.gitmodules` 자동 정리 기능.
81
+
82
+ ### 🏗️ 리브랜딩 & 인프라스텍
83
+ - **Identity Overhaul**: "Zero-Latency, High-Signal AI Orchestration Protocol"로 리브랜딩.
84
+ - **Documentation v3**: 고품질 3D 인포그래픽 및 구조, 원리, 작동 방식 등 개념 가이드 전면 개편.
85
+ - **Domain Agnostic**: 도메인별 하드코딩을 제거하고 모든 기술 스택을 지원하도록 `bundle/AGENTS.md` 일반화.
86
+
87
+ ### ⚙️ CLI 개선 사항
88
+ - **Proxy Routing**: `bin/deuk-agent-rule.js`가 디렉터리를 탐색하여 로컬 스크립트를 찾아 실행하도록 수정.
89
+ - **Synchronized IO**: CLI의 안정성을 높이기 위해 핵심 로직을 동기적 파일 시스템 연산으로 리팩터링.
9
90
  ## [2.4.6] - 2026-04-19
10
91
 
11
92
  ### 수정됨 (Fixed)
package/CHANGELOG.md CHANGED
@@ -4,364 +4,186 @@ All notable changes to this project will be documented in this file.
4
4
 
5
5
  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).
6
6
 
7
- ## [2.5.14] - 2026-04-22
7
+ ## [3.3.3] - 2026-05-06
8
+
9
+ ### Fixed
10
+
11
+ - Restored the README language switch links so npm and GitHub readers can move between English and Korean documentation from the first screen.
12
+ - Published only public documentation links in the README tables while keeping internal research and growth notes out of the npm/OSS surface.
13
+
14
+ ## [3.3.2] - 2026-05-06
15
+
16
+ ### Positioning
17
+
18
+ - 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.
19
+ - 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.
20
+ - 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.
21
+
22
+
23
+ ### Added
24
+
25
+ - AGENTS.md v12 + summary mandatory guard + PROJECT_RULE optimization
26
+ - **cli:** add 'ticket next' command for instant task discovery (T[#295](https://github.com/joygram/DeukAgentRules/issues/295))
27
+ - **cli:** enforce required frontmatter keys in lint:md (T-118)
28
+ - harden ticket paths and add DeukPack RAG schemas
29
+ - **migration:** add summary/planLink/caution auto-enrichment for legacy tickets
30
+ - Phase 0 search limiter - max 2 MCP calls, skip when context sufficient
31
+ - replace legacy fill-in-the-blank rule check with Version Gating and Task Relevance check
32
+ - **rules:** enforce hard guardrails, add hotfix protocol and urgency response
33
+ - **rules:** harden document boundary workflow
34
+ - **spoke:** add fill-in completion template for rule enforcement
35
+ - **T-114:** 1-CALL ticket discovery rule + CLI max call limits
36
+ - **T-115:** HARD BLOCK on write tools without active ticket
37
+ - **T-116:** auto-close stale tickets on ticket create + Phase 4 NEVER skip
38
+ - **T-116:** smart close based on checklist + phase state
39
+ - **ticket:** enforce filled create flow and phase1 status guard
40
+ - **ticket:** enforce open ticket cleanup flow
41
+ - **ticket:** partition archive index by month
8
42
 
9
43
 
10
44
  ### Fixed
11
45
 
12
- - **cli:** resolve marker nesting bug in AGENTS.md injection
13
-
14
- ## [2.5.13] - 2026-04-22
15
-
16
-
17
- ### Added
18
-
19
- - implement RAG-Miss fallback rule, fix ticket template formatting, and ignore tmp dirs in submodule discovery
20
-
21
-
22
- ### Changed
23
-
24
- - squash mermaid diagram changelog noise into single entry
25
-
26
- ## [2.5.12] - 2026-04-22
46
+ - add Refactor Safety Guard and Halt-and-Replan hard rules
47
+ - agent degradation remediation — planLink, inline TDW, token optimization
48
+ - align ticket APC template with phase gate
49
+ - **docs:** correct frontmatter keys in AGENTS.md (remove fm_ prefix)
50
+ - **init:** deploy Antigravity spoke to project root AGENTS.md
51
+ - register legitimate DR-04/DR-05 exceptions and update PROJECT_RULE.md
52
+ - remove duplicate phase key in ticket template and repair broken tickets
53
+ - **rules:** announce active ticket at start
54
+ - **rules:** keep planlink free of progress checkboxes
55
+ - **rules:** make planlink capture agent analysis
56
+ - **rules:** separate ticket and plan content
57
+ - **spoke:** GLOBAL_AGENTS.md link text to actual filename AGENTS.md
58
+ - SSOT init removes .deuk-agent/templates/ unconditionally (bundle is single source of truth)
59
+ - **T-116:** parallel-safe auto-close - only close activeTicketId, warn others
60
+ - **T-116:** replace auto-close with activeTicketId switch + warning
61
+ - **ticket:** honor project and submodule filters
62
+ - **ticket:** Sync close/archive status to frontmatter to prevent rebuild reversion
27
63
 
28
64
 
29
65
  ### Changed
30
66
 
31
- - squash mermaid diagram changelog noise into single entry
67
+ - add Dependency Integrity Guard (HARD RULE) to AGENTS.md
68
+ - add lite accessibility vision plan
69
+ - add skill positioning release notes
70
+ - add version frontmatter to AGENTS.md for rule loading optimization
71
+ - align bad examples with plan/archive convention
72
+ - archive bmt coordination ticket 142
73
+ - archive bmt frontmatter cleanup ticket 144
74
+ - archive bmt go ticket 140
75
+ - archive bmt java ticket 139
76
+ - archive bmt matrix ticket 133
77
+ - archive bmt rust ticket 141
78
+ - bump AGENTS.md to v15 and strengthen dependency guards
79
+ - clarify ticket creation flow
80
+ - document rationale for docs/plan and fix section numbering
81
+ - Enforce strict rules for Scope Creep Handling
82
+ - enhance main features and workflow intro for v3.2.0
83
+ - optimize AGENTS.md — merge Dependency Integrity into Refactor Guard, compress Scope Creep
84
+ - position agent guardrail growth loop
85
+ - **rules:** clarify phase one execution semantics
86
+ - **rules:** mandate enrich_frontmatter for all plan/report files (T-118)
87
+ - **spoke:** hard rule single directive
88
+ - update legacy path guidance to plan/archive layout
32
89
 
33
- ## [2.5.11] - 2026-04-22
90
+ ## [3.3.0] - 2026-05-02
34
91
 
35
92
  ### Added
36
93
 
37
- - implement modernized workflow diagrams with Mermaid v8.8.0 compatibility, semantic color palette, and native SVG text rendering for IDE dark mode compatibility
38
-
39
- ## [2.5.1] - 2026-04-22
40
-
41
- ### Added
42
-
43
- - **cli:** add --clean flag to init command for safe configuration reset
44
-
45
- ## [2.5.0] - 2026-04-22
46
-
47
- ### Added
48
-
49
- - Agent-Agnostic Workflow and Archiving Protocol
50
- - **cli:** parse DeukRag config for conditions and auto-scaffold plan templates
51
- - implement Frontmatter-driven modular rule assembly (Ticket 045)
52
- - Model-specific hard rules (gemini.md) and Continuous RAG enforcement
53
- - **rules:** enforce Phase 0 MCP RAG in multi-ai-workflow MDC
54
- - **rules:** harden post-mortem workflow and mandate follow-up chaining
55
- - **templates:** enforce Phase 0 RAG Research checklists in ticket template
56
-
57
-
58
- ### Fixed
59
-
60
- - handoff path format, 3-tier template system, recursive init with normalization
61
- - improve migration robustness with merging logic and cleanup dead code
62
- - recursive directory merge for legacy migration
63
-
94
+ - **docs:** add AI coding agent guardrail positioning, vision, and organic growth research for VS Code, Open VSX, GitHub, and skill-driven discovery.
95
+ - **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.
96
+ - **seo:** add related-project positioning for `andrej-karpathy-skills` plus discovery keywords for Claude Code, AGENTS.md, Cursor rules, agent skills, and AI guardrails.
64
97
 
65
98
  ### Changed
66
99
 
67
- - add ticket 045 completion report
68
- - add what's new for v2.4, RAG engine notice, and SEO keywords
69
- - **rules:** Add Fast-Track workflow to prevent ticket loop overhead
70
- - **rules:** enforce Continuous RAG Policy and Absolute MCP Priority
71
- - **rules:** Mandate Continuous RAG during execution and verification phases
72
- - **rules:** Restore TDD workflow but ban interactive CLI looping
73
- - upgrade workflow diagram and add migration troubleshooting guide
74
-
75
- ## [2.4.6] - 2026-04-19
100
+ - **ticket:** enforce a decision-first cleanup flow when open tickets exceed the configured limit, while allowing closed tickets to be archived automatically.
101
+ - **ticket:** organize archived tickets by year-month and day to reduce active ticket repository clutter.
102
+ - **docs:** update README document indexes and GitHub topic guidance to emphasize the agent guardrail, instruction hub, skill registry, and project memory positioning.
76
103
 
77
104
  ### Fixed
78
105
 
79
- - **cli:** suppress update notifier when local version is greater than or equal to registry version (fixes false-positive spam in local dev symlink environments)
80
- - **ticket:** cap `NNN` regex to 4 digits to prevent unix timestamps being incorrectly parsed as ticket sequential numbers, restoring correct `NNN-topic-hostname` format generation
106
+ - **ticket:** prevent open ticket growth from silently exceeding the intended operating limit by surfacing cleanup decisions before new work proceeds.
81
107
 
82
- ## [2.4.5] - 2026-04-18
108
+ ## [3.2.0] - 2026-04-28
83
109
 
84
110
 
85
111
  ### Added
86
112
 
87
- - **cli:** add update notifier for checking latest npm version
113
+ - **agent:** implement platform coexistence and mode-aware workflow
114
+
115
+
116
+ ### Changed
117
+
118
+ - **agents:** add Co-existence Protocol and Workflow Gate (T-120)
119
+ - update usage, architecture, and principles for v3.1.0
120
+
121
+ ## [3.1.0] - 2026-04-28
122
+
123
+
124
+ ### Added
125
+
126
+ - add ArchitectureGuard.test.mjs and create technical debt ticket T-103
127
+ - add first-class copilot and codex support
128
+ - **arch:** implement APC v3 and simplify repository structure
129
+ - **cli:** restrict --skip-phase0 based on MCP server status and update rules
130
+ - consolidate rule cleanup logic and enforce thin pointers for entry points
131
+ - enforce unidirectional AGENTS.md single source of truth
132
+ - enhance CLI reporting and add practical usage guide
133
+ - implement strict phase-driven ticket workflow with APC validation
134
+ - implement Zero-Copy architecture with absolute path pointing and frontmatter-based PROJECT_RULE.md
135
+ - implement zero-token knowledge distillation on ticket archive and cleanup dead code
136
+ - **rules:** add AI Agent fallback guide to PROJECT_RULE.md template
137
+ - **rules:** normalize canonical rules and decouple DeukPack rules
138
+ - **telemetry:** add local-first telemetry CLI and update AGENTS.md
139
+ - **ticket:** implement --plan-body for filled Phase 1 ticket body input and update project rules
88
140
 
89
141
 
90
142
  ### Fixed
91
143
 
92
- - **ticket:** resolve discrepancy between filename and ticket ID generation
93
- - **ticket:** strictly enforce 8-character limit on hostname slug
144
+ - auto-detect client tool from model and config in telemetry
145
+ - resolve agent loop on ticket navigation + archive 37 dead tickets
146
+ - **rules:** bilingual ko/en PROJECT_RULE.md template
147
+ - **rules:** remove redundant core rules link from PROJECT_RULE.md
148
+ - **rules:** restore frontmatter in PROJECT_RULE.md
149
+ - **rules:** restore mandatory ticket workflow and anti-shoveling rules
150
+ - **rules:** sync restored strict workflow AGENTS.md and unified templates
94
151
 
95
152
 
96
153
  ### Changed
97
154
 
98
- - add reasons for global installation
99
- - **changelog:** sync korean changelog with v2.4.0
100
- - generalize AGENTS.md and cleanup submodule-specific rules
101
- - **ticket:** new ID format NNN-topic-hostname with backward-compatible parsing
155
+ - add markdown lint policy and workflow docs
156
+ - **agent:** rename TDD to TDW, archive ticket 101, and remove DOMAIN_RULES
157
+ - AGENTS.md full cleanup - eliminate redundancy, unify English, remove dead rules
158
+ - finalize ticket 066 rule normalization
159
+ - modernize CLI architecture, implement state-driven path resolution, and comprehensive audit cleanup
160
+ - **rules:** decouple DeukPack rules and fix merge injection logic
161
+ - update principles and cli compiler to DeukAgentContext
102
162
 
103
- ## [2.4.4] - 2026-04-19
104
-
105
- ### Changed
163
+ ## [3.0.0] - 2026-04-25
106
164
 
107
- - **rules:** generalize `AGENTS.md` by moving submodule-specific rules (DeukPack, C++, Unity) to their respective workspace `MODULE_RULE.md` files
108
- - **templates:** cleanup legacy templates in `bundle/` to match `publish/` source
165
+ ### 🚀 Major Breakthrough: Hub-Spoke Architecture
166
+ - **Canonical Rule Hub**: Introduced `AGENTS.md` as the single source of truth for all AI agents.
167
+ - **Thin Spoke Pointers**: IDE-specific rules (Cursor, Copilot, etc.) are now lightweight pointers to the central Hub, eliminating duplication and sync errors.
168
+ - **Global CLI Proxy**: Implemented a smart entry point that automatically detects and routes execution to local workspace sources, ensuring zero-latency development.
109
169
 
110
- ## [2.4.3] - 2026-04-18
170
+ ### 🧹 Zero-Legacy & Cleanliness
171
+ - **Auto-Purge**: `init` now unconditionally deletes deprecated `.cursorrules` files.
172
+ - **Smart Backups**: Added logic to detect custom user rules and rename files to `.bak` instead of deletion.
173
+ - **Submodule Scrubbing**: Automatically cleans empty submodule directory stubs and scrubs `.gitmodules`.
111
174
 
112
- ### Changed
113
-
114
- - **ticket:** new ID format `NNN-topic-hostname` (e.g. `001-add-feature-joy-nucb`) replacing legacy `ticket_NNN_hostname_topic` format
115
- - **ticket:** backward-compatible parsing supports both old and new formats in INDEX.json
116
-
117
- ## [2.4.2] - 2026-04-18
118
-
119
-
120
- ### Added
175
+ ### 🏗️ Branding & Infrastructure
176
+ - **Identity Overhaul**: Rebranded as a "Zero-Latency, High-Signal AI Orchestration Protocol".
177
+ - **Documentation v3**: New high-end 3D visual infographics and overhauled conceptual guides (Architecture, Principles, How-it-works).
178
+ - **Domain Agnostic**: Generalized `bundle/AGENTS.md` to support any technology stack, removing domain-specific hardcoding.
121
179
 
122
- - **cli:** add update notifier for checking latest npm version
180
+ ### ⚙️ CLI Enhancements
181
+ - **Proxy Routing**: `bin/deuk-agent-rule.js` performs directory traversal to find local scripts.
182
+ - **Synchronized IO**: Refactored core logic to use synchronous FS operations for rock-solid CLI stability.
123
183
 
124
-
125
- ### Fixed
126
-
127
- - **ticket:** resolve discrepancy between filename and ticket ID generation
128
- - **ticket:** strictly enforce 8-character limit on hostname slug
129
-
130
-
131
- ### Changed
132
-
133
- - add reasons for global installation
134
- - **changelog:** sync korean changelog with v2.4.0
135
-
136
- ## [2.4.1] - 2026-04-18
137
-
138
-
139
- ### Added
140
-
141
- - **cli:** add update notifier for checking latest npm version
142
-
143
-
144
- ### Fixed
145
-
146
- - **ticket:** strictly enforce 8-character limit on hostname slug
147
-
148
-
149
- ### Changed
150
-
151
- - add reasons for global installation
152
- - **changelog:** sync korean changelog with v2.4.0
184
+ ---
153
185
 
154
186
  ## [2.4.0] - 2026-04-18
155
-
156
-
157
- ### Added
158
-
159
- - **init:** add obsolete template cleanup for cleaner migration
160
- - **rules:** add TICKET VERIFICATION RULE to original agents.md
161
- - **ticket:** add priority property to tickets
162
- - **ticket:** add sequential hostname-aware ticket naming (NNN-hostname-topic)
163
- - **ticket:** auto-sequence numbering and hostname-based naming (limit 8 chars)
164
-
165
-
166
- ### Fixed
167
-
168
- - **rules:** force use of local latest deuk-agent-rule to avoid npx cache issues
169
- - **scripts:** correct log output for OSS repository url example
170
-
171
-
172
- ### Changed
173
-
174
- - add Step 4 (Ticket Verification) to README files
175
- - clarify global installation and OS-specific permissions
176
- - enforce ticket reference in implementation artifacts
177
-
178
- ## [2.3.2] - 2026-04-17
179
-
180
-
181
- ### Fixed
182
-
183
- - **cli:** resolve `ERR_MODULE_NOT_FOUND` in distributed environments by fixing hardcoded `yaml` dependency path
184
- - **dependencies:** add `yaml` to explicit dependencies list
185
-
186
- ## [2.3.1] - 2026-04-17
187
-
188
-
189
- ### Changed
190
-
191
- - **readme:** add changelog and automated release instructions
192
-
193
- ## [2.3.0] - 2026-04-17
194
-
195
-
196
- ### Added
197
-
198
- - Advance AI pipeline integration and optional synchronization system
199
- - **cli:** add --submodule filter to ticket list command
200
- - **cli:** restore ticket archive and reports workflows to modular architecture
201
- - **rules:** advance rules for Unity Client, WebApp, and C++ Server hybrid environment
202
- - **ticket:** implementation of decentralized ticket management & sharing policy
203
- - **ticket:** upgrade to V2 YAML Front-matter and Categorized List
204
-
205
-
206
- ### Fixed
207
-
208
- - **ticket:** deprecate LATEST.md, unify pointer to ACTIVE_TICKET.md
209
- - **ticket:** resolve issue where active tickets were not listed for DeukAgentRules repo
210
-
211
-
212
- ### Changed
213
-
214
- - **readme:** clarify YAML front matter preservation and distributed ticket workflow for v2.2.2
215
- - **readme:** restore count headers and npm badges
216
- - **rules:** enforce CLI usage for ticket reading to prevent manual JSON parsing
217
- - Update CLI reference with close and migrate commands
218
-
219
- ## [1.0.18] - 2026-04-12
220
-
221
-
222
- ### Added
223
-
224
- - **ai:** map conversational ticket requests to implicit CLI execution
225
- - **cli:** implement ticket archive and reporting workflow
226
- - **rules:** map conversational ticket aliases to implicit CLI execution
227
-
228
-
229
- ### Changed
230
-
231
- - **readme:** add ticket archive and reports CLI usage to documentation
232
- - **readme:** describe natural language CLI prompting alternatives
233
- - **readme:** provide explicit conversational prompt examples inside option tables
234
- - **readme:** provide explicit update guide
235
- - **rules:** add prompting guide and execution report archival rule
236
-
237
- ## [1.0.17] - 2026-04-06
238
-
239
-
240
- ### Fixed
241
-
242
- - **template:** move ticket repo-relative marker to bottom
243
-
244
- ## [1.0.16] - 2026-04-05
245
-
246
-
247
- ### Added
248
-
249
- - **workflow:** add auto-verification and final report to agent workflows
250
-
251
- ## [1.0.15] - 2026-04-05
252
-
253
-
254
- ### Added
255
-
256
- - Migrate and rename handoff terminology to ticket in CLI and templates
257
-
258
-
259
- ### Changed
260
-
261
- - Add strict rule for DeukPack namespace requirement
262
- - Completely eradicate legacy Handoff references from AGENTS.md, templates, and mdc rules
263
- - Enforce DeukPack code format and API strictly as a hard rule
264
- - Refactor README usage guide and workflow
265
-
266
- ## [1.0.14] - 2026-04-02
267
-
268
-
269
- ### Added
270
-
271
- - **cli:** extend merge tooling and sync publish docs
272
- - **rules:** forbid 'sync' word in commit titles in agent rules
273
- - **handoff:** add indexed handoff workflow and CLI
274
- - **architecture:** migrate template architecture to zero-touch NPM bundle scaffolding
275
-
276
-
277
- ### Fixed
278
-
279
- - **cli:** resolve html entity syntax error in template generator
280
-
281
-
282
- ### Changed
283
-
284
- - **docs:** public-facing RELEASING and changelog wording; sync-bundle comment
285
- - **docs:** update README with token efficiency mechanism and zero-touch template scaffolding
286
-
287
- ## [1.0.13] - 2026-03-28
288
-
289
-
290
- ### Fixed
291
-
292
- - **deuk-agent-rule:** `printHandoffTip` missing in CLI (handoff tip after `init`)
293
-
294
-
295
- ### Changed
296
-
297
- - **docs:** README § Handoffs; GitHub About text; npm keywords; CLI survey adds Claude, Windsurf, JetBrains AI Assistant
298
- - **agents:** optional `.cursor/plans/*.plan.md` mirror for plan-style UI; chat `Path:` line and optional first-line path in handoff files
299
- - **deuk-agent-rule:** `init` prints a short handoff tip after ensuring `.deuk-agent-handoff/`
300
- - **deuk-agent-rule:** default `--rules prefix` overwrites existing `deuk-agent-rule-*.mdc` on repeat `init` (package updates without a separate `merge`)
301
- - **deuk-agent-rule:** `.deuk-agent-rule.config.json` stores interactive choices; later `init` reuses them (`--interactive` to change; `--non-interactive` for CI only)
302
-
303
-
304
- ## [1.0.12] - 2026-03-27
305
-
306
-
307
- ### Fixed
308
-
309
- - **ci:** release workflow runs on pushes to `master`
310
-
311
- ### Changed
312
-
313
- - **agents:** require full repo-root paths for handoff file links
314
-
315
- ## [1.0.11] - 2026-03-26
316
-
317
-
318
- ### Added
319
-
320
- - **ci:** GitHub Release workflow for version tags and `chore(release):` commits on `main` / `master`
321
-
322
- ## [1.0.10] - 2026-03-26
323
-
324
-
325
- ### Added
326
-
327
- - **deuk-agent-rule:** changelog template headers without per-commit links
328
-
329
- ## [1.0.9] - 2026-03-27
330
-
331
- ### Added
332
-
333
- - **deuk-agent-rule:** release changelog tooling; handoff directory gitignore; pre-work handoff scan; AGENTS inject newline fix
334
-
335
- ### Changed
336
-
337
- - **agents:** DeukAgentRules/handoff/LATEST.md handoff path for consumer repos
338
-
339
- ## [1.0.8] - 2026-03-27
340
-
341
- ### Added
342
-
343
- - This changelog and npm `files` entry so releases are traceable.
344
-
345
- ## [1.0.7] - 2026-03-27
346
-
347
- ### Added
348
-
349
- - `init`: create `.deuk-agent-handoff/` and append `.gitignore` rules for local handoffs.
350
- - CLI: pre-work handoff scan; `publish/AGENTS.md` and `multi-ai-workflow.mdc` updates.
351
-
352
- ### Fixed
353
-
354
- - AGENTS tagged-region merge: trailing newline after injected blocks.
355
-
356
- ## [1.0.5] - 2026-03-26
357
-
358
- ### Changed
359
-
360
- - README and package metadata (Deuk Family tagline, npm keywords, GitHub Topics note).
361
-
362
- ## [1.0.4] - 2026-03-26
363
-
364
- ### Changed
365
-
366
- - Release packaging includes `package-lock.json` for reproducible installs.
367
- - README: absolute links for the npm package page.
187
+ - add Codex CLI support (.codexrules) and apply globally
188
+ - implement ticket chaining (--chain) for automated ticket linkage
189
+ - improve submodule isolation logic