duaer-spec 0.6.4 → 0.8.0

package/.claude/rules/agents-workflow.md

@@ -0,0 +1,62 @@
+<!-- duaer-spec agent ops (develop+main, feat/fix, .worktree, push opt-in) -->
+
+# Agent development workflow
+
+Part of **duaer-spec**. Authoritative over Duaer when they conflict.
+
+## Required branches
+
+| Branch | Role |
+|---|---|
+| `main` | Production / online |
+| `develop` | Day-to-day integration |
+| `feat/<name>` | Feature → merge to `develop` |
+| `fix/<name>` | Bugfix → `develop` (hotfix: from `main` → `main` then `develop`) |
+
+Detail: `docs/agent/branching-and-release.md`.
+
+## Isolated development (mandatory worktree)
+
+Before editing files for a new request:
+
+1. Update local **`develop`** (hotfix: **`main`**)
+2. Create `feat/<name>` or `fix/<name>`
+3. Create worktree at **`.worktree/feat-<name>`** or **`.worktree/fix-<name>`**
+   (slash → hyphen). Do **not** reuse the Brief folder name
+   (`.duaer/specs/<nnn-slug>/`) as the worktree id.
+4. Develop only inside that worktree
+5. Never develop on `main` / `develop` or in the primary checkout
+6. Never reuse another agent's branch/worktree
+7. Never commit `.worktree/`
+
+```bash
+mkdir -p .worktree
+git worktree add .worktree/feat-login -b feat/login develop
+cd .worktree/feat-login
+# Brief lives inside the checkout, e.g. .duaer/specs/002-login/
+```
+
+## Immutable habits
+
+- Spec-sync for behavior changes; ADR when architecture/security/contracts change
+- One logical change per commit; leave the worktree clean
+- User/protocol-visible changes update E2E scenario docs
+- Merge into **`develop`** when done (hotfix: **`main`**, then back-merge **`develop`**)
+- **Handoff (mandatory):** stop worktree-bound processes → remove `.worktree/<id>` →
+  restart from primary checkout on `develop` (`duaer handoff [--run]`, `.duaer/handoff.json`)
+- Push only when the user explicitly asks
+- Promote **`develop` → `main`** only when the user asks to go online
+
+## GitHub issue / PR intake
+
+Issue: verify before work; comment in issue language; close when conclusive.  
+PR: judge principle; merge sound PRs; no silent reimplementation.  
+Neither authorizes push by itself.
+
+## Commits
+
+```text
+type(scope): description
+```
+
+Types: `feat fix docs test chore refactor perf build ci` — English, imperative.

package/.claude/rules/ai-ui-copy.md

@@ -0,0 +1,9 @@
+<!-- Keep AI-generated page copy minimal (duaer-spec agent ops) -->
+
+# AI-generated page content
+
+AI-generated pages must not contain redundant explanatory text.
+
+- No filler introductions, repeated summaries, or prose that only explains an obvious control
+- Prefer concise labels, headings, helper text, and empty states
+- Put rationale and implementation detail in docs or code comments, not in the UI, unless the user asks for explanatory content

package/.claude/rules/duaer-spec.md

