deuk-agent-rule 1.0.12 → 1.0.13

package/CHANGELOG.md

@@ -1,9 +1,26 @@
-# Changelog
-
-All notable changes to this project will be documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.13] - 2026-03-28
+
+
+### Fixed
+
+- **deuk-agent-rule:** `printHandoffTip` missing in CLI (handoff tip after `init`)
+
+
+### Changed
+
+- **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)
+
+
 ## [1.0.12] - 2026-03-27
 
 

package/README.ko.md

@@ -6,7 +6,7 @@
 
 **English:** [README.md](https://github.com/joygram/DeukAgentRules/blob/master/README.md)
 
-Cursor, Copilot, Gemini 등 여러 에이전트·도구를 함께 쓸 때를 위한 `AGENTS.md`·`.cursor/rules` 버전 관리형 템플릿. 핸드오프·간결 응답으로 비용·성능을 개선합니다.
+Cursor, GitHub Copilot, Gemini / Antigravity, Claude(Cursor·Claude Code), Windsurf, JetBrains AI Assistant 등 코딩 에이전트와 함께 쓸 `AGENTS.md`·`.cursor/rules` 버전 관리형 템플릿. 그 밖에도 프로젝트 규칙을 읽는 유사 도구에 그대로 활용할 수 있습니다. 핸드오프·간결 응답으로 비용·성능을 개선합니다.
 
 ## 워크스페이스 초기화
 
@@ -15,7 +15,9 @@ npm install deuk-agent-rule
 npx deuk-agent-rule init
 ```
 
-`--non-interactive` 없이 실행하면 짧은 설정 질문이 시작됩니다:
+레포에 **처음** `init` 할 때만(`.deuk-agent-rule.config.json` 없음) **대화형** 질문이 나옵니다. **이후** `npx deuk-agent-rule init` 은 저장된 선택을 쓰고 템플릿만 갱신하므로, 매번 `--non-interactive` 할 필요 없습니다. **CI**에서만 `--non-interactive` 를 쓰면 됩니다. 선택을 바꾸려면 **`--interactive`** 이거나 설정 파일을 지우거나 수정하세요.
+
+첫 `init` 예시:
 
 ```
 $ npx deuk-agent-rule init
@@ -34,8 +36,11 @@ DeukAgentRules init — let's configure your workspace.
   1) Cursor
   2) GitHub Copilot
   3) Gemini / Antigravity
-  4) All of the above
-  5) Other / skip
+  4) Claude (Cursor / Claude Code)
+  5) Windsurf
+  6) JetBrains AI Assistant
+  7) All of the above
+  8) Other / skip
   Choices: 1,2
 
   Stack : unity
@@ -57,16 +62,23 @@ npx deuk-agent-rule init --non-interactive
 
 ```bash
 npm update deuk-agent-rule
-npx deuk-agent-rule init --non-interactive
+npx deuk-agent-rule init
 ```
 
-`AGENTS.md`의 **마커 안**만 갱신되고 바깥 내용은 유지됩니다.
+**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** 절 구조(과제, 수정 파일, 결정, 제약)로 적어 두면, 다음 세션이나 다른 에이전트가 이어 받기 쉽습니다.
+
+**플랜 패널**을 쓰는 환경에서는 동일 본문을 **`.cursor/plans/deuk-handoff.plan.md`** 등으로 **선택적으로 복제**해 둘 수 있습니다. 정본과 내용이 어긋나지 않게 맞추고, 에이전트 동작은 번들된 **`multi-ai-workflow.mdc`** 를 참고하세요.
 
 ### 주요 옵션
 
 | 플래그 | 기본값 | 설명 |
 |--------|--------|------|
-| `--non-interactive` | 끔 | 질문 생략, 플래그 기본값으로 실행 |
+| `--non-interactive` | 끔 | CI/스크립트: 질문 없음·저장 설정 미사용 |
+| `--interactive` | 끔 | `.deuk-agent-rule.config.json` 이 있어도 질문 다시 |
 | `--cwd <path>` | 현재 디렉터리 | 대상 레포 루트 |
 | `--dry-run` | 끔 | 쓰기 없이 동작만 출력 |
 | `--tag <id>` | `deuk-agent-rule` | 마커 id: `<!-- <id>:begin/end -->` |

