duaer-spec 0.1.0 → 0.1.1

package/.cursor/rules/duaer-spec.mdc

@@ -5,14 +5,15 @@ alwaysApply: true
 
 # Duaer required (NON-NEGOTIABLE)
 
-See repo `DUADER.md` and `.duaer/memory/constitution.md`.
+Treat agents as digital employees: assign a Brief (Spec) before code; accept
+only via converge. See `DUADER.md` and `.duaer/memory/constitution.md`.
 
 If this rule conflicts with root `AGENTS.md` / `docs/agent/` (worktrees, commits,
 Issue/PR), **AGENTS.md wins**.
 
 ## When Duaer is mandatory
 
-Always write/update a feature spec before coding for:
+Always write/update a feature spec (Brief) before coding for:
 
 - New features / user-visible behavior
 - Architecture or contract changes

package/ADOPT.md

@@ -1,22 +1,21 @@
 # Adopt duaer-spec
 
-Install the **Duaer** methodology and agent-ops contract into another
-repository.
+Onboard a **digital employee** into another repository: install the Duaer
+delivery OS (method) and the agent-ops contract (how they are allowed to work).
 
 ## Recommended: CLI
 
 From the target project (Node 18+):
 
 ```bash
-# GitHub pin
-npx github:fujiezee/duaer-spec@v0.1.0 duaer init --here
-
-# npm (after publish)
 npx duaer-spec init --here
 
-# method only / ops only / other integration branch
-npx github:fujiezee/duaer-spec@v0.1.0 duaer init --here --method
-npx github:fujiezee/duaer-spec@v0.1.0 duaer init --here --ops --branch develop
+# Pin a release
+npx github:fujiezee/duaer-spec@v0.1.1 duaer init --here
+
+# Lite (method only) / ops only / other integration branch
+npx duaer-spec init --here --method
+npx duaer-spec init --here --ops --branch develop
 ```
 
 From a clone of this repo:
@@ -30,9 +29,11 @@ node bin/duaer.mjs check /path/to/project
 
 Then:
 
-1. Edit `.duaer/memory/constitution.md` and `project-context.md` for the product
-2. Confirm `docs/baseline.md` (integration branch)
-3. Use `/duaer-specify` → `/duaer-plan` → `/duaer-tasks` → `/duaer-implement` → `/duaer-converge`
+1. **Orient** — edit `.duaer/memory/constitution.md` and `project-context.md`
+2. **Confirm workplace** — `docs/baseline.md` (integration branch)
+3. **Assign → work → accept** — `/duaer-specify` → `/duaer-plan` → `/duaer-tasks` → `/duaer-implement` → `/duaer-converge`
+
+A job without Spec is not assigned. A change that fails converge is not accepted.
 
 ## Manual copy (optional)
 
@@ -59,7 +60,7 @@ cp DUADER.md /path/to/project/
 
 ## Precedence
 
-1. `AGENTS.md` / agent-ops — how agents operate  
+1. `AGENTS.md` / agent-ops — how employees operate  
 2. `DUADER.md` / `.duaer/` — what to build  
 3. Product overlays (do not copy `examples/` blindly)
 

package/AGENTS.md

@@ -3,8 +3,10 @@
 Mandatory rules for AI coding agents working in **duaer-spec**, and for any
 repository that adopts this file as its agent-ops contract.
 
-This file is authoritative for *how* agents operate. If Duaer (`.duaer/`,
-`DUADER.md`), `examples/`, or other overlays conflict with this file,
+Treat agents as **digital employees**: this file is the workplace policy for
+*how* they may operate (isolation, commits, Issue/PR gates). Duaer
+([`DUADER.md`](DUADER.md)) is how jobs are briefed and accepted. If Duaer
+(`.duaer/`), `examples/`, or other overlays conflict with this file,
 **follow this file**.
 
 See also: [workflow](docs/agent/workflow.md) · [change checklist](docs/agent/change-checklist.md) · [ADOPT](ADOPT.md)

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 0.1.1 — 2026-09-15
+
+### Docs / product identity
+
+- Position Duaer as a **delivery OS for AI digital employees**: hire → assign
+  (Spec) → work → accept (converge)
+- README, ADOPT, DUADER, AGENTS intro, and CLI `init` / `check` / help copy
+  use that language
+- E2E catalog: E2E-001 (init next steps), E2E-002 (README positioning)
+
 ## 0.1.0 — 2026-09-15
 
 First public methodology release.

