deuk-agent-rule 2.5.14 → 3.3.2

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 (44) hide show
  1. package/CHANGELOG.ko.md +74 -0
  2. package/CHANGELOG.md +137 -322
  3. package/README.ko.md +134 -154
  4. package/README.md +121 -153
  5. package/package.json +29 -7
  6. package/scripts/cli-args.mjs +87 -3
  7. package/scripts/cli-init-commands.mjs +1382 -223
  8. package/scripts/cli-init-logic.mjs +28 -16
  9. package/scripts/cli-prompts.mjs +13 -4
  10. package/scripts/cli-rule-compiler.mjs +44 -34
  11. package/scripts/cli-skill-commands.mjs +172 -0
  12. package/scripts/cli-telemetry-commands.mjs +429 -0
  13. package/scripts/cli-ticket-commands.mjs +1934 -161
  14. package/scripts/cli-ticket-index.mjs +298 -0
  15. package/scripts/cli-ticket-migration.mjs +320 -0
  16. package/scripts/cli-ticket-parser.mjs +207 -0
  17. package/scripts/cli-utils.mjs +381 -59
  18. package/scripts/cli.mjs +99 -19
  19. package/scripts/lint-md.mjs +247 -0
  20. package/scripts/lint-rules.mjs +143 -0
  21. package/scripts/merge-logic.mjs +13 -324
  22. package/scripts/plan-parser.mjs +53 -0
  23. package/templates/MODULE_RULE_TEMPLATE.md +11 -0
  24. package/templates/PROJECT_RULE.md +47 -0
  25. package/templates/TICKET_TEMPLATE.ko.md +21 -0
  26. package/templates/TICKET_TEMPLATE.md +21 -0
  27. package/templates/rules.d/deukcontext-mcp.md +31 -0
  28. package/templates/rules.d/platform-coexistence.md +29 -0
  29. package/templates/skills/context-recall/SKILL.md +25 -0
  30. package/templates/skills/generated-file-guard/SKILL.md +25 -0
  31. package/templates/skills/safe-refactor/SKILL.md +25 -0
  32. package/bundle/.cursorrules +0 -11
  33. package/bundle/AGENTS.md +0 -146
  34. package/bundle/gemini.md +0 -26
  35. package/bundle/rules/delivery-and-parallel-work.mdc +0 -26
  36. package/bundle/rules/git-commit.mdc +0 -24
  37. package/bundle/rules/multi-ai-workflow.mdc +0 -104
  38. package/bundle/rules.d/core-workflow.md +0 -48
  39. package/bundle/rules.d/deukrag-mcp.md +0 -37
  40. package/bundle/templates/MODULE_RULE_TEMPLATE.md +0 -24
  41. package/bundle/templates/TICKET_TEMPLATE.md +0 -58
  42. package/scripts/cli-ticket-logic.mjs +0 -568
  43. package/scripts/sync-bundle.mjs +0 -77
  44. package/scripts/sync-oss.mjs +0 -126