package/README.md

@@ -6,7 +6,7 @@
 
 **한국어:** [README.ko.md](https://github.com/joygram/DeukAgentRules/blob/master/README.ko.md)
 
-Versioned templates for `AGENTS.md` and `.cursor/rules` for Cursor, Copilot, Gemini and similar agents: shared handoff format, concise execution, stronger cost-efficiency and responsiveness.
+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.
 
 ## Initialize a workspace
 
@@ -15,7 +15,9 @@ npm install deuk-agent-rule
 npx deuk-agent-rule init
 ```
 
-Running `init` without `--non-interactive` starts a short setup flow:
+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.
+
+Running `init` for the first time (example):
 
 ```
 $ npx deuk-agent-rule init
@@ -34,12 +36,15 @@ DeukAgentRules init — let's configure your workspace.
   1) Cursor
   2) GitHub Copilot
   3) Gemini / Antigravity
-  4) All of the above
-  5) Other / skip
+  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, all
+  Tools : cursor, copilot, gemini, claude, windsurf, jetbrains, all, other
 
 AGENTS.md: injected (inject)
 rule copied: .cursor/rules/deuk-agent-rule-multi-ai-workflow.mdc
@@ -57,16 +62,23 @@ After a package upgrade:
 
 ```bash
 npm update deuk-agent-rule
-npx deuk-agent-rule init --non-interactive
+npx deuk-agent-rule init
 ```
 
-Only the **marker region** in `AGENTS.md` is replaced; your text outside stays.
+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)
+
+`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.
+
+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.
 
 ### Key options
 
 | Flag | Default | Description |
 |------|---------|-------------|
-| `--non-interactive` | off | Skip questions; use flag defaults |
+| `--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 -->` |

package/bundle/AGENTS.md

@@ -44,6 +44,9 @@ No editor or vendor tool branding in code, docs, README, commits, or published a
 - **핸드오프 보관**: 채팅만이 아니라 **남겨야 할** 핸드오프는 **내부 구현 문서**에 아래 **Handoff format**과 같은 제목·절 구조의 Markdown으로 기록한다. `deuk-agent-rule init`은 기본으로 **`.deuk-agent-handoff/`** 를 만들고 `.gitignore`에 넣어 로컬 전용으로 둔다. 이 패키지를 **`DeukAgentRules/`** 폴더로 둔 소비 모노레포에서는 **`DeukAgentRules/handoff/LATEST.md`** 에 두는 관례를 쓸 수 있다(해당 `handoff/`는 소비 레포 `.gitignore`에 넣는다). 본문은 **사용자가 대화에 쓰는 언어**로 쓴다(특정 언어를 요청한 경우는 예외).
 - **핸드오프 선확인**: 구현·수정 등 본격 작업 전에 **보관된 핸드오프**를 확인한다. **반드시 경로 문자열을 규칙에 포함해 읽는다:** 존재하면 **`DeukAgentRules/handoff/LATEST.md`**(소비 레포 루트 기준), 그리고 **`.deuk-agent-handoff/`** 및 프로젝트별 내부 경로. 채팅에 붙여 넣은 핸드오프가 있으면 우선한다(사용자가 파일 기준이라고 하면 예외).
 - **핸드오프 파일 링크**: Markdown 링크 `[텍스트](경로)`·백틱 경로·채팅 안내에서 핸드오프 파일을 가리킬 때 **저장소(또는 워크스페이스) 루트 기준 전체 경로**를 쓴다(예: `DeukAgentRules/handoff/LATEST.md`, `project_i/foo/internal/handoff.md`). **`LATEST.md`처럼 파일명만** 단독으로 쓰지 않는다. 모노레포에서는 접두 경로를 생략하지 않는다.
+- **핸드오프 저장 후 채팅**: 파일로 남긴 뒤 채팅에 **`Path: \`루트기준/전체/경로.md\``** 형태로 **한 줄**을 반드시 넣어 다음 세션이 동일 파일을 연다.
+- **핸드오프 파일 머리줄(선택)**: 파일 첫 줄에 `**Handoff (repo-relative):** \`경로\`` 또는 동일 경로의 HTML 주석을 두어 검색·스캔에 쓸 수 있다.
+- **플랜 UI(선택)**: 플랜 전용 패널에 같은 문서를 띄우려면, 관리 중인 **multi-ai-workflow** 규칙에 적힌 **선택적 미러 경로**(예: `.cursor/plans/*.plan.md`)에 동일 본문을 둘 수 있다. 정본은 `.deuk-agent-handoff/` 또는 `DeukAgentRules/handoff/`를 유지하고 두 곳 내용을 맞출 것.
 
 English sections above are canonical for tooling; this block is a short Korean mirror for the same rules.
 
