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.
- package/CHANGELOG.ko.md +81 -0
- package/CHANGELOG.md +144 -322
- package/README.ko.md +131 -154
- package/README.md +118 -153
- package/docs/architecture.ko.md +34 -0
- package/docs/architecture.md +33 -0
- package/docs/assets/architecture-v3.png +0 -0
- package/docs/how-it-works.ko.md +52 -0
- package/docs/how-it-works.md +71 -0
- package/docs/principles.ko.md +68 -0
- package/docs/principles.md +68 -0
- package/docs/usage-guide.ko.md +139 -0
- package/package.json +37 -7
- package/scripts/cli-args.mjs +87 -3
- package/scripts/cli-init-commands.mjs +1382 -223
- package/scripts/cli-init-logic.mjs +28 -16
- package/scripts/cli-prompts.mjs +13 -4
- package/scripts/cli-rule-compiler.mjs +44 -34
- package/scripts/cli-skill-commands.mjs +172 -0
- package/scripts/cli-telemetry-commands.mjs +429 -0
- package/scripts/cli-ticket-commands.mjs +1934 -161
- package/scripts/cli-ticket-index.mjs +298 -0
- package/scripts/cli-ticket-migration.mjs +320 -0
- package/scripts/cli-ticket-parser.mjs +207 -0
- package/scripts/cli-utils.mjs +381 -59
- package/scripts/cli.mjs +99 -19
- package/scripts/lint-md.mjs +247 -0
- package/scripts/lint-rules.mjs +143 -0
- package/scripts/merge-logic.mjs +13 -324
- package/scripts/plan-parser.mjs +53 -0
- package/templates/MODULE_RULE_TEMPLATE.md +11 -0
- package/templates/PROJECT_RULE.md +47 -0
- package/templates/TICKET_TEMPLATE.ko.md +21 -0
- package/templates/TICKET_TEMPLATE.md +21 -0
- package/templates/rules.d/deukcontext-mcp.md +31 -0
- package/templates/rules.d/platform-coexistence.md +29 -0
- package/templates/skills/context-recall/SKILL.md +25 -0
- package/templates/skills/generated-file-guard/SKILL.md +25 -0
- package/templates/skills/safe-refactor/SKILL.md +25 -0
- package/bundle/.cursorrules +0 -11
- package/bundle/AGENTS.md +0 -146
- package/bundle/gemini.md +0 -26
- package/bundle/rules/delivery-and-parallel-work.mdc +0 -26
- package/bundle/rules/git-commit.mdc +0 -24
- package/bundle/rules/multi-ai-workflow.mdc +0 -104
- package/bundle/rules.d/core-workflow.md +0 -48
- package/bundle/rules.d/deukrag-mcp.md +0 -37
- package/bundle/templates/MODULE_RULE_TEMPLATE.md +0 -24
- package/bundle/templates/TICKET_TEMPLATE.md +0 -58
- package/scripts/cli-ticket-logic.mjs +0 -568
- package/scripts/sync-bundle.mjs +0 -77
- 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
|
-
## [
|
|
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
|
-
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
-
|
|
25
|
-
|
|
26
|
-
|
|
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
|
-
-
|
|
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
|
-
## [
|
|
90
|
+
## [3.3.0] - 2026-05-02
|
|
34
91
|
|
|
35
92
|
### Added
|
|
36
93
|
|
|
37
|
-
-
|
|
38
|
-
|
|
39
|
-
|
|
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
|
-
-
|
|
68
|
-
-
|
|
69
|
-
- **
|
|
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
|
-
- **
|
|
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.
|
|
108
|
+
## [3.2.0] - 2026-04-28
|
|
83
109
|
|
|
84
110
|
|
|
85
111
|
### Added
|
|
86
112
|
|
|
87
|
-
- **
|
|
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
|
-
-
|
|
93
|
-
-
|
|
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
|
|
99
|
-
- **
|
|
100
|
-
-
|
|
101
|
-
-
|
|
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
|
-
## [
|
|
104
|
-
|
|
105
|
-
### Changed
|
|
163
|
+
## [3.0.0] - 2026-04-25
|
|
106
164
|
|
|
107
|
-
|
|
108
|
-
- **
|
|
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
|
-
|
|
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
|
-
###
|
|
113
|
-
|
|
114
|
-
- **
|
|
115
|
-
- **
|
|
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
|
-
|
|
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
|
-
|
|
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
|