package/CHANGELOG.ko.md CHANGED
@@ -6,6 +6,80 @@
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.2] - 2026-05-06
10
+
11
+ ### 포지셔닝 (Positioning)
12
+
13
+ - npm/GitHub에서 보이는 정체성을 **모든 레포를 위한 AI 코딩 에이전트 가드레일**로 재정리했습니다.
14
+ - `AGENTS.md`, Copilot instructions, Cursor rules, Claude skills, 에이전트 실행기, 일반 LLM/MCP 가드레일과 비교해 DeukAgentRules가 더하는 티켓 생명주기, 범위 계약, 검증, 아카이브 가능한 기억을 README에 드러냈습니다.
15
+ - 다음 개선 방향으로 첫 실행 점검, CLI/RAG 재각인 신호, active ticket/phase/open ticket count/DeukAgentContext memory status를 보여주는 companion 표면을 명시했습니다.
16
+
17
+ ## [3.3.0] - 2026-05-02
18
+
19
+ ### 추가됨 (Added)
20
+
21
+ - **docs:** VS Code, Open VSX, GitHub, skill 기반 발견 루프를 포함한 AI 코딩 에이전트 가드레일 포지셔닝, 비전, 오가닉 유입 리서치 문서를 추가했습니다.
22
+ - **docs:** Karpathy식 skill, DeukAgentRules, DeukAgentContext 심층 비교 문서를 추가했습니다. Skill은 행동 playbook, DeukAgentRules는 workflow/permission control, DeukAgentContext는 ticketed engineering memory로 포지셔닝했습니다.
23
+ - **seo:** `andrej-karpathy-skills` 관련 아이디어 링크와 Claude Code, AGENTS.md, Cursor rules, agent skills, AI guardrails 검색 유입 키워드를 보강했습니다.
24
+
25
+ ### 변경됨 (Changed)
26
+
27
+ - **ticket:** 열린 티켓이 설정된 한도를 넘을 때 자동 정리 대신 사용자가 목록을 보고 결정할 수 있는 cleanup flow를 강화했습니다.
28
+ - **ticket:** 닫힌 티켓은 자동 아카이브할 수 있게 하고, 아카이브된 티켓은 년월/일 단위로 정리되도록 했습니다.
29
+ - **docs:** README 문서 목록과 GitHub topic 가이드를 agent guardrail, instruction hub, skill registry, project memory 포지셔닝에 맞게 갱신했습니다.
30
+
31
+ ### 수정됨 (Fixed)
32
+
33
+ - **ticket:** 새 작업 진입 전에 정리 결정을 노출하여 열린 티켓 수가 의도한 운영 한도를 조용히 넘는 문제를 방지했습니다.
34
+
35
+ ## [3.2.0] - 2026-04-29
36
+
37
+ ### 추가됨 (Added)
38
+ - **agent:** 플랫폼 공존(Platform Coexistence) 및 모드 인지형(Mode-aware) 워크플로우 구현. (Plan Mode에서 TDW Phase 자동 매핑, `platform-coexistence.md` 규칙 추가, 수정 제어 및 `PROJECT_RULE.md` 포인터 연동 등)
39
+
40
+ ### 변경됨 (Changed)
41
+ - **agents:** Co-existence Protocol 및 Workflow Gate 기능 도입 (T-120).
42
+ - v3.1.0 아키텍처 원칙 및 사용법 문서 개선.
43
+
44
+ ## [3.1.0] - 2026-04-28
45
+
46
+ ### 추가됨 (Added)
47
+ - **arch:** 제로카피(Zero-Copy) 포인터 아키텍처 도입 (`PROJECT_RULE.md` 연동) 및 구조 간소화
48
+ - **cli:** 엄격한 Phase 기반 티켓 워크플로우 및 APC(Agent Permission Contract) 검증 기능 추가
49
+ - **cli:** `--plan-body` 옵션을 통한 채워진 Phase 1 티켓 본문 입력 기능 추가
50
+ - **ticket:** 티켓 아카이브 시 불필요한 토큰 낭비를 막는 Zero-Token 지식 증류(Knowledge Distillation) 구현
51
+ - **telemetry:** 로컬 환경에 최적화된 Telemetry CLI 추가
52
+ - **rules:** `PROJECT_RULE.md` 템플릿 추가 (AI 에이전트 폴백 가이드 포함) 및 이중 언어(한/영) 지원
53
+
54
+ ### 수정됨 (Fixed)
55
+ - **rules:** `PROJECT_RULE.md` 내 중복된 코어 룰 링크 제거 및 Frontmatter 렌더링 복구
56
+ - **telemetry:** 모델 및 설정에서 클라이언트 도구를 자동으로 감지하도록 수정
57
+ - **agent:** 티켓 탐색 중 에이전트 무한 루프 문제 해결
58
+
59
+ ### 변경됨 (Changed)
60
+ - **agent:** TDD 용어를 TDW (Ticket-Driven Workflow)로 변경 및 전역 `AGENTS.md`에서 낡은 규칙 제거
61
+ - **cli:** 상태 기반(State-driven) 경로 탐색 로직으로 구조 개편 및 상세한 사용 가이드 추가
62
+
63
+ ## [3.0.0] - 2026-04-25
64
+
65
+ ### 🚀 대규모 업데이트: Hub-Spoke 아키텍처
66
+ - **Canonical Rule Hub**: 모든 AI 에이전트의 단일 진실 공급원(SSOT)으로 `AGENTS.md` 도입.
67
+ - **Thin Spoke Pointers**: IDE별 룰(Cursor, Copilot 등)을 중앙 Hub를 가리키는 가벼운 포인터로 변경하여 중복 및 동기화 오류 제거.
68
+ - **Global CLI Proxy**: 로컬 워크스페이스 소스를 자동 감지하여 실행을 위임하는 프록시 도입으로 지연 없는(Zero-latency) 개발 환경 구축.
69
+
70
+ ### 🧹 제로 레거시 & 환경 정리
71
+ - **Auto-Purge**: `init` 실행 시 더 이상 사용되지 않는 레거시 `.cursorrules` 파일을 무조건 삭제.
72
+ - **Smart Backups**: 사용자 정의 규칙을 감지하여 삭제 대신 `.bak` 파일로 백업하는 로직 추가.
73
+ - **Submodule Scrubbing**: 비어 있는 서브모듈 디렉터리 스텁 및 `.gitmodules` 자동 정리 기능.
74
+
75
+ ### 🏗️ 리브랜딩 & 인프라스텍
76
+ - **Identity Overhaul**: "Zero-Latency, High-Signal AI Orchestration Protocol"로 리브랜딩.
77
+ - **Documentation v3**: 고품질 3D 인포그래픽 및 구조, 원리, 작동 방식 등 개념 가이드 전면 개편.
78
+ - **Domain Agnostic**: 도메인별 하드코딩을 제거하고 모든 기술 스택을 지원하도록 `bundle/AGENTS.md` 일반화.
79
+
80
+ ### ⚙️ CLI 개선 사항
81
+ - **Proxy Routing**: `bin/deuk-agent-rule.js`가 디렉터리를 탐색하여 로컬 스크립트를 찾아 실행하도록 수정.
82
+ - **Synchronized IO**: CLI의 안정성을 높이기 위해 핵심 로직을 동기적 파일 시스템 연산으로 리팩터링.
9
83
  ## [2.4.6] - 2026-04-19