@@ -67,6 +70,12 @@ When handing work between tools or people, use:
 
 When a handoff should **outlive the chat** — for example the user asks to save it, it is the authoritative spec for a follow-up session or another implementer, or the team keeps structured handoffs in-repo — **write it as a Markdown file** under **internal implementation documentation** (implementation notes, not end-user or marketing docs). Prefer **`.deuk-agent-handoff/`** when no project convention exists; if this package lives in **`DeukAgentRules/`** at the consumer repo root, prefer **`DeukAgentRules/handoff/LATEST.md`** (see the next section). Otherwise use an existing convention such as `<product-or-feature>/internal/*.md` or `docs/internal/*.md`. If the user names a path, use it. Reuse the same section structure as **Handoff format** above. If only an inline paste is needed, skip creating a file unless the user asks to save.
 
+**Plan-style UI (optional):** Some editors surface **plan documents** separately from normal Markdown. You may **mirror** the same handoff body into the optional path described in the managed **multi-ai-workflow** rule (e.g. `.cursor/plans/deuk-handoff.plan.md`) while keeping the **canonical** file under **`.deuk-agent-handoff/`** or **`DeukAgentRules/handoff/`**. If both exist, **keep them in sync**.
+
+**After saving (chat):** Include **one dedicated line** with the full repo-root-relative path, e.g. `Path: \`.deuk-agent-handoff/LATEST.md\`` — not only a bare filename inside prose.
+
+**Optional first line in the file:** e.g. `**Handoff (repo-relative):** \`path/from/root.md\`` or the same in an HTML comment on line 1.
+
 **Language:** Write the **body** of persisted handoffs in the **user’s language** — the language they use in the conversation (or their stated preference) — unless they ask for a specific language (for example English-only for an external partner).
 
 **Before substantive work:** Before implementation, fixes, or other non-trivial repo changes, **check persisted handoffs** in the locations above (including **`.deuk-agent-handoff/`** and any project-specific internal paths). **If the file `DeukAgentRules/handoff/LATEST.md` exists** (path relative to the **consumer** repository root — i.e. this rules package lives in a top-level folder named `DeukAgentRules`), **read it** before editing code, in addition to other handoff locations. Read documents that match the current task; a **pasted handoff** in the chat takes precedence unless the user says to follow files instead. Skip this scan only when no locations exist, nothing matches, or the user explicitly says to ignore stored handoffs.
@@ -82,6 +91,6 @@ Add **`DeukAgentRules/handoff/`** to the **consumer** repository’s `.gitignore
 
 **Agent guidance (canonical path strings):** Rules and `AGENTS.md` in the consumer repo should tell agents to open **`DeukAgentRules/handoff/LATEST.md`** when it exists — not only a pasted chat block — so other tools and sessions can resume from the same clone.
 
-**Producing handoffs:** When saving a durable handoff for another agent, write the **Handoff format** body to **`DeukAgentRules/handoff/LATEST.md`** (or a dated file in that folder) and, in chat, include one line: e.g. *Details: `DeukAgentRules/handoff/LATEST.md`* using **repo-relative paths** (no `file://` URLs).
+**Producing handoffs:** When saving a durable handoff for another agent, write the **Handoff format** body to **`DeukAgentRules/handoff/LATEST.md`** (or a dated file in that folder) and, in chat, include **one line** with the full path, e.g. `Path: \`DeukAgentRules/handoff/LATEST.md\`` using **repo-relative paths** (no `file://` URLs).
 
 **Handoff links (full path):** Whenever you **link** or **cite** a persisted handoff file — in **Handoff format** sections, chat, or Markdown — use the **full path from the repository root** (for example `DeukAgentRules/handoff/LATEST.md`, `project_i/_ref_data/deuk_define/reports/REF_DATA_DEUK_TRANSITION.md`). Do **not** use a **bare filename** (`LATEST.md` alone) or an ambiguous partial path. In monorepos, include every prefix segment so the path is unique in the workspace. Markdown: put the full path in the link target, e.g. `[handoff](DeukAgentRules/handoff/LATEST.md)` (repo-relative).

