duaer-spec 0.6.2 → 0.6.3

package/ADOPT.md

@@ -12,10 +12,15 @@ npx duaer-spec init --here
 npx duaer-spec update
 ```
 
-That’s it. If you customized local files, glance at `git diff` once.
+Do **not** use `init --here --force` as the everyday refresh. `update` reuses
+the mode/branch from `.duaer/duaer-init.json`.
+
+If you customized constitution / baseline / `.duaer/handoff.json` commands,
+glance at `git diff` once and keep your overrides.
 
 Ensure the repo has **`main`** and **`develop`**. See
-[`docs/agent/branching-and-release.md`](docs/agent/branching-and-release.md).
+[`docs/agent/branching-and-release.md`](docs/agent/branching-and-release.md)
+(Chinese: [`README.zh-CN.md`](README.zh-CN.md)).
 
 Then talk to the agent in plain language.
 

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.6.3 — 2026-09-15
+
+### Docs: update path in installed 说明
+
+- `DUADER.md` and `docs/agent/branching-and-release.md` document `npx duaer-spec update`
+- Add `README.zh-CN.md` (install / update / branches)
+- ADOPT clarifies: do not use `init --force` for everyday refresh
+
 ## 0.6.2 — 2026-09-15
 
 ### Simple update

package/DUADER.md

@@ -7,9 +7,10 @@ runs Brief → work → accept. Humans are not the operators of the phase machin
 
 ## Human experience
 
-1. One-time: `npx duaer-spec init --here`  
-2. Ongoing: describe work in chat  
-3. Review the handoff line (accepted / not yet)
+1. One-time install: `npx duaer-spec init --here`  
+2. Later refresh: `npx duaer-spec update`  
+3. Ongoing: describe work in chat  
+4. Review the handoff line (accepted / not yet)
 
 ## Agent procedure (autonomous)
 
@@ -42,4 +43,5 @@ Humans need not configure it for everyday use.
 ## Related
 
 - Adopt: [`ADOPT.md`](ADOPT.md)
+- Branches / go-live: [`docs/agent/branching-and-release.md`](docs/agent/branching-and-release.md)
 - Agent ops: [`AGENTS.md`](AGENTS.md)

package/README.md

@@ -21,6 +21,8 @@ npx duaer-spec update
 
 Then use Cursor as usual — describe what you want.
 
+中文说明：[`README.zh-CN.md`](README.zh-CN.md)
+
 ## What the employee does (by itself)
 
 1. Writes a Brief (Spec) for the ask  

package/README.zh-CN.md

@@ -0,0 +1,34 @@
+# duaer-spec
+
+**Duaer** 把 AI 编程助手变成**数字员工**：你用自然语言提需求，它自己跑 Spec → 实现 → 验收；只有交接干净才算完成。
+
+你**不用**操作流程。装一次之后，说话即可。
+
+## 安装
+
+```bash
+npx duaer-spec init --here
+```
+
+## 更新
+
+```bash
+npx duaer-spec update
+```
+
+若你改过本地 constitution / baseline / `handoff.json` 命令，看一眼 `git diff` 即可。
+
+## 必须有的分支
+
+| 分支 | 作用 |
+|---|---|
+| `main` | 生产 / 正式上线 |
+| `develop` | 日常集成、联调 |
+| `feat/<name>` | 功能 → 合进 `develop` |
+| `fix/<name>` | 缺陷 → 合进 `develop`（紧急从 `main` 出，再回补 `develop`） |
+
+不同问题怎么上线：[`docs/agent/branching-and-release.md`](docs/agent/branching-and-release.md)
+
+合并后：`duaer handoff [--run]` 在 `develop` 上重启本地服务（命令写在 `.duaer/handoff.json`）。
+
+英文源：[`README.md`](README.md) · 采纳细节：[`ADOPT.md`](ADOPT.md)

package/docs/agent/README.md

@@ -10,4 +10,6 @@ Wins over Duaer and `examples/` when they conflict.
 | [change-checklist.md](change-checklist.md) | Finish checklist |
 | [e2e-test-plan.md](e2e-test-plan.md) | E2E scenario catalog template |
 
-Root contract: [`AGENTS.md`](../../AGENTS.md). Adoption: [`ADOPT.md`](../../ADOPT.md).
+Root contract: [`AGENTS.md`](../../AGENTS.md).  
+Adoption: [`ADOPT.md`](../../ADOPT.md) — `npx duaer-spec init --here` / `npx duaer-spec update`.  
+Chinese summary: [`README.zh-CN.md`](../../README.zh-CN.md).

package/docs/agent/branching-and-release.md

@@ -199,9 +199,20 @@ All implementation edits happen inside the request worktree.
 
 ---
 
+## 7. Install and update (adopters)
+
+```bash
+npx duaer-spec init --here     # once
+npx duaer-spec update          # later refresh — no --force recipe
+```
+
+Details: [`ADOPT.md`](../../ADOPT.md). Chinese summary: [`README.zh-CN.md`](../../README.zh-CN.md).
+
 ## Related
 
 - [workflow.md](workflow.md) — R4 and development loop  
 - [change-checklist.md](change-checklist.md) — finish checklist  
 - [baseline.md](../baseline.md) — frozen: `develop` + `main`  
-- [ADOPT.md](../../ADOPT.md) — install into another repo  
+- [ADOPT.md](../../ADOPT.md) — install / update into another repo  
+- [README.zh-CN.md](../../README.zh-CN.md) — Chinese install, update, branches  
+

package/docs/agent/e2e-test-plan.md

@@ -35,6 +35,8 @@ the table for their app.
 | E2E-008 | Docs require main+develop+feat+fix and typed go-live flows | manual |
 | E2E-009 | After merge, handoff restarts services on develop (`duaer handoff`) | manual |
 | E2E-010 | `npx duaer-spec update` refreshes an existing install | manual |
+| E2E-011 | Installed docs (`DUADER.md`, `docs/agent/`) document `update` | manual |
+| E2E-012 | `README.zh-CN.md` covers install, update, branch model | manual |
 
 ## Traceability
 
@@ -50,3 +52,5 @@ the table for their app.
 | E2E-008 | `branching-and-release.md` | Branch + release matrix |
 | E2E-009 | `.duaer/handoff.json` / `duaer handoff` | Service handoff |
 | E2E-010 | `duaer update` | One-line refresh |
+| E2E-011 | DUADER + agent docs | Update path in installed 说明 |
+| E2E-012 | `README.zh-CN.md` | Chinese 说明文档 |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "duaer-spec",
-  "version": "0.6.2",
+  "version": "0.6.3",
   "description": "Digital employees: autonomous delivery; main/develop/feat/fix; simple update",
   "type": "module",
   "bin": {
@@ -18,7 +18,8 @@
     "docs/agent",
     "docs/baseline.md",
     "LICENSE",
-    "README.md"
+    "README.md",
+    "README.zh-CN.md"
   ],
   "publishConfig": {
     "access": "public"