package/DUADER.md

@@ -1,7 +1,10 @@
 # Duaer methodology
 
-**duaer-spec** owns this method. Artifacts live under `.duaer/`; Cursor skills
-are `duaer-*` at `.cursor/skills/`.
+**duaer-spec** owns this method. Treat AI coding agents as **digital employees**:
+you assign a Brief (Spec), they follow a fixed work order, and delivery only
+counts after **converge** accepts the result against that Brief.
+
+Artifacts live under `.duaer/`; Cursor skills are `duaer-*` at `.cursor/skills/`.
 
 **Precedence:** root [`AGENTS.md`](AGENTS.md) / [`docs/agent/`](docs/agent/) win
 over anything here for isolation, commits, and Issue/PR gates.
@@ -18,24 +21,24 @@ over anything here for isolation, commits, and Issue/PR gates.
 **Full (recommended):**
 
 1. `/duaer-constitution` — only when principles change
-2. `/duaer-specify` — what / why / acceptance (not stack trivia)
+2. `/duaer-specify` — **Assign**: what / why / acceptance (not stack trivia)
 3. `/duaer-clarify` — optional
 4. `/duaer-plan` — technical plan aligned with project-context
 5. `/duaer-checklist` — optional quality checklist
 6. `/duaer-tasks` — checkbox task breakdown
 7. `/duaer-analyze` — optional consistency check
 8. `/duaer-implement` — implement tasks only
-9. `/duaer-converge` — compare result to spec; append remaining tasks if gaps
+9. `/duaer-converge` — **Accept**: compare result to Spec; append remaining tasks if gaps
 
 **Small feature:** specify → plan → tasks → implement → converge  
 
 **Hotfix:** specify (mark hotfix) → tasks → implement → converge  
-Never skip specify or converge.
+Never skip specify (assign) or converge (accept).
 
 ## Install
 
 ```bash
-npx github:fujiezee/duaer-spec duaer init --here
+npx duaer-spec init --here
 ```
 
 Or see [`ADOPT.md`](ADOPT.md). No third-party Spec CLI is required — `duaer`
@@ -45,7 +48,7 @@ installs this repository's method files into the target project.
 
 ```text
 .duaer/specs/<nnn-slug>/
-  spec.md
+  spec.md      # Brief
   plan.md      # after /duaer-plan
   tasks.md     # after /duaer-tasks
   …            # research / contracts as needed

package/README.md

@@ -1,39 +1,52 @@
 # duaer-spec
 
-**Duaer** is a Spec-Driven Development methodology for AI coding agents
-(Cursor first), plus enforceable **agent ops** for isolation, commits, and
-Issue/PR gates.
+**Duaer** is a delivery operating system for AI coding agents treated as
+**digital employees**.
 
-Not a wrapper around another toolkit. The method, directories, skills, and rules
-in this repository **are** duaer-spec.
+Agents write the code. Duaer makes the **handoff controllable**: every job has a
+Brief (Spec), follows a fixed work order, and only counts as done after
+acceptance — not after a lucky chat.
 
-## Install into a project
+Cursor is the labor. Duaer is hire → assign → accept.
 
-```bash
-# GitHub (available now)
-npx github:fujiezee/duaer-spec@v0.1.0 duaer init --here
+## Install (onboard the employee)
 
-# npm (after the package is published)
+```bash
 npx duaer-spec init --here
+# or pin: npx github:fujiezee/duaer-spec@v0.1.1 duaer init --here
 ```
 
 ```bash
-# method only / ops only / other integration branch
-npx github:fujiezee/duaer-spec duaer init --here --method
-npx github:fujiezee/duaer-spec duaer init --here --ops --branch develop
+# Lite: method only (personal / small changes)
+npx duaer-spec init --here --method
+
+# Full ops on another integration branch
+npx duaer-spec init --here --ops --branch develop
 ```
 