@@ -0,0 +1,51 @@
+<!-- Autonomous digital employee — run Duaer job loop without asking the user to operate -->
+
+# Digital employee (autonomous)
+
+You are a **digital employee** in this repo. The human gives intent in normal
+language. **You** run the delivery process. Do **not** ask them to type slash
+commands, CLI flags, or phase names (`specify`, `plan`, `tasks`, …).
+
+If this conflicts with root `AGENTS.md` (worktrees, commits, Issue/PR),
+**AGENTS.md wins**.
+
+## When the human asks for work
+
+For new behavior, fixes, refactors that change product behavior, or architecture:
+
+0. **Isolate first (mandatory):** update **`develop`** (hotfix: **`main`**),
+   create `feat|fix/<name>`, add worktree at `.worktree/feat-<name>` or
+   `.worktree/fix-<name>` (slash → hyphen). Never name the worktree after the
+   Brief folder (do **not** use `.worktree/<nnn-slug>` when the Spec is
+   `.duaer/specs/<nnn-slug>/`). Work only in the worktree. Never commit
+   `.worktree/`. Never develop on `main` or `develop`.
+1. **Silently follow** the procedure in `.claude/skills/duaer-do/SKILL.md`
+   (assign Brief → light tasks → implement → converge → handoff line).
+2. Do **not** wait for `/duaer-do` or any other skill invocation.
+3. Do **not** say “please run `/duaer-specify`” — you do it.
+4. Do **not** dump a methodology tutorial unless they ask how Duaer works.
+5. Merge to **`develop`** when done (hotfix: **`main`**, then back-merge
+   **`develop`**). Promote to **`main`** only if the user asks to go online.
+6. **Handoff (mandatory):** stop processes bound to `.worktree/<id>/`, remove
+   the worktree, then restart services from the primary checkout on `develop`
+   using `.duaer/handoff.json` / `duaer handoff [--run]`. Never leave the user
+   on a dead worktree server.
+   See `docs/agent/branching-and-release.md`.
+
+## Handoff
+
+- End with whether the **job** is accepted or still open (one clear line).
+- Do **not** claim “done” / “finished” / “complete” unless `delivery.json` is
+  `accepted` and open tasks are clear.
+- Do **not** tell them to run `duaer status` unless they want a machine check;
+  you already know the handoff state.
+
+## Forbidden
+
+- Jump from chat to code with no Brief under `.duaer/specs/`.
+- Making the human operate the workflow.
+
+## Optional finer tools (agent-only)
+
+Step skills (`duaer-specify`, `duaer-plan`, …) are **your** playbooks when a
+job is large. The human should not need to know they exist.

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

@@ -22,7 +22,8 @@ For new behavior, fixes, refactors that change product behavior, or architecture
    Brief folder (do **not** use `.worktree/<nnn-slug>` when the Spec is
    `.duaer/specs/<nnn-slug>/`). Work only in the worktree. Never commit
    `.worktree/`. Never develop on `main` or `develop`.
-1. **Silently follow** the procedure in `.cursor/skills/duaer-do/SKILL.md`
+1. **Silently follow** the procedure in the `duaer-do` skill
+   (`.cursor/skills/duaer-do/SKILL.md` or `.claude/skills/duaer-do/SKILL.md`)
    (assign Brief → light tasks → implement → converge → handoff line).
 2. Do **not** wait for `/duaer-do` or any other skill invocation.
 3. Do **not** say “please run `/duaer-specify`” — you do it.

package/ADOPT.md

