deuk-agent-rule 1.0.13 → 2.2.0

package/CHANGELOG.md

@@ -4,86 +4,133 @@ 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).
 
-## [1.0.13] - 2026-03-28
+## [2.2.0] - 2026-04-06
 
+### Added
+- cli: support implementation_plan.md and Plan headers during migration
+- rules: enforce mandatory English-only rules in publish directory
+- rules: implement Hard Rule for no Markdown word emphasis (Plain Text only)
+- rules: move ticket file path marker to the bottom of the document
 
-### Fixed
+## [2.1.0] - 2026-04-05
 
-- **deuk-agent-rule:** `printHandoffTip` missing in CLI (handoff tip after `init`)
+### Added
+- cli: add ticket close status logic and verify workflow phase
+- cli: print actual title instead of topic slug in ticket list
+- rules: add pre-report self-review phase to definitive workflow
+- rules: enforce priority ticket creation and add /ticket slash command
 
+### Fixed
+- cli: exclude TICKET_LIST logic files from ticket auto-recovery scan
+- cli: replace broken auto-recovery fallback with physical file sync logic
 
 ### Changed
+- architecture: add how-it-works guide for CLI operating principles
+- enforce mandatory post-test artifact risk analysis workflow
+- readme: add npm and github status badges to header
+- readme: enhance docs with definitive 5-phase workflow and richer prompt usage examples
+- readme: prioritize prompt-driven workflow and adopt neutral metrics
+- readme: simplify workflow section with 6-phase table and sample scenario
+- system: add interactive system and stack selection guide
+- workflow: add Korean workflow user guide tutorial
 
-- **docs:** README § Handoffs; GitHub About text; npm keywords; CLI survey adds Claude, Windsurf, JetBrains AI Assistant
-- **agents:** optional `.cursor/plans/*.plan.md` mirror for plan-style UI; chat `Path:` line and optional first-line path in handoff files
-- **deuk-agent-rule:** `init` prints a short handoff tip after ensuring `.deuk-agent-handoff/`
-- **deuk-agent-rule:** default `--rules prefix` overwrites existing `deuk-agent-rule-*.mdc` on repeat `init` (package updates without a separate `merge`)
-- **deuk-agent-rule:** `.deuk-agent-rule.config.json` stores interactive choices; later `init` reuses them (`--interactive` to change; `--non-interactive` for CI only)
+## [2.0.0] - 2026-04-05
 
+### Added
+- ci: GitHub Release on main for chore(release); simplify public RELEASING
+- cli: extend merge tooling and sync publish docs
+- cli: tag .cursorrules inject/remove and sync template from publish
+- deuk-agent-rule: automated changelog, bump tooling
+- deuk-agent-rule: handoff gitignore, pre-work handoff scan, AGENTS inject newline
+- deuk-agent-rule: keep a changelog templates without commit links
+- forbid 'sync' word in commit titles in agent rules
+- handoff: add indexed handoff workflow and CLI
+- workflow: introduce Ticket-First Workflow and Multi-AI Handoff architecture
 
-## [1.0.12] - 2026-03-27
+### Fixed
+- ci: run release workflow on master; document GitHub is not auto-synced from gplat
+- templates: remove workspace-specific paths from default global rules
 
+### Changed
+- absolute links for npm page
+- agents: DeukAgentRules/handoff/LATEST.md handoff path for consumer repos
+- agents: require full repo-root paths for handoff file links
+- Deuk Family tagline, npm keywords, GitHub Topics note
+- migrate handoff to ticket terminology
+- public-facing RELEASING and changelog wording; sync-bundle comment
+- README updates; delivery-and-parallel-work rule; CLI and publish AGENTS updates
 
-### Fixed
+## [1.1.0] - 2026-04-05
+
+### Added
+- deuk-agent-rule: Modular CLI architecture (ESM native).
+- deuk-agent-rule: Recursive directory path resolution for robust ticket discovery.
+- deuk-agent-rule: Strict marker casing validation to prevent duplicate injected blocks.
 