-Verify: `npx github:fujiezee/duaer-spec duaer check .`  
+Verify: `npx duaer-spec check .`  
 Details: [`ADOPT.md`](ADOPT.md)
 
+## How you run them
+
+| Step | Meaning | Command |
+|---|---|---|
+| **Hire** | Install SOP + gates into the repo | `duaer init` |
+| **Assign** | Write the Brief (what / why / acceptance) | `/duaer-specify` |
+| **Work** | Plan, break down, implement | `/duaer-plan` → `/duaer-tasks` → `/duaer-implement` |
+| **Accept** | Compare result to Spec; gaps become more work | `/duaer-converge` + `duaer check` |
+
+Never skip **Assign** or **Accept**. Hotfix may shorten the middle; Spec and
+converge stay.
+
 ## Two layers
 
 | Layer | Role | Where |
 |---|---|---|
-| **Agent ops** | How agents operate | [`AGENTS.md`](AGENTS.md), [`docs/agent/`](docs/agent/) |
+| **Agent ops** | How the employee is allowed to operate | [`AGENTS.md`](AGENTS.md), [`docs/agent/`](docs/agent/) |
 | **Duaer method** | What to build (Spec → Plan → Tasks → Implement → Converge) | [`DUADER.md`](DUADER.md), [`.duaer/`](.duaer/), [`.cursor/skills/`](.cursor/skills/) |
 
-When they conflict, **agent ops win**.
+When they conflict, **agent ops win** — process beats improvisation.
 
 ## Default loop
 
@@ -52,14 +65,15 @@ Slash skills: `/duaer-specify`, `/duaer-plan`, `/duaer-tasks`, `/duaer-implement
 ```text
 bin/duaer.mjs             CLI (duaer init | check | version)
 package.json              npm package metadata
-AGENTS.md                 Agent-ops contract
-DUADER.md                 Methodology conventions
-ADOPT.md                  Install guide
+AGENTS.md                 Agent-ops contract (how employees operate)
+DUADER.md                 Methodology conventions (how work is briefed)
+ADOPT.md                  Onboarding guide
 .duaer/                   Memory, templates, workflows, scripts
 .cursor/rules/            Agent-ops + Duaer rules
 .cursor/skills/           duaer-* skills
 docs/agent/               Workflow detail + checklists
 docs/maintaining.md       How maintainers evolve the method
+docs/npm-trusted-publishing.md  npm Trusted Publishing (OIDC) setup
 examples/                 Optional product overlays (not defaults)
 ```
 

package/bin/duaer.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 /**
- * duaer — CLI for the duaer-spec methodology
+ * duaer — CLI for the duaer-spec delivery OS (digital employees)
  *
  *   duaer init [dir] [--all|--method|--ops] [--force] [--branch <name>]
  *   duaer check [dir]
@@ -24,23 +24,26 @@ const __dirname = dirname(fileURLToPath(import.meta.url))
 const PKG_ROOT = resolve(__dirname, '..')
 const PKG = JSON.parse(readFileSync(join(PKG_ROOT, 'package.json'), 'utf8'))
 
-const USAGE = `duaer — Duaer methodology installer (duaer-spec ${PKG.version})
+const USAGE = `duaer — Delivery OS for AI digital employees (duaer-spec ${PKG.version})
+
+Hire agents into a repo, assign Briefs (Specs), accept only when converge passes.
 
 Usage:
-  duaer init [dir] [options]   Install Duaer into a project
-  duaer check [dir]            Verify install shape
+  duaer init [dir] [options]   Hire / onboard into a project
+  duaer check [dir]            Verify install (workplace ready)
   duaer version                Print version
   duaer help                   Show this help
 
 Init options:
-  --all          Agent ops + method (default)
-  --method       Method only (.duaer, skills, DUADER.md, duaer-spec rule)
-  --ops          Agent ops only (AGENTS.md, docs/agent, ops rules)
+  --all          Full hire: agent ops + method (default)
+  --method       Lite: method only (.duaer, skills, DUADER.md, duaer-spec rule)
+  --ops          Ops only (AGENTS.md, docs/agent, ops rules)
   --force        Overwrite existing managed files
   --branch <n>   Integration branch for baseline note (default: main)
   --here         Same as dir=.
 
 Examples:
+  npx duaer-spec init --here
   npx github:fujiezee/duaer-spec duaer init --here
   node bin/duaer.mjs init ../my-app --all
   duaer check .
@@ -218,14 +221,17 @@ function cmdInit(opts) {
   }
 
   console.log(`
