duaer-spec 0.23.0 → 0.23.1

package/.duaer/active-job.json

@@ -1,4 +1,4 @@
 {
-  "feature": "210-release-023",
-  "specDir": ".duaer/specs/210-release-023"
+  "feature": "212-release-0231",
+  "specDir": ".duaer/specs/212-release-0231"
 }

package/.duaer/specs/210-release-023/delivery.json

@@ -0,0 +1,10 @@
+{
+  "status": "accepted",
+  "acceptedAt": "2026-09-19T13:20:00.000Z",
+  "verification": {
+    "levels": ["L0", "L1"],
+    "commands": ["npm test (173 pass)", "gh release v0.23.0", "npm view duaer-spec version → 0.23.0"],
+    "result": "pass"
+  },
+  "summary": "Released 0.23.0 to GitHub and npm (employee directory, picker, arch fullscreen, orch deadlock)."
+}

package/.duaer/specs/210-release-023/tasks.md

@@ -1,6 +1,6 @@
 # Tasks
 
-- [ ] T001 Bump package.json to 0.23.0 and move CHANGELOG Unreleased
-- [ ] T002 Merge release branch to develop
-- [ ] T003 Promote develop → main, push, tag, gh release, npm
-- [ ] T004 Stamp delivery accepted
+- [x] T001 Bump package.json to 0.23.0 and move CHANGELOG Unreleased
+- [x] T002 Merge release branch to develop
+- [x] T003 Promote develop → main, push, tag, gh release, npm
+- [x] T004 Stamp delivery accepted

package/.duaer/specs/211-plain-features/delivery.json

@@ -0,0 +1,10 @@
+{
+  "status": "accepted",
+  "acceptedAt": "2026-09-19T13:30:00.000Z",
+  "verification": {
+    "levels": ["L0"],
+    "commands": ["rg -n '我们有什么|What you get' README.zh-CN.md README.md"],
+    "result": "pass"
+  },
+  "summary": "READMEs list product capabilities in plain language (editor employee + live desk)."
+}

package/.duaer/specs/211-plain-features/spec.md

@@ -0,0 +1,12 @@
+# Spec: Plain-language feature overview in READMEs
+
+## Goal
+
+Add a human-readable “what you get” feature list to `README.zh-CN.md` and
+`README.md` so readers see capabilities without jargon-first flow dumps.
+
+## Acceptance
+
+- [ ] Chinese README has a 人话「我们有什么」section covering desk + employee core
+- [ ] English README has a matching plain-language “What you get” section
+- [ ] No CJK in English README; Chinese README may keep English product terms

package/.duaer/specs/211-plain-features/tasks.md

@@ -0,0 +1,5 @@
+# Tasks
+
+- [x] T001 Add 人话 feature section to README.zh-CN.md
+- [x] T002 Add matching plain section to README.md
+- [x] T003 CHANGELOG + stamp accepted

package/.duaer/specs/212-release-0231/spec.md

@@ -0,0 +1,12 @@
+# 212 — Release 0.23.1
+
+## Goal
+
+Ship 0.23.1: plain-language README feature overview. Bump, CHANGELOG,
+promote develop → main, push, GitHub Release, npm Trusted Publishing.
+
+## Acceptance
+
+1. `package.json` is `0.23.1`; CHANGELOG has `0.23.1` (Unreleased cleared).
+2. Tag `v0.23.1` on main; GitHub Release published.
+3. npm shows `duaer-spec@0.23.1`.

package/.duaer/specs/212-release-0231/tasks.md

@@ -0,0 +1,5 @@
+# Tasks
+
+- [ ] T001 Bump to 0.23.1 and move CHANGELOG
+- [ ] T002 Merge to develop; promote main; push; tag; gh release; npm
+- [ ] T003 Stamp accepted

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 ## Unreleased
 
+## 0.23.1 — 2026-09-19
+
+### Docs: plain-language feature overview in READMEs
+
+- Chinese「我们有什么」and English「What you get」list desk + employee capabilities
+  without jargon-first flow dumps
+
 ## 0.23.0 — 2026-09-19
 
 ### Fix: orchestration wave release no longer deadlocks on silent wait

package/README.md

@@ -45,6 +45,40 @@ Install writes host adapters for each (see [`ADOPT.md`](ADOPT.md)).
 
 Chinese guide: [`README.zh-CN.md`](README.zh-CN.md)
 