-- **ci:** run release workflow on master; document GitHub is not auto-synced from gplat
+### Changed
+- docs: Transitioned to minimalist DeukPack styling for README.
+- deuk-agent-rule: Generalized project detection from hardcoded strings to dynamic metadata (Project: prefix).
+- deuk-agent-rule: CLI flags now rigorously override saved config values (Config Inheritance).
+- deuk-agent-rule: ticket list and ticket use gracefully fail if system is uninitialized.
 
+## [1.0.13] - 2026-03-28
+### Fixed
+- deuk-agent-rule: printTicketTip missing in CLI (ticket tip after init)
 
 ### Changed
+- docs: README § Tickets; GitHub About text; npm keywords; CLI survey adds Claude, Windsurf, JetBrains AI Assistant
+- agents: optional .cursor/plans/*.plan.md mirror for plan-style UI; chat Path: line and optional first-line path in ticket files
+- deuk-agent-rule: init prints a short ticket tip after ensuring .deuk-agent-ticket/
+- deuk-agent-rule: default --rules prefix overwrites existing deuk-agent-rule-*.mdc on repeat init (package updates without a separate merge)
+- deuk-agent-rule: .deuk-agent-rule.config.json stores interactive choices; later init reuses them (--interactive to change; --non-interactive for CI only)
 
-- **agents:** require full repo-root paths for handoff file links
+## [1.0.12] - 2026-03-27
 
-## [1.0.11] - 2026-03-26
+### Fixed
+- ci: release workflow runs on pushes to master
 
+### Changed
+- agents: require full repo-root paths for ticket file links
 
-### Added
+## [1.0.11] - 2026-03-26
 
-- **ci:** GitHub Release on main for chore(release); simplify public RELEASING
+### Added
+- ci: GitHub Release workflow for version tags and chore(release): commits on main / master
 
 ## [1.0.10] - 2026-03-26
 
-
 ### Added
-
-- **deuk-agent-rule:** keep a changelog templates without commit links
+- deuk-agent-rule: changelog template headers without per-commit links
 
 ## [1.0.9] - 2026-03-27
 
 ### Added
-
-- **deuk-agent-rule:** automated changelog and release tooling
-- **deuk-agent-rule:** handoff gitignore, pre-work handoff scan, AGENTS inject newline
+- deuk-agent-rule: release changelog tooling; ticket directory gitignore; pre-work ticket scan; AGENTS inject newline fix
 
 ### Changed
-
-- **agents:** DeukAgentRules/handoff/LATEST.md handoff path for consumer repos
+- agents: DeukAgentRules/ticket/LATEST.md ticket path for consumer repos
 
 ## [1.0.8] - 2026-03-27
 
 ### Added
-
-- This changelog and npm `files` entry so releases are traceable.
+- This changelog and npm files entry so releases are traceable.
 
 ## [1.0.7] - 2026-03-27
 
 ### Added
-
-- `init`: create `.deuk-agent-handoff/` and append `.gitignore` rules for local handoffs.
-- CLI: pre-work handoff scan; `publish/AGENTS.md` and `multi-ai-workflow.mdc` updates.
+- init: create .deuk-agent-ticket/ and append .gitignore rules for local tickets.
+- CLI: pre-work ticket scan; publish/AGENTS.md and multi-ai-workflow.mdc updates.
 
 ### Fixed
-
 - AGENTS tagged-region merge: trailing newline after injected blocks.
 
 ## [1.0.5] - 2026-03-26
 
 ### Changed
-
 - README and package metadata (Deuk Family tagline, npm keywords, GitHub Topics note).
 
 ## [1.0.4] - 2026-03-26
 
 ### Changed
-
-- Release packaging includes `package-lock.json` for reproducible installs.
+- Release packaging includes package-lock.json for reproducible installs.
 - README: absolute links for the npm package page.

package/README.ko.md

@@ -1,106 +1,125 @@
-# DeukAgentRules (득에이전트룰스)
+<div align="center">
+  <br />
+  <h1>DeukAgentRules (득에이전트룰스)</h1>
+  <p>규칙 표준화 엔진</p>
+  <p><a href="https://deukpack.app">Deuk Family</a> 생태계의 핵심 에이전트 인프라</p>
+</div>
 
-> **Deuk Family**의 핵심 모듈 가운데 하나입니다. 구조화된 규칙으로 AI 에이전트의 협업과 응답을 다듬습니다.
+<div align="center">
+  <a href="https://www.npmjs.com/package/deuk-agent-rule"><img src="https://img.shields.io/npm/v/deuk-agent-rule.svg?color=black&style=flat-square" alt="NPM Version" /></a>
+  <a href="https://www.npmjs.com/package/deuk-agent-rule"><img src="https://img.shields.io/npm/dm/deuk-agent-rule.svg?color=blue&style=flat-square" alt="NPM Downloads" /></a>
+  <a href="https://github.com/joygram/DeukAgentRules"><img src="https://img.shields.io/github/stars/joygram/DeukAgentRules.svg?style=flat-square&color=orange" alt="GitHub Stars" /></a>
+  <a href="https://github.com/joygram/DeukAgentRules/blob/master/LICENSE"><img src="https://img.shields.io/npm/l/deuk-agent-rule.svg?style=flat-square" alt="License" /></a>
+  <br /><br />
+  <a href="https://github.com/joygram/DeukAgentRules/blob/master/README.md">English</a>
+</div>
 
-**npm 패키지:** `deuk-agent-rule` · **CLI:** `deuk-agent-rule`
+***
 
-**English:** [README.md](https://github.com/joygram/DeukAgentRules/blob/master/README.md)
+## Abstract
 
-Cursor, GitHub Copilot, Gemini / Antigravity, Claude(Cursor·Claude Code), Windsurf, JetBrains AI Assistant 등 코딩 에이전트와 함께 쓸 `AGENTS.md`·`.cursor/rules` 버전 관리형 템플릿. 그 밖에도 프로젝트 규칙을 읽는 유사 도구에 그대로 활용할 수 있습니다. 핸드오프·간결 응답으로 비용·성능을 개선합니다.
+DeukAgentRules는 AI 엔지니어링 에이전트(Cursor, GitHub Copilot, Gemini/Antigravity, Claude, Windsurf, JetBrains AI 등)를 위한 프로젝트 불가지론적(Agnostic) 규칙 아키텍처를 정의합니다. 지속적인 워크플로 메모리를 세션 컨텍스트와 분리하여, 세션당 반복되는 프롬프트 부하를 감소시킵니다.
 
-## 워크스페이스 초기화
+> 왜 DeukAgentRules인가?
+> 티켓 기반 워크플로(Ticket-First)는 반복되는 컨텍스트 부하를 세션당 단일 토픽 파일 하나로 축소하고, 저장소를 재설명하지 않고도 도구 간 핸드오버를 가능하게 합니다.
+
+---
+
+## 빠른 시작
+
+명령어 한 줄로 규칙 시스템을 초기화하고 로컬 워크스페이스를 구성하세요:
 
 ```bash
-npm install deuk-agent-rule
 npx deuk-agent-rule init
 ```
 
-레포에 **처음** `init` 할 때만(`.deuk-agent-rule.config.json` 없음) **대화형** 질문이 나옵니다. **이후** `npx deuk-agent-rule init` 은 저장된 선택을 쓰고 템플릿만 갱신하므로, 매번 `--non-interactive` 할 필요 없습니다. **CI**에서만 `--non-interactive` 를 쓰면 됩니다. 선택을 바꾸려면 **`--interactive`** 이거나 설정 파일을 지우거나 수정하세요.
+- 대화형 설정: 최초 실행 시 CLI가 주요 기술 스택과 사용하는 AI 에이전트를 선택하도록 안내합니다. (각 스택별 세부 지원 항목은 시스템 및 스택 선택 가이드를 참조하세요).
+- 안전한 업데이트: 이후 실행 시 기존 커스텀 설정을 건드리지 않고 필요한 템플릿만 안전하게 주입(Append)합니다. 설정을 변경하려면 --interactive 옵션을 사용하세요.
+
+---
+
+## 티켓 기반 워크플로 (Ticket-First Workflow)
 
-첫 `init` 예시:
+다수의 AI 에이전트가 단일 마크다운 티켓을 통해 컨텍스트를 공유하는 구조입니다.
 
+### 6단계 워크플로
+
+| 단계 | 담당 | 역할 |
+|---|---|---|
+| 1. 탐색 & 계획 | 추론 AI | 코드베이스 분석, 구현 계획 수립 |
+| 2. 결정 | 사용자 | 계획 검토 및 승인 |
+| 3. 티켓 발행 (등록) | 추론 AI | 승인된 계획을 .deuk-agent-ticket/ 에 저장 |
+| 4. 실행 | IDE 에이전트 | 티켓만 읽고 범위 내에서 코딩 |
+| 5. 리스크 분석 (자체검증) | IDE 에이전트 | 테스트 완료 후 빌드 산출물 자체의 결함 및 잠재 리스크 필수 분석 |
+| 6. 보고 & 종결 | 사용자+에이전트 | 리포트 검토 후 npx deuk-agent-rule ticket close --latest |
+
+---
+
+### 상세 워크플로 가이드
+
+1단계: 탐색 및 계획 수립
 ```
-$ npx deuk-agent-rule init
-
-DeukAgentRules init — let's configure your workspace.
-
-? What is your primary tech stack?
-  1) Unity / C#
-  2) Next.js + C#
-  3) Web (React / Vue / general)
-  4) Java / Spring Boot
-  5) Other / skip
-  Choice [1-5]: 1
-
-? Which agent tools do you use? (comma-separated numbers, or 'all')
-  1) Cursor
-  2) GitHub Copilot
-  3) Gemini / Antigravity
-  4) Claude (Cursor / Claude Code)
-  5) Windsurf
-  6) JetBrains AI Assistant
-  7) All of the above
-  8) Other / skip
-  Choices: 1,2
-
-  Stack : unity
-  Tools : cursor, copilot
-
-AGENTS.md: injected (inject)
-rule copied: .cursor/rules/deuk-agent-rule-multi-ai-workflow.mdc
-rule copied: .cursor/rules/deuk-agent-rule-delivery-and-parallel-work.mdc
-rule copied: .cursor/rules/deuk-agent-rule-git-commit.mdc
+[User]   "분석 저장소모듈"
+[Agent]  (코드베이스 분석 후 방향 제안)
+[User]   "계획 해당 분석내용을 진행할 계획 및 설계"
+[Agent]  (.deuk-agent-ticket/main/storage-20260406.md 에 티켓 저장)
 ```
 
-CI나 스크립트 환경에서 질문 없이 실행:
-
-```bash
-npx deuk-agent-rule init --non-interactive
+2단계: 실행 및 자체 검증
+```
+[User]   "진행 (생략 시 최신 분석 내용 진행)"
+[Agent]  (티켓을 읽고 코드 변경 후 자체 검토 보고)
+[User]   "검증 이슈 및 결함, 잠재오류"
+[Agent]  (티켓 제약 사항 준수 검토 및 결함 탐색 완료)
 ```
 
-패키지 업데이트 후:
+---
 
-```bash
-npm update deuk-agent-rule
-npx deuk-agent-rule init
-```
+### 키워드 프롬프트 예시 (채팅창 입력)
 
-**CI·헤드리스**에서만 `init --non-interactive` 를 쓰면 됩니다. 일반 업그레이드에 **`merge`를 따로 돌릴 필요는 없습니다.** 기본 **`init`** 이 번들 **`.cursor/rules`** 를 다시 맞춥니다. `--rules prefix`(기본)일 때 이미 있는 **`deuk-agent-rule-*.mdc`** 는 새 패키지 내용으로 **덮어씁니다.** 접두 없이 둔 로컬 전용 룰 파일은 건드리지 않습니다. `AGENTS.md`는 **마커 안**만 갱신되고 바깥 내용은 유지됩니다.
+반복되는 타이핑과 검색 피로도를 줄이기 위해 아래와 같은 키워드 기반의 단문을 권장해요.
 
-### 핸드오프 (멀티 세션·도구 넘김)
+| 상황 | 입력 프롬프트 |
+|---|---|
+| 분석 | 분석 [주제/모듈] |
+| 계획 | 계획 해당 분석내용을 진행할 계획 및 설계 |
+| 진행 | 진행 [티켓번호] (생략 시 최신 진행) |
+| 검증 | 검증 이슈 및 결함, 잠재오류 |
+| 조회 | /티켓 |
 
-`init` 시 **`.deuk-agent-handoff/`** 를 만들고 기본으로 **`.gitignore`** 에 넣습니다. 채팅만이 아니라 **파일로 남겨야 할** 작업 명세는 여기(또는 `DeukAgentRules/handoff/LATEST.md` 관례)에 `AGENTS.md`의 **Handoff format** 절 구조(과제, 수정 파일, 결정, 제약)로 적어 두면, 다음 세션이나 다른 에이전트가 이어 받기 쉽습니다.
+---
+
+### CLI 레퍼런스 (선택 사항)
+
+```bash
+npx deuk-agent-rule ticket create --topic login-api --project MyProject --content "## Task: ..."
+npx deuk-agent-rule ticket list
+npx deuk-agent-rule ticket close --latest
+```
 
-**플랜 패널**을 쓰는 환경에서는 동일 본문을 **`.cursor/plans/deuk-handoff.plan.md`** 등으로 **선택적으로 복제**해 둘 수 있습니다. 정본과 내용이 어긋나지 않게 맞추고, 에이전트 동작은 번들된 **`multi-ai-workflow.mdc`** 를 참고하세요.
+(티켓 튜토리얼: docs/ticket-tutorial.ko.md 참조)
 
-### 주요 옵션
 
-| 플래그 | 기본값 | 설명 |
-|--------|--------|------|
-| `--non-interactive` | 끔 | CI/스크립트: 질문 없음·저장 설정 미사용 |
-| `--interactive` | 끔 | `.deuk-agent-rule.config.json` 이 있어도 질문 다시 |
-| `--cwd <path>` | 현재 디렉터리 | 대상 레포 루트 |
-| `--dry-run` | 끔 | 쓰기 없이 동작만 출력 |
-| `--tag <id>` | `deuk-agent-rule` | 마커 id: `<!-- <id>:begin/end -->` |
-| `--agents <mode>` | `inject` | `inject` \| `skip` \| `overwrite` |
-| `--rules <mode>` | `prefix` | `prefix` \| `skip` \| `overwrite` |
-| `--backup` | 끔 | 덮어쓰기 전 `*.bak` 저장 |
 
-### 번들 규칙
+---
 
-- **`multi-ai-workflow.mdc`** — `alwaysApply: true`
-- **`delivery-and-parallel-work.mdc`** — `alwaysApply: true` (세로 슬라이스·포트폴리오 우선·병렬 소유·리팩터 범위 축소)
-- **`git-commit.mdc`** — `alwaysApply: false`
+## 아키텍처 및 설정 (How It Works)
 
-### `merge` (엄격)
+CLI는 CI 환경과 명시적 제어를 위한 매개변수를 지원하며, 기존 로컬 설정과 충돌하지 않는 주입(Injection) 방식을 사용합니다. 
+자세한 기술 구현 아키텍처와 덮어쓰기 방어 로직은 동작 원리 가이드를 참조하세요.
 
-옵션 동일. 마커가 없으면 inject 실패(`--append-if-no-markers` 없을 때). 기본 `--rules skip`.
+### 핵심 매개변수 (Core Configuration)
 
-### 주의
+| 옵션 | 용도 |
+|------|---------|
+| --non-interactive | CI/Headless 모드 (질의응답 없이 기본값/저장된 설정 즉시 적용) |
+| --tag <id> | 기본 마커 영역(<!-- <id>:begin/end -->)을 사용자 정의 ID로 오버라이드 |
+| --agents inject | 기존 AGENTS.md에 지능형 마커 주입 (또는 skip, overwrite) |
+| --rules prefix | 지능형 파일 접두사를 활용하여 .cursor/rules 모듈 업데이트 |
 
-- `alwaysApply: true` 규칙이 겹치면 컨텍스트가 커질 수 있습니다.
-- `postinstall`에서 `init` 자동 실행은 권장하지 않습니다.
+---
 
-## 버전
+## 라이선스 & 생태계
 
-배포 전 `package.json`의 `version` 상향.
+이 패키지는 DeukPack Ecosystem의 일부로 구동되며, Apache-2.0 라이선스 하에 배포됩니다.
+이슈 제보, 컨트리뷰션 및 커뮤니티 논의는 GitHub Repository (https://github.com/joygram/DeukAgentRules)를 방문해 주세요.

package/README.md

@@ -1,106 +1,123 @@
-# DeukAgentRules
+<div align="center">
+  <br />
+  <h1>DeukAgentRules</h1>
+  <p>High-Signal Encoding & Rule Standardization Engine</p>
+  <p>Part of the <a href="https://deukpack.app">Deuk Family</a> ecosystem.</p>
+</div>
 
-> **Part of the Deuk Family** — Empowering AI Agents with structured rules.
+<div align="center">
+  <a href="https://www.npmjs.com/package/deuk-agent-rule"><img src="https://img.shields.io/npm/v/deuk-agent-rule.svg?color=black&style=flat-square" alt="NPM Version" /></a>
+  <a href="https://www.npmjs.com/package/deuk-agent-rule"><img src="https://img.shields.io/npm/dm/deuk-agent-rule.svg?color=blue&style=flat-square" alt="NPM Downloads" /></a>
+  <a href="https://github.com/joygram/DeukAgentRules"><img src="https://img.shields.io/github/stars/joygram/DeukAgentRules.svg?style=flat-square&color=orange" alt="GitHub Stars" /></a>
+  <a href="https://github.com/joygram/DeukAgentRules/blob/master/LICENSE"><img src="https://img.shields.io/npm/l/deuk-agent-rule.svg?style=flat-square" alt="License" /></a>
+  <br /><br />
+  <a href="https://github.com/joygram/DeukAgentRules/blob/master/README.ko.md">한국어 (Korean)</a>
+</div>
 
-**npm package:** `deuk-agent-rule` · **CLI:** `deuk-agent-rule`
+***
 
-**한국어:** [README.ko.md](https://github.com/joygram/DeukAgentRules/blob/master/README.ko.md)
+## Abstract
 
-Versioned templates for `AGENTS.md` and `.cursor/rules` for Cursor, GitHub Copilot, Gemini / Antigravity, Claude (via Cursor or Claude Code), Windsurf, JetBrains AI Assistant, and other coding agents that read project rules: shared handoff format, concise execution, stronger cost-efficiency and responsiveness.
+DeukAgentRules defines a project-agnostic rule architecture for AI engineering agents (Cursor, GitHub Copilot, Gemini/Antigravity, Claude, Windsurf, JetBrains AI). It separates persistent workflow memory from session context, reducing recurring prompt loads per session.
 
-## Initialize a workspace
+> Why DeukAgentRules?
+> The Ticket-First Workflow reduces recurring context loads into a single focused topic file per session, enabling handovers between different AI tools without re-explaining the repository.
+
+---
+
+## Quick Start
+
+Initialize the rule system and set up the local workspace in one step:
 
 ```bash
-npm install deuk-agent-rule
 npx deuk-agent-rule init
 ```
 
-On the **first** `init` in a repo (no `.deuk-agent-rule.config.json`), a short **interactive** setup runs. **Later** `npx deuk-agent-rule init` reuses those choices and only applies template updates — no need for `--non-interactive` unless you are in **CI**. Use **`--interactive`** to change answers, or delete/edit the config file.
+- Interactive Setup: On the first run, the CLI guides you to select your primary stack and the AI agents you use. (See the System Selection Guide for a detailed list of available stacks and tools). 
+- Safe Updates: Subsequent runs safely append necessary templates without touching your custom extensions. Use --interactive to reconfigure.
+
+---
+
+## The Ticket-First Workflow
+
+Multiple AI agents share context through a single Markdown ticket, reducing per-session prompt overhead.
+
+### The 6-Phase Workflow
+
+| Phase | Actor | Action |
+|---|---|---|
+| 1. Explore & Plan | Reasoning AI | Analyze codebase, propose implementation plan |
+| 2. Decide | User | Review and approve the plan |
+| 3. Ticket (Registration) | Reasoning AI | Write approved plan to .deuk-agent-ticket/ |
+| 4. Execute | IDE Agent | Read ticket, code strictly within scope |
+| 5. Post-Test Risk Analysis | IDE Agent | Mandatory artifact risk analysis after testing |
+| 6. Report & Close | User + Agent | Review risk report, then npx deuk-agent-rule ticket close --latest |
+
+---
 
-Running `init` for the first time (example):
+### Detailed Workflow Walkthrough
 
+Phase 1: Explore & Plan
 ```
-$ npx deuk-agent-rule init
-
-DeukAgentRules init — let's configure your workspace.
-
-? What is your primary tech stack?
-  1) Unity / C#
-  2) Next.js + C#
-  3) Web (React / Vue / general)
-  4) Java / Spring Boot
-  5) Other / skip
-  Choice [1-5]: 3
-
-? Which agent tools do you use? (comma-separated numbers, or 'all')
-  1) Cursor
-  2) GitHub Copilot
-  3) Gemini / Antigravity
-  4) Claude (Cursor / Claude Code)
-  5) Windsurf
-  6) JetBrains AI Assistant
-  7) All of the above
-  8) Other / skip
-  Choices: all
-
-  Stack : web
-  Tools : cursor, copilot, gemini, claude, windsurf, jetbrains, all, other
-
-AGENTS.md: injected (inject)
-rule copied: .cursor/rules/deuk-agent-rule-multi-ai-workflow.mdc
-rule copied: .cursor/rules/deuk-agent-rule-delivery-and-parallel-work.mdc
-rule copied: .cursor/rules/deuk-agent-rule-git-commit.mdc
+[User]   "Analyze storage module"
+[Agent]  (Analyzes codebase, proposes direction)
+[User]   "Plan and design for the analyzed content."
+[Agent]  (Saves ticket to .deuk-agent-ticket/main/storage-20260406.md)
 ```
 
-To skip questions (CI or scripted use):
-
-```bash
-npx deuk-agent-rule init --non-interactive
+Phase 2: Execution & Verification
+```
+[User]   "Proceed" (or "Proceed with [Ticket #]")
+[Agent]  (Reads the ticket, implements changes, self-checks, and reports)
+[User]   "Verify issues, defects, and potential errors."
+[Agent]  (Runs tests, confirms compliance and finds defects)
 ```
 
-After a package upgrade:
+---
 
-```bash
-npm update deuk-agent-rule
-npx deuk-agent-rule init
-```
+### Keyword-Based Prompt Examples
+
+| Intent | Keyword Input |
+|---|---|
+| Analysis | Analyze [Topic/Module] |
+| Plan | Plan and design for the analyzed content. |
+| Proceed | Proceed [Ticket #] (or latest if omitted) |
+| Verify | Verify issues, defects, and potential errors. |
+| Check | /ticket |
 
-Use `init --non-interactive` only in **CI** or headless scripts. You do **not** need a separate `merge` for routine upgrades: **`init` refreshes** the bundled `.cursor/rules` files. With default `--rules prefix`, existing **`deuk-agent-rule-*.mdc`** copies are **overwritten** from the new package so template fixes reach your repo. Unprefixed rule files you keep for local overrides are not touched. Only the **marker region** in `AGENTS.md` is replaced; your text outside stays.
+---
 
-### Handoffs (multi-session and tool handover)
+### CLI Reference (Optional)
 
-`init` creates **`.deuk-agent-handoff/`** (and adds it to **`.gitignore`** by default) so you can **persist** structured specs beyond a single chat. Use the same sections as in `AGENTS.md` (**Handoff format**): task title, files to modify, decisions, constraints. That lets the next session or another tool pick up where you left off without re-explaining the repo.
+```bash
+npx deuk-agent-rule ticket create --topic login-api --project MyProject --content "## Task: ..."
+npx deuk-agent-rule ticket list
+npx deuk-agent-rule ticket close --latest
+```
 
-Optionally, if you use an editor with a **Plans** panel, mirror the same Markdown body under **`.cursor/plans/deuk-handoff.plan.md`** (or `deuk-handoff-<topic>.plan.md`) so it appears there; keep it in sync with the canonical file under `.deuk-agent-handoff/` or `DeukAgentRules/handoff/LATEST.md`. See the bundled **`multi-ai-workflow.mdc`** rule for agent-side details.
+(Ticket Tutorial: docs/ticket-tutorial.md)
 
-### Key options
 
-| Flag | Default | Description |
-|------|---------|-------------|
-| `--non-interactive` | off | CI/scripts: no prompts; no saved-config path |
-| `--interactive` | off | Force the setup questions even if `.deuk-agent-rule.config.json` exists |
-| `--cwd <path>` | current directory | Target repo root |
-| `--dry-run` | off | Print actions without writing |
-| `--tag <id>` | `deuk-agent-rule` | Marker id: `<!-- <id>:begin/end -->` |
-| `--agents <mode>` | `inject` | `inject` \| `skip` \| `overwrite` |
-| `--rules <mode>` | `prefix` | `prefix` \| `skip` \| `overwrite` |
-| `--backup` | off | Write `*.bak` before overwrite |
 
-### Bundled rules
+---
 
-- **`multi-ai-workflow.mdc`** — `alwaysApply: true`
-- **`delivery-and-parallel-work.mdc`** — `alwaysApply: true` (vertical slices, portfolio priority, parallel ownership, scoped refactors)
-- **`git-commit.mdc`** — `alwaysApply: false`
+## Architecture & Configuration (How It Works)
 
-### `merge` (stricter)
+The CLI supports advanced parameters for CI environments and explicit structural control, utilizing a non-destructive injection mechanism to avoid user conflicts. 
+For a detailed technical overview of how we safely sandbox injected rules, see the How It Works Guide (docs/how-it-works.md).
 
-Same flags; `AGENTS.md` inject fails without markers unless `--append-if-no-markers`. Default `--rules skip`.
+### Core Configuration
 
-### Caveats
+| Flag | Purpose |
+|------|---------|
+| --non-interactive | CI/Headless mode; applies defaults/saved config without prompting |
+| --tag <id> | Overrides the default marker region (<!-- <id>:begin -->) |
+| --agents inject | Smart injection into existing AGENTS.md (or skip, overwrite) |
+| --rules prefix | Updates .cursor/rules via intelligent file prefixing |
 
-- Multiple `alwaysApply: true` rules all apply — trim duplicates if context grows too large.
-- Do **not** run `init` from `postinstall` without an explicit team decision.
+---
 
-## Versioning
+## License & Ecosystem
 
-Bump `version` in `package.json` before publishing.
+Part of the DeukPack Ecosystem. Licensed under Apache-2.0.
+For issues, contributions, and community discussions, visit the GitHub Repository (https://github.com/joygram/DeukAgentRules).

package/bundle/.cursorrules

@@ -0,0 +1,7 @@
+# Cursor — AGENTS.md is authoritative
+
+You MUST read and strictly follow the workflows, rules, and ticket formats defined in AGENTS.md at the repository root before writing or modifying any code. If AGENTS.md is not yet in your context for this task, open it and use it.
+
+Precedence: Repository root AGENTS.md defines project rules (structure, constraints, tickets). .cursor/rules/*.mdc files add editor-specific behavior (for example token discipline and multi-tool handoff). If anything conflicts, follow AGENTS.md for project facts and tickets.
+
+Do not assume stacks or repo layouts (microservices, api-gateway, OpenAPI-only workflows) unless they appear in this repository and AGENTS.md.