-Done.
+Hired.
 
-Next:
-  1. Edit .duaer/memory/constitution.md and project-context.md for this product
-  2. Confirm docs/baseline.md (integration branch: ${opts.branch})
-  3. In Cursor, use /duaer-specify → /duaer-plan → /duaer-tasks → /duaer-implement → /duaer-converge
-  4. Agent ops: AGENTS.md wins over DUADER.md when they conflict
+Next (digital employee loop):
+  1. Orient  — edit .duaer/memory/constitution.md and project-context.md
+  2. Workplace — confirm docs/baseline.md (integration branch: ${opts.branch})
+  3. Assign  — /duaer-specify  (Brief: what / why / acceptance)
+  4. Work    — /duaer-plan → /duaer-tasks → /duaer-implement
+  5. Accept  — /duaer-converge  (gaps are not done; append tasks)
+  6. Gates   — AGENTS.md wins over DUADER.md when they conflict
 
+No Spec = not assigned. Failed converge = not accepted.
 See DUADER.md and AGENTS.md in the target project.
 `)
 }
@@ -252,7 +258,7 @@ function cmdCheck(dir) {
     console.log(`\n${missing} missing — run: duaer init ${dir} --all`)
     process.exitCode = 1
   } else {
-    console.log('\nInstall looks complete.')
+    console.log('\nWorkplace ready — assign with /duaer-specify, accept with /duaer-converge.')
   }
 }
 

package/docs/agent/README.md

@@ -1,7 +1,7 @@
 # Agent workflow (duaer-spec)
 
-Authoritative docs for *how* agents operate. Wins over Duaer and `examples/`
-when they conflict.
+Authoritative docs for *how* digital employees operate (workplace policy).
+Wins over Duaer and `examples/` when they conflict.
 
 | Doc | Description |
 |---|---|

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

@@ -20,9 +20,13 @@ Status:      planned | automated | manual
 
 ## Catalog
 
+This repository’s own product surface (CLI + docs). Adopters replace or extend
+the table for their app.
+
 | ID | Title | Status |
 |---|---|---|
-| — | *(replace with project scenarios)* | — |
+| E2E-001 | After `duaer init`, CLI prints hire → assign → accept next steps | manual |
+| E2E-002 | README positions Duaer as delivery OS for digital employees | manual |
 
 ## Traceability
 
@@ -30,4 +34,5 @@ Keep this matrix current when scenarios or specs change.
 
 | Scenario | Spec / feature | Notes |
 |---|---|---|
-| — | — | — |
+| E2E-001 | `bin/duaer.mjs` init banner | Controllable-delivery onboarding |
+| E2E-002 | `README.md` / `ADOPT.md` | Product identity |

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "duaer-spec",
-  "version": "0.1.0",
-  "description": "Duaer Spec-Driven Development methodology + agent ops for AI coding agents",
+  "version": "0.1.1",
+  "description": "Delivery OS for AI digital employees: Spec briefs, agent ops, controllable handoffs",
   "type": "module",
   "bin": {
     "duaer": "bin/duaer.mjs",
@@ -36,11 +36,13 @@
   "homepage": "https://github.com/fujiezee/duaer-spec#readme",
   "keywords": [
     "duaer",
+    "digital-employee",
+    "delivery-os",
     "spec-driven",
     "agents",
     "cursor",
     "ai-engineering",
-    "methodology"
+    "controllable-delivery"
   ],
   "license": "MIT",
   "scripts": {