+## What you get (plain language)
+
+After install, these are the capabilities you actually use:
+
+### In your editor: a digital employee that delivers
+
+- **You talk; it runs the process.** No slash commands, no “you must run Spec phases.”
+- **Clarify before coding.** It turns your ask into: what to build, what not to build, how we know it’s done.
+- **Done means accepted.** It only claims finished when acceptance checks out — not when code merely exists.
+- **Works in many hosts.** Cursor, Claude Code, Codex, Copilot, Windsurf, Cline, Continue, Gemini, Aider.
+
+### In the browser: Duaer-spec FDE (live desk)
+
+A local web desk (`duaer live`) for “chat → confirm → dispatch → watch → open result”:
+
+- **Projects.** Create and switch projects; each keeps its own chat and progress.
+- **Chat until the ask is clear.** Left chat; center confirm cards (goal / out of scope / checkable acceptance). Vague acceptance cannot be confirmed.
+- **Split big work into modules.** Confirm module by module; nothing starts until you kick off after the ones you care about are confirmed.
+- **Architecture diagram.** After requirements, review the system diagram; click it for fullscreen; kickoff waits until architecture is confirmed.
+- **Dispatch digital employees to code.** Pick a product folder and Cursor Agent or Claude Code; work happens in an isolated worktree, not directly on your long-lived branches.
+- **Visible task progress.** Work is a checklist; each finished item is checked off and the desk refreshes; dependent tasks release in waves so agents don’t pile on blocked work.
+- **Employee roles.** Top-bar **digital employee** directory: Implementer builds features; Functional regression verifies against acceptance and testing rules. Optional parallel workers on the same CLI.
+- **zh-CN / en / ja UI.** Desk copy follows the language you pick.
+- **Deliverables and results.** Open a deliverables page (requirements, architecture, tasks, delivery); when done, open the page or the project folder.
+- **Revise when it’s not right.** Continue in left chat → re-confirm → relaunch on the same job without starting from scratch.
+- **Hosting when you need it.** Cloudflare / Alibaba Cloud / AWS / GitHub Pages; default is GitHub Actions when unset.
+
+### Repo habits (for humans and employees)
+
+- **Clear branches:** `main` for production, `develop` for day-to-day, short `feat`/`fix` branches merge back to `develop`.
+- **Isolated changes:** each request uses its own worktree; after merge, clean up and hand local services back to the primary checkout.
+
+The sections below are **how to run it**; this section is **what it can do**.
+
 ## What the employee does (by itself)
 
 1. Turns your ask into a Brief with **checkable acceptance**  

package/README.zh-CN.md

@@ -12,6 +12,40 @@
 
 `init` / `update` 会写入各宿主适配文件（详见 [`ADOPT.md`](ADOPT.md)）。
 
+## 我们有什么（人话）
+
+装好之后，你主要用到的是这些能力：
+
+### 在编辑器里：数字员工帮你干活
+
+- **你说人话，它自己跑流程。** 不用记 slash 命令、不用自己点「写 Spec / 拆任务」。
+- **先谈清楚再动手。** 它会把你的想法整理成：要做什么、不做什么、怎样算做完。
+- **做完才算完。** 对照验收通过才会说「交付好了」；半成品不会假装完成。
+- **多宿主可用。** Cursor、Claude Code、Codex、Copilot、Windsurf、Cline、Continue、Gemini、Aider 都行。
+
+### 在浏览器里：Duaer-spec FDE（现场台面）
+
+本机开一个网页台面（`duaer live`），专门管「从聊需求到派工、看进度、看结果」：
+
+- **项目管理。** 建项目、切换项目；每个项目自己的对话和进度，互不搅在一起。
+- **聊着把需求聊清楚。** 左边聊天；中间把目标、边界、验收写成确认卡；空话验收过不了，得能检查才给确认。
+- **大需求可拆成多个模块。** 一块一块确认，确认完一块不会立刻开工，全部谈妥再一起派。
+- **系统架构图。** 确认需求后一起看架构；点图可全屏查看；架构确认后才能派工。
+- **一键派数字员工写代码。** 选产品目录、选 Cursor Agent 或 Claude Code，点开工；它在隔离目录里改代码，不直接乱动你的主分支。
+- **任务进度看得见。** 任务拆成一条条可勾选项；做完勾一项，台面实时刷新；有依赖的任务会排队放行，不会一窝蜂乱做。
+- **数字员工分工。** 顶部有「数字员工」目录：实现员工负责写功能，功能回归负责按验收和测试规则验；可开多个并行（同一套 CLI）。
+- **中 / 英 / 日界面。** 台面文案可切换语种。
+- **看交付物和结果。** 可打开交付物页（需求、架构、任务、交付记录）；做完了可打开页面或项目文件夹。
+- **不满意就继续改。** 左侧继续聊改进 → 再确认 → 同一次任务上续派，不用从头建仓。
+- **要上线时可选托管。** Cloudflare / 阿里云 / AWS / GitHub Pages；没选时默认走 GitHub Actions。
+
+### 仓库规矩（给协作和数字员工用）
+
+- **分支分清楚：** `main` 上线、`develop` 日常、功能/修 bug 用短分支，做完合回 `develop`。
+- **隔离改动：** 每次任务在独立 worktree 里做，做完合并、清理，本地服务交回主目录。
+
+下面「安装 / 更新 / FDE 流程」是怎么用；上面这一节是**能干什么**。
+
 ## 安装
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "duaer-spec",
-  "version": "0.23.0",
+  "version": "0.23.1",
   "description": "Norms → satisfactory delivery: digital employees for Cursor, Claude, Codex, Copilot, Windsurf, Cline, Continue, Gemini, Aider",
   "type": "module",
   "bin": {