@@ -32,9 +32,14 @@ npx duaer-spec init --here --ops
 npx duaer-spec update --method    # rare; usually omit
 ```
 
+Works with **Cursor**, **Claude Code**, and **Codex** (all hosts installed by default).
+
 ## What you get
 
 - Autonomous job loop (ask → Brief → work → accept)  
+- Cursor: `.cursor/rules` + `.cursor/skills`  
+- Claude Code: `CLAUDE.md` + `.claude/rules` + `.claude/skills`  
+- Codex: `AGENTS.md` + `.agents/skills`  
 - `.duaer/handoff.json` + `duaer handoff` after worktree remove  
 - Agent ops: `main` / `develop` / `feat` / `fix` + `.worktree/`  
 

package/AGENTS.md

@@ -19,6 +19,21 @@ documentation unless the adopting project explicitly overrides.
 
 Follow the project's [baseline](docs/baseline.md) (or its local equivalent).
 
+## Autonomous job loop (all hosts)
+
+For product work (new behavior, fixes, refactors), **you** run Brief → work →
+accept. Do **not** ask the human to type slash commands, phase names, or CLI
+flags.
+
+1. Isolate: `feat|fix/<name>` + `.worktree/feat-<name>/` (or `fix-…`); never
+   reuse the Brief folder name as the worktree id.
+2. Follow the `duaer-do` skill under the host skill root:
+   - Codex: `.agents/skills/duaer-do/SKILL.md`
+   - Cursor: `.cursor/skills/duaer-do/SKILL.md`
+   - Claude Code: `.claude/skills/duaer-do/SKILL.md`
+3. Briefs live in `.duaer/specs/<nnn-slug>/`. Method notes: [`DUADER.md`](DUADER.md).
+4. One handoff line; never claim done unless `delivery.json` is `accepted`.
+
 ## GitHub Issue Handling
 
 When the user provides a GitHub issue URL (or an unambiguous issue number for

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 0.8.0 — 2026-09-15
+
+### Codex host
+
+- Mirror `duaer-*` skills to `.agents/skills/` (Codex discovery path)
+- `AGENTS.md` always-on section names the Codex / Cursor / Claude skill roots
+- Cursor and Claude Code installs unchanged
+
+## 0.7.0 — 2026-09-15
+
+### Claude Code host
+
+- `init` / `update` install **both** Cursor and Claude Code surfaces
+- Claude: `CLAUDE.md`, `.claude/rules/*.md`, `.claude/skills/duaer-*` (mirrored)
+- Cursor: `.cursor/rules/*.mdc`, `.cursor/skills/duaer-*` (unchanged)
+
 ## 0.6.4 — 2026-09-15
 
 ### Worktree ≠ Brief folder name

package/CLAUDE.md

@@ -0,0 +1,27 @@
+# CLAUDE.md — duaer-spec
+
+This repository uses **duaer-spec**: coding agents are digital employees.
+
+**Precedence:** `AGENTS.md` (ops) wins over `DUADER.md` / `.duaer/` (method).
+
+## Always on
+
+- Follow `.claude/rules/` in this project.
+- For product work, run the job loop in `.claude/skills/duaer-do/SKILL.md`
+  without waiting for slash commands.
+- Do not ask the human to operate phases, CLI flags, or skill names.
+
+## Layout
+
+| Host | Always-on | Skills |
+|---|---|---|
+| Cursor | `.cursor/rules/` | `.cursor/skills/` |
+| Claude Code | `CLAUDE.md` + `.claude/rules/` | `.claude/skills/` |
+| Codex | `AGENTS.md` | `.agents/skills/` |
+
+Installed by `npx duaer-spec init --here` / `update`.
+
+## Branches
+
+See `docs/agent/branching-and-release.md` and `AGENTS.md`.
+Worktree: `.worktree/feat-<name>/` — not the same name as `.duaer/specs/<nnn-slug>/`.

package/DUADER.md

@@ -14,7 +14,7 @@ runs Brief → work → accept. Humans are not the operators of the phase machin
 
 ## Agent procedure (autonomous)
 
-Follow `.cursor/skills/duaer-do/SKILL.md` on every product ask — **without**
+Follow the `duaer-do` skill (`.cursor/skills/`, `.claude/skills/`, or `.agents/skills/`) on every product ask — **without**
 waiting for a slash invocation:
 
 1. Assign Brief + `active-job.json`  
@@ -38,8 +38,9 @@ Humans need not configure it for everyday use.
   .duaer/active-job.json
   .duaer/specs/<nnn-slug>/             # Brief (≠ worktree folder name)
     spec.md | tasks.md | delivery.json
-.cursor/rules/duaer-spec.mdc           # autonomous behavior
-.cursor/skills/duaer-do/               # default job loop
+.cursor/rules|skills/                  # Cursor host
+.claude/rules|skills/ + CLAUDE.md      # Claude Code host
+.agents/skills/ + AGENTS.md            # Codex host
 ```
 
 Worktree and Brief are different layers. Prefer

package/README.md

@@ -19,7 +19,9 @@ npx duaer-spec init --here
 npx duaer-spec update
 ```
 
-Then use Cursor as usual — describe what you want.
+Then use **Cursor**, **Claude Code**, or **Codex** — describe what you want.
+
+Install writes `.cursor/`, `.claude/` (+ `CLAUDE.md`), and `.agents/skills/` (Codex).
 
 中文说明：[`README.zh-CN.md`](README.zh-CN.md)
 

package/README.zh-CN.md

@@ -2,7 +2,9 @@
 
 **Duaer** 把 AI 编程助手变成**数字员工**：你用自然语言提需求，它自己跑 Spec → 实现 → 验收；只有交接干净才算完成。
 
-你**不用**操作流程。装一次之后，说话即可。
+你**不用**操作流程。装一次之后，在 **Cursor**、**Claude Code** 或 **Codex** 里说话即可。
+
+`init` / `update` 会写入 `.cursor/`、`.claude/`（+ `CLAUDE.md`）、以及 Codex 的 `.agents/skills/`。
 
 ## 安装
 

package/bin/duaer.mjs

@@ -209,13 +209,27 @@ function installMethod(target, opts) {
   writeDefaultPolicy(target, opts)
   writeDefaultHandoff(target, opts)
 
-  ensureDir(join(target, '.cursor', 'skills'))
+  installCursorMethod(target, opts)
+  installClaudeMethod(target, opts)
+  installCodexMethod(target, opts)
+
+  copyPath(join(PKG_ROOT, 'DUADER.md'), join(target, 'DUADER.md'), opts)
+  console.log('  DUADER.md')
+  ensureWorktreeGitignore(target)
+}
+
+function mirrorDuaerSkills(target, skillsDir, opts, label) {
+  ensureDir(skillsDir)
   const skillsRoot = join(PKG_ROOT, '.cursor', 'skills')
   for (const name of readdirSync(skillsRoot)) {
     if (!name.startsWith('duaer-')) continue
-    copyPath(join(skillsRoot, name), join(target, '.cursor', 'skills', name), opts)
+    copyPath(join(skillsRoot, name), join(skillsDir, name), opts)
   }
-  console.log('  .cursor/skills/duaer-*')
+  console.log(`  ${label}`)
+}
+
+function installCursorMethod(target, opts) {
+  mirrorDuaerSkills(target, join(target, '.cursor', 'skills'), opts, '.cursor/skills/duaer-*')
 
   ensureDir(join(target, '.cursor', 'rules'))
   copyPath(
@@ -224,10 +238,72 @@ function installMethod(target, opts) {
     opts,
   )
   console.log('  .cursor/rules/duaer-spec.mdc')
+}
 
-  copyPath(join(PKG_ROOT, 'DUADER.md'), join(target, 'DUADER.md'), opts)
-  console.log('  DUADER.md')
-  ensureWorktreeGitignore(target)
+function installClaudeMethod(target, opts) {
+  mirrorDuaerSkills(
+    target,
+    join(target, '.claude', 'skills'),
+    opts,
+    '.claude/skills/duaer-*  (mirrored from .cursor/skills)',
+  )
+
+  ensureDir(join(target, '.claude', 'rules'))
+  const claudeRule = join(PKG_ROOT, '.claude', 'rules', 'duaer-spec.md')
+  if (existsSync(claudeRule)) {
+    copyPath(claudeRule, join(target, '.claude', 'rules', 'duaer-spec.md'), opts)
+  } else {
+    writeIfNeeded(
+      join(target, '.claude', 'rules', 'duaer-spec.md'),
+      cursorRuleToClaude(
+        readFileSync(join(PKG_ROOT, '.cursor', 'rules', 'duaer-spec.mdc'), 'utf8'),
+        '.claude',
+      ),
+      opts,
+    )
+  }
+  console.log('  .claude/rules/duaer-spec.md')
+
+  const claudeMdSrc = join(PKG_ROOT, 'CLAUDE.md')
+  if (existsSync(claudeMdSrc)) {
+    copyPath(claudeMdSrc, join(target, 'CLAUDE.md'), opts)
+  } else {
+    writeIfNeeded(join(target, 'CLAUDE.md'), defaultClaudeMd(), opts)
+  }
+  console.log('  CLAUDE.md')
+}
+
+function installCodexMethod(target, opts) {
+  // Codex discovers repo skills under .agents/skills (not .codex/skills).
+  // Always-on guidance is AGENTS.md (installed with ops).
+  mirrorDuaerSkills(
+    target,
+    join(target, '.agents', 'skills'),
+    opts,
+    '.agents/skills/duaer-*  (Codex; mirrored from .cursor/skills)',
+  )
+}
+
+function cursorRuleToClaude(mdc, skillHost) {
+  let body = mdc.replace(/^---\n[\s\S]*?\n---\n+/, (fm) => {
+    const desc = (fm.match(/^description:\s*(.+)$/m) || [])[1]
+    return desc ? `<!-- ${desc.trim()} -->\n\n` : ''
+  })
+  body = body.replaceAll('.cursor/skills/', `${skillHost}/skills/`)
+  return body.trimEnd() + '\n'
+}
+
+function defaultClaudeMd() {
+  return `# CLAUDE.md — duaer-spec
+
+This project uses **duaer-spec**: coding agents are digital employees.
+
+**Precedence:** \`AGENTS.md\` (ops) wins over \`DUADER.md\` / \`.duaer/\` (method).
+
+- Follow \`.claude/rules/\`
+- Job loop: \`.claude/skills/duaer-do/SKILL.md\` (no slash commands required)
+- Branches / worktrees: see \`AGENTS.md\` and \`docs/agent/branching-and-release.md\`
+`
 }
 
 function ensureWorktreeGitignore(target) {
@@ -259,6 +335,22 @@ function installOps(target, opts) {
   }
   console.log('  .cursor/rules/agents-workflow.mdc, ai-ui-copy.mdc')
 
+  ensureDir(join(target, '.claude', 'rules'))
+  for (const name of ['agents-workflow.md', 'ai-ui-copy.md']) {
+    const src = join(PKG_ROOT, '.claude', 'rules', name)
+    if (existsSync(src)) {
+      copyPath(src, join(target, '.claude', 'rules', name), opts)
+    } else {
+      const mdc = name.replace(/\.md$/, '.mdc')
+      writeIfNeeded(
+        join(target, '.claude', 'rules', name),
+        cursorRuleToClaude(readFileSync(join(PKG_ROOT, '.cursor', 'rules', mdc), 'utf8'), '.claude'),
+        opts,
+      )
+    }
+  }
+  console.log('  .claude/rules/agents-workflow.md, ai-ui-copy.md')
+
   ensureDir(join(target, 'docs', 'agent'))
   for (const name of [
     'workflow.md',
@@ -336,7 +428,7 @@ function cmdInit(opts) {
   console.log(`
 Hired.
 
-Talk to the agent in plain language.
+Talk to the agent in plain language (Cursor, Claude Code, or Codex).
 Later update:  npx duaer-spec update
 `)
 }
@@ -472,8 +564,13 @@ function checkWorkplace(target) {
     ['DUADER.md', 'method'],
     ['.cursor/rules/duaer-spec.mdc', 'method'],
     ['.cursor/skills/duaer-specify/SKILL.md', 'method'],
+    ['.claude/rules/duaer-spec.md', 'method'],
+    ['.claude/skills/duaer-do/SKILL.md', 'method'],
+    ['.agents/skills/duaer-do/SKILL.md', 'method'],
+    ['CLAUDE.md', 'method'],
     ['AGENTS.md', 'ops'],
     ['.cursor/rules/agents-workflow.mdc', 'ops'],
+    ['.claude/rules/agents-workflow.md', 'ops'],
     ['docs/agent/workflow.md', 'ops'],
   ]
   let missing = 0

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

@@ -38,6 +38,8 @@ the table for their app.
 | E2E-011 | Installed docs (`DUADER.md`, `docs/agent/`) document `update` | manual |
 | E2E-012 | `README.zh-CN.md` covers install, update, branch model | manual |
 | E2E-013 | Worktree id ≠ Brief `<nnn-slug>`; path is `.worktree/feat-…/.duaer/specs/…` | manual |
+| E2E-014 | Init installs Cursor + Claude hosts (`CLAUDE.md`, `.claude/skills`) | manual |
+| E2E-015 | Init installs Codex skills under `.agents/skills/` | manual |
 
 ## Traceability
 
@@ -56,3 +58,5 @@ the table for their app.
 | E2E-011 | DUADER + agent docs | Update path in installed 说明 |
 | E2E-012 | `README.zh-CN.md` | Chinese 说明文档 |
 | E2E-013 | AGENTS / branching naming | Avoid double `<nnn-slug>` |
+| E2E-014 | Claude + Cursor install | Dual host |
+| E2E-015 | Codex `.agents/skills` | Triple host |

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "duaer-spec",
-  "version": "0.6.4",
-  "description": "Digital employees: autonomous delivery; main/develop/feat/fix; simple update",
+  "version": "0.8.0",
+  "description": "Digital employees for Cursor, Claude Code, and Codex; main/develop/feat/fix",
   "type": "module",
   "bin": {
     "duaer": "bin/duaer.mjs",
@@ -11,7 +11,9 @@
     "bin",
     ".duaer",
     ".cursor",
+    ".claude",
     "AGENTS.md",
+    "CLAUDE.md",
     "DUADER.md",
     "ADOPT.md",
     "CHANGELOG.md",
@@ -43,7 +45,11 @@
     "agents",
     "cursor",
     "ai-engineering",
-    "controllable-delivery"
+    "controllable-delivery",
+    "claude",
+    "claude-code",
+    "codex",
+    "openai-codex"
   ],
   "license": "MIT",
   "scripts": {