package/bundle/rules/multi-ai-workflow.mdc

@@ -30,8 +30,18 @@ When the user asks to prepare work for another tool:
 1. Output the handoff format with concrete file paths and change descriptions. When linking handoff files (Markdown `[label](path)` or path citations), use the **full path from the repository root** — never a bare filename.
 2. Include any constraints or dependencies.
 3. Do not include editor-specific instructions (token budgets, local rule file paths).
-4. When the handoff must **persist** (user asks to save or document it, or it is the canonical next-step spec), **create or update** a Markdown file under **internal implementation documentation** (see `AGENTS.md`, **Handoff persistence**). Prefer **`DeukAgentRules/handoff/LATEST.md`** when this repo has a top-level **`DeukAgentRules/`** folder; otherwise prefer **`.deuk-agent-handoff/`**; `init` gitignores that directory by default. Use the same handoff template; do not place this in public README/landing unless the project explicitly treats that as its internal log. In chat, include the **full repo-root-relative path** (e.g. `DeukAgentRules/handoff/LATEST.md`, not `LATEST.md` alone) so the next agent opens the file; same for Markdown link targets.
-5. Write persisted handoff **content** in the **user's conversation language** unless they specify another language.
+4. When the handoff must **persist** (user asks to save or document it, or it is the canonical next-step spec), **create or update** a Markdown file under **internal implementation documentation** (see `AGENTS.md`, **Handoff persistence**). Prefer **`DeukAgentRules/handoff/LATEST.md`** when this repo has a top-level **`DeukAgentRules/`** folder; otherwise prefer **`.deuk-agent-handoff/`**; `init` gitignores that directory by default. Use the same handoff template; do not place this in public README/landing unless the project explicitly treats this as its internal log. In Markdown links and backtick citations, use the **full path from the repository root** — never a bare filename.
+5. **After writing a persisted handoff**, in chat include **one dedicated line** with the full repo-root-relative path so the next session can open it unambiguously, for example: `Path: \`.deuk-agent-handoff/LATEST.md\`` (same path you used in the file). Repeat the full path in links elsewhere in the same message if helpful.
+6. **Optional first line inside the persisted file** (improves search and skim): `**Handoff (repo-relative):** \`path/from/repo/root.md\`` or the same path in an HTML comment on line 1.
+7. Write persisted handoff **content** in the **user's conversation language** unless they specify another language.
+
+## Persisted handoff vs plan UI (optional)
+
+Some environments show **plan-style documents** in a separate panel from ordinary Markdown tabs. Behavior varies by product version; when the user wants that experience in **Cursor**, you may **mirror** the same handoff body (Handoff format) under the workspace **`.cursor/plans/`** directory using a **`.plan.md`** suffix, for example `.cursor/plans/deuk-handoff.plan.md` or `.cursor/plans/deuk-handoff-<topic>.plan.md`.
+
+- **Canonical copy** remains **`.deuk-agent-handoff/`** or **`DeukAgentRules/handoff/LATEST.md`** (portable, matches `AGENTS.md`). The `.cursor/plans/` file is an **optional duplicate** for UI only.
+- **Single source of truth:** If both exist, keep their **content in sync**; updating one should update the other in the same turn when possible.
+- **Version control:** Treat `.cursor/plans/` like other local-only handoffs unless the team commits plans on purpose — align with `.gitignore` team policy.
 
 ## Role: Execution
 

package/package.json