10
84
 
11
85
  ### 수정됨 (Fixed)
package/CHANGELOG.md CHANGED
@@ -4,364 +4,179 @@ 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.2] - 2026-05-06
8
+
9
+ ### Positioning
10
+
11
+ - 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.
12
+ - 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.
13
+ - 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.
14
+
15
+
16
+ ### Added
17
+
18
+ - AGENTS.md v12 + summary mandatory guard + PROJECT_RULE optimization
19
+ - **cli:** add 'ticket next' command for instant task discovery (T[#295](https://github.com/joygram/DeukAgentRules/issues/295))
20
+ - **cli:** enforce required frontmatter keys in lint:md (T-118)
21
+ - harden ticket paths and add DeukPack RAG schemas
22
+ - **migration:** add summary/planLink/caution auto-enrichment for legacy tickets
23
+ - Phase 0 search limiter - max 2 MCP calls, skip when context sufficient
24
+ - replace legacy fill-in-the-blank rule check with Version Gating and Task Relevance check
25
+ - **rules:** enforce hard guardrails, add hotfix protocol and urgency response
26
+ - **rules:** harden document boundary workflow
27
+ - **spoke:** add fill-in completion template for rule enforcement
28
+ - **T-114:** 1-CALL ticket discovery rule + CLI max call limits
29
+ - **T-115:** HARD BLOCK on write tools without active ticket
30
+ - **T-116:** auto-close stale tickets on ticket create + Phase 4 NEVER skip
31
+ - **T-116:** smart close based on checklist + phase state
32
+ - **ticket:** enforce filled create flow and phase1 status guard
33
+ - **ticket:** enforce open ticket cleanup flow
34
+ - **ticket:** partition archive index by month
8
35
 
9
36
 
10
37
  ### Fixed
11
38
 
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
39
+ - add Refactor Safety Guard and Halt-and-Replan hard rules
40
+ - agent degradation remediation — planLink, inline TDW, token optimization
41
+ - align ticket APC template with phase gate
42
+ - **docs:** correct frontmatter keys in AGENTS.md (remove fm_ prefix)
43
+ - **init:** deploy Antigravity spoke to project root AGENTS.md
44
+ - register legitimate DR-04/DR-05 exceptions and update PROJECT_RULE.md
45
+ - remove duplicate phase key in ticket template and repair broken tickets
46
+ - **rules:** announce active ticket at start
47
+ - **rules:** keep planlink free of progress checkboxes
48
+ - **rules:** make planlink capture agent analysis
49
+ - **rules:** separate ticket and plan content
50
+ - **spoke:** GLOBAL_AGENTS.md link text to actual filename AGENTS.md
51
+ - SSOT — init removes .deuk-agent/templates/ unconditionally (bundle is single source of truth)
52
+ - **T-116:** parallel-safe auto-close - only close activeTicketId, warn others
53
+ - **T-116:** replace auto-close with activeTicketId switch + warning
54
+ - **ticket:** honor project and submodule filters
55
+ - **ticket:** Sync close/archive status to frontmatter to prevent rebuild reversion
20
56
 
21
57
 
22
58
  ### Changed
23
59
 
24
- - squash mermaid diagram changelog noise into single entry
25
-
26
- ## [2.5.12] - 2026-04-22
27
-
60
+ - add Dependency Integrity Guard (HARD RULE) to AGENTS.md
61
+ - add lite accessibility vision plan
62
+ - add skill positioning release notes
63
+ - add version frontmatter to AGENTS.md for rule loading optimization
64
+ - align bad examples with plan/archive convention
65
+ - archive bmt coordination ticket 142
66
+ - archive bmt frontmatter cleanup ticket 144
67
+ - archive bmt go ticket 140
68
+ - archive bmt java ticket 139
69
+ - archive bmt matrix ticket 133
70
+ - archive bmt rust ticket 141
71
+ - bump AGENTS.md to v15 and strengthen dependency guards
72
+ - clarify ticket creation flow
73
+ - document rationale for docs/plan and fix section numbering
74
+ - Enforce strict rules for Scope Creep Handling
75
+ - enhance main features and workflow intro for v3.2.0
76
+ - optimize AGENTS.md — merge Dependency Integrity into Refactor Guard, compress Scope Creep
77
+ - position agent guardrail growth loop
78
+ - **rules:** clarify phase one execution semantics
79
+ - **rules:** mandate enrich_frontmatter for all plan/report files (T-118)
80
+ - **spoke:** hard rule single directive
81
+ - update legacy path guidance to plan/archive layout
28
82
 
29
- ### Changed
30
-
31
- - squash mermaid diagram changelog noise into single entry
32
-
33
- ## [2.5.11] - 2026-04-22
34
-
35
- ### Added
36
-
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
83
+ ## [3.3.0] - 2026-05-02
46
84
 
47
85
  ### Added
48
86
 
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
-
87
+ - **docs:** add AI coding agent guardrail positioning, vision, and organic growth research for VS Code, Open VSX, GitHub, and skill-driven discovery.
88
+ - **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.
89
+ - **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
90
 
65
91
  ### Changed
66
92
 
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
93
+ - **ticket:** enforce a decision-first cleanup flow when open tickets exceed the configured limit, while allowing closed tickets to be archived automatically.
94
+ - **ticket:** organize archived tickets by year-month and day to reduce active ticket repository clutter.
95
+ - **docs:** update README document indexes and GitHub topic guidance to emphasize the agent guardrail, instruction hub, skill registry, and project memory positioning.
76
96
 
77
97
  ### Fixed
78
98
 
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
99
+ - **ticket:** prevent open ticket growth from silently exceeding the intended operating limit by surfacing cleanup decisions before new work proceeds.
81
100
 
82
- ## [2.4.5] - 2026-04-18
101
+ ## [3.2.0] - 2026-04-28
83
102
 
84
103
 
85
104
  ### Added
86
105
 
87
- - **cli:** add update notifier for checking latest npm version
106
+ - **agent:** implement platform coexistence and mode-aware workflow
107
+
108
+
109
+ ### Changed
110
+
111
+ - **agents:** add Co-existence Protocol and Workflow Gate (T-120)
112
+ - update usage, architecture, and principles for v3.1.0
113
+
114
+ ## [3.1.0] - 2026-04-28
115
+
116
+
117
+ ### Added
118
+
119
+ - add ArchitectureGuard.test.mjs and create technical debt ticket T-103
120
+ - add first-class copilot and codex support
121
+ - **arch:** implement APC v3 and simplify repository structure
122
+ - **cli:** restrict --skip-phase0 based on MCP server status and update rules
123
+ - consolidate rule cleanup logic and enforce thin pointers for entry points
124
+ - enforce unidirectional AGENTS.md single source of truth
125
+ - enhance CLI reporting and add practical usage guide
126
+ - implement strict phase-driven ticket workflow with APC validation
127
+ - implement Zero-Copy architecture with absolute path pointing and frontmatter-based PROJECT_RULE.md
128
+ - implement zero-token knowledge distillation on ticket archive and cleanup dead code
129
+ - **rules:** add AI Agent fallback guide to PROJECT_RULE.md template
130
+ - **rules:** normalize canonical rules and decouple DeukPack rules
131
+ - **telemetry:** add local-first telemetry CLI and update AGENTS.md
132
+ - **ticket:** implement --plan-body for filled Phase 1 ticket body input and update project rules
88
133
 
89
134
 
90
135
  ### Fixed
91
136
 
92
- - **ticket:** resolve discrepancy between filename and ticket ID generation
93
- - **ticket:** strictly enforce 8-character limit on hostname slug
137
+ - auto-detect client tool from model and config in telemetry
138
+ - resolve agent loop on ticket navigation + archive 37 dead tickets
139
+ - **rules:** bilingual ko/en PROJECT_RULE.md template
140
+ - **rules:** remove redundant core rules link from PROJECT_RULE.md
141
+ - **rules:** restore frontmatter in PROJECT_RULE.md
142
+ - **rules:** restore mandatory ticket workflow and anti-shoveling rules
143
+ - **rules:** sync restored strict workflow AGENTS.md and unified templates
94
144
 
95
145
 
96
146
  ### Changed
97
147
 
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
148
+ - add markdown lint policy and workflow docs
149
+ - **agent:** rename TDD to TDW, archive ticket 101, and remove DOMAIN_RULES
150
+ - AGENTS.md full cleanup - eliminate redundancy, unify English, remove dead rules
151
+ - finalize ticket 066 rule normalization
152
+ - modernize CLI architecture, implement state-driven path resolution, and comprehensive audit cleanup
153
+ - **rules:** decouple DeukPack rules and fix merge injection logic
154
+ - update principles and cli compiler to DeukAgentContext
102
155
 
103
- ## [2.4.4] - 2026-04-19
104
-
105
- ### Changed
106
-
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
109
-
110
- ## [2.4.3] - 2026-04-18
111
-
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
156
+ ## [3.0.0] - 2026-04-25
118
157
 
158
+ ### 🚀 Major Breakthrough: Hub-Spoke Architecture
159
+ - **Canonical Rule Hub**: Introduced `AGENTS.md` as the single source of truth for all AI agents.
160
+ - **Thin Spoke Pointers**: IDE-specific rules (Cursor, Copilot, etc.) are now lightweight pointers to the central Hub, eliminating duplication and sync errors.
161
+ - **Global CLI Proxy**: Implemented a smart entry point that automatically detects and routes execution to local workspace sources, ensuring zero-latency development.
119
162
 
120
- ### Added
121
-
122
- - **cli:** add update notifier for checking latest npm version
163
+ ### 🧹 Zero-Legacy & Cleanliness
164
+ - **Auto-Purge**: `init` now unconditionally deletes deprecated `.cursorrules` files.
165
+ - **Smart Backups**: Added logic to detect custom user rules and rename files to `.bak` instead of deletion.
166
+ - **Submodule Scrubbing**: Automatically cleans empty submodule directory stubs and scrubs `.gitmodules`.
123
167
 
168
+ ### 🏗️ Branding & Infrastructure
169
+ - **Identity Overhaul**: Rebranded as a "Zero-Latency, High-Signal AI Orchestration Protocol".
170
+ - **Documentation v3**: New high-end 3D visual infographics and overhauled conceptual guides (Architecture, Principles, How-it-works).
171
+ - **Domain Agnostic**: Generalized `bundle/AGENTS.md` to support any technology stack, removing domain-specific hardcoding.
124
172
 
125
- ### Fixed
173
+ ### ⚙️ CLI Enhancements
174
+ - **Proxy Routing**: `bin/deuk-agent-rule.js` performs directory traversal to find local scripts.
175
+ - **Synchronized IO**: Refactored core logic to use synchronous FS operations for rock-solid CLI stability.
126
176
 
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
177
+ ---
153
178
 
154
179
  ## [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.
180
+ - add Codex CLI support (.codexrules) and apply globally
181
+ - implement ticket chaining (--chain) for automated ticket linkage
182
+ - improve submodule isolation logic