@@ -1,12 +1,15 @@
 {
   "name": "deuk-agent-rule",
-  "version": "1.0.12",
+  "version": "1.0.13",
   "description": "DeukAgentRules: generic AGENTS.md + .cursor rule templates with init/merge CLI (npm name: deuk-agent-rule).",
   "keywords": [
     "agents-md",
     "cursor-rules",
     "copilot",
     "gemini",
+    "claude",
+    "windsurf",
+    "jetbrains",
     "handoff",
     "deuk-family",
     "deukpack-ecosystem"

package/scripts/cli.mjs

@@ -18,6 +18,14 @@ const bundleRoot = join(pkgRoot, "bundle");
 const HANDOFF_DIR_NAME = ".deuk-agent-handoff";
 const GITIGNORE_HANDOFF_MARKER = "# deuk-agent-rule: handoff directory (local, not committed by default)";
 
+function printHandoffTip() {
+  console.log(
+    "tip: Persist multi-session specs under " +
+      HANDOFF_DIR_NAME +
+      "/ (see README § Handoffs). Optional: mirror the same body to .cursor/plans/deuk-handoff.plan.md for the Plans panel.",
+  );
+}
+
 function ensureHandoffDirAndGitignore(opts) {
   const handoffPath = join(opts.cwd, HANDOFF_DIR_NAME);
   const gitignorePath = join(opts.cwd, ".gitignore");
@@ -25,6 +33,7 @@ function ensureHandoffDirAndGitignore(opts) {
 
   if (opts.dryRun) {
     console.log("handoff: would mkdir " + HANDOFF_DIR_NAME + "/ and ensure .gitignore ignores it");
+    printHandoffTip();
     return;
   }
 
@@ -40,14 +49,17 @@ function ensureHandoffDirAndGitignore(opts) {
       lines.some((t) => t === HANDOFF_DIR_NAME || t === ignoreLine.replace(/\/$/, ""));
     if (already) {
       console.log(".gitignore: already ignores " + HANDOFF_DIR_NAME);
+      printHandoffTip();
       return;
     }
     const block = "\n" + GITIGNORE_HANDOFF_MARKER + "\n" + ignoreLine + "\n";
     appendFileSync(gitignorePath, block, "utf8");
     console.log(".gitignore: appended " + ignoreLine.trim());
+    printHandoffTip();
   } else {
     writeFileSync(gitignorePath, GITIGNORE_HANDOFF_MARKER + "\n" + ignoreLine + "\n", "utf8");
     console.log(".gitignore: created with " + ignoreLine.trim());
+    printHandoffTip();
   }
 }
 
@@ -96,14 +108,56 @@ const STACKS = [
   { label: "Other / skip", value: "other" },
 ];
 
+/** Survey only today; merge/init does not branch on these yet (future tool-specific templates). */
 const AGENT_TOOLS = [
   { label: "Cursor", value: "cursor" },
   { label: "GitHub Copilot", value: "copilot" },
   { label: "Gemini / Antigravity", value: "gemini" },
+  { label: "Claude (Cursor / Claude Code)", value: "claude" },
+  { label: "Windsurf", value: "windsurf" },
+  { label: "JetBrains AI Assistant", value: "jetbrains" },
   { label: "All of the above", value: "all" },
   { label: "Other / skip", value: "other" },
 ];
 
+/** Written after first interactive init; reused on later inits unless --interactive or schema mismatch. */
+const INIT_CONFIG_VERSION = 1;
+const INIT_CONFIG_FILENAME = ".deuk-agent-rule.config.json";
+
+function loadInitConfig(cwd) {
+  const p = join(cwd, INIT_CONFIG_FILENAME);
+  if (!existsSync(p)) return null;
+  try {
+    const j = JSON.parse(readFileSync(p, "utf8"));
+    if (j.version !== INIT_CONFIG_VERSION) return null;
+    const allowedStack = new Set(STACKS.map((s) => s.value));
+    if (!allowedStack.has(j.stack)) return null;
+    const allowedTools = new Set(AGENT_TOOLS.map((t) => t.value));
+    if (!Array.isArray(j.agentTools) || !j.agentTools.every((t) => allowedTools.has(t))) return null;
+    if (!["inject", "skip", "overwrite"].includes(j.agentsMode)) return null;
+    return {
+      stack: j.stack,
+      agentTools: j.agentTools,
+      agentsMode: j.agentsMode,
+    };
+  } catch {
+    return null;
+  }
+}
+
+function writeInitConfig(cwd, opts) {
+  const p = join(cwd, INIT_CONFIG_FILENAME);
+  const body = {
+    version: INIT_CONFIG_VERSION,
+    stack: opts.stack,
+    agentTools: opts.agentTools,
+    agentsMode: opts.agents ?? "inject",
+    updatedAt: new Date().toISOString(),
+  };
+  writeFileSync(p, JSON.stringify(body, null, 2) + "\n", "utf8");
+  console.log("saved: " + INIT_CONFIG_FILENAME);
+}
+
 async function runInteractive(opts) {
   const rl = createInterface({ input: process.stdin, output: process.stdout });
   try {
@@ -157,7 +211,8 @@ Usage:
 Options:
   --cwd <path>          Target repo root (default: current directory)
   --dry-run             Print actions; do not write files
-  --non-interactive     Skip questions; use defaults/flags directly
+  --non-interactive     CI/scripts: no prompts; use --agents/--rules (no saved config read)
+  --interactive         Ask questions even if .deuk-agent-rule.config.json exists
   --tag <id>            Marker id (default: deuk-agent-rule)
   --agents <mode>       inject | skip | overwrite
   --rules <mode>        prefix | skip | overwrite
@@ -166,6 +221,7 @@ Options:
   --marker-begin / --marker-end  Custom marker strings (both required)
 
 init also creates .deuk-agent-handoff/ and appends it to .gitignore (local handoffs).
+After npm update, run init again: deuk-agent-rule-*.mdc rules refresh from the bundle (no separate merge needed).
 
 Korean: package README.ko.md
 `,
@@ -184,6 +240,7 @@ function parseArgs(argv) {
     rules: undefined,
     appendIfNoMarkers: false,
     nonInteractive: false,
+    interactive: false,
   };
   for (let i = 0; i < argv.length; i++) {
     const a = argv[i];
@@ -193,6 +250,7 @@ function parseArgs(argv) {
     } else if (a === "--dry-run") out.dryRun = true;
     else if (a === "--backup") out.backup = true;
     else if (a === "--non-interactive") out.nonInteractive = true;
+    else if (a === "--interactive") out.interactive = true;
     else if (a === "--tag") {
       out.tag = argv[++i];
       if (out.tag == null) throw new Error("--tag requires a value");
@@ -348,7 +406,23 @@ async function main() {
   try {
     if (sub === "init") {
       if (!isNonInteractive(opts)) {
-        await runInteractive(opts);
+        const saved = loadInitConfig(opts.cwd);
+        if (saved && !opts.interactive) {
+          opts.agents = opts.agents !== undefined ? opts.agents : saved.agentsMode;
+          opts.stack = saved.stack;
+          opts.agentTools = saved.agentTools;
+          const stackL = STACKS.find((s) => s.value === saved.stack)?.label || saved.stack;
+          console.log("\nDeukAgentRules init — using saved choices from " + INIT_CONFIG_FILENAME);
+          console.log("  Stack : " + saved.stack + " (" + stackL + ")");
+          console.log("  Tools : " + (saved.agentTools.join(", ") || "none"));
+          console.log("  AGENTS: " + opts.agents);
+          console.log("  (`--interactive` to change, or edit/delete " + INIT_CONFIG_FILENAME + ")\n");
+        } else {
+          await runInteractive(opts);
+          if (!opts.dryRun) {
+            writeInitConfig(opts.cwd, opts);
+          }
+        }
       }
       runInit(opts);
     } else if (sub === "merge") {

package/scripts/merge-logic.mjs

@@ -168,15 +168,7 @@ export function applyRules(opts) {
 
     if (rulesMode === "prefix" && existsSync(destPath)) {
       destPath = join(targetRulesDir, filePrefix + name);
-      if (existsSync(destPath)) {
-        actions.push({
-          action: "skip",
-          src,
-          dest: destPath,
-          reason: "prefixed target also exists",
-        });
-        continue;
-      }
+      // If prefixed file exists (repeat init after npm update), overwrite from bundle — do not skip.
     }
 
     if (dryRun) {