duaer-spec 0.7.0 → 0.9.0

package/ADOPT.md

@@ -32,13 +32,22 @@ npx duaer-spec init --here --ops
 npx duaer-spec update --method    # rare; usually omit
 ```
 
-Works with **Cursor** and **Claude Code** (both hosts installed by default).
+Works with **Cursor**, **Claude Code**, **Codex**, **GitHub Copilot**,
+**Windsurf / Devin**, **Cline**, **Continue**, **Gemini CLI**, and **Aider**
+(adapters 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`  
+- Copilot: `.github/copilot-instructions.md`  
+- Windsurf / Devin: `.windsurf/rules`, `.devin/rules`  
+- Cline: `.clinerules/`  
+- Continue: `.continue/rules/`  
+- Gemini CLI: `GEMINI.md`  
+- Aider: `.aider.conf.yml` → reads `AGENTS.md`  
 - `.duaer/handoff.json` + `duaer handoff` after worktree remove  
 - Agent ops: `main` / `develop` / `feat` / `fix` + `.worktree/`  
 

package/AGENTS.md

@@ -19,6 +19,23 @@ 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 (when the host has skills):
+   - Codex / shared: `.agents/skills/duaer-do/SKILL.md`
+   - Cursor: `.cursor/skills/duaer-do/SKILL.md`
+   - Claude Code: `.claude/skills/duaer-do/SKILL.md`
+   - Copilot / Windsurf / Cline / Continue / Gemini / Aider: follow this section
+     and the host adapter files installed by `duaer init`
+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,25 @@
 # Changelog
 
+## 0.9.0 — 2026-09-15
+
+### More common agent hosts
+
+- GitHub Copilot: `.github/copilot-instructions.md`
+- Windsurf + Devin: `.windsurf/rules/`, `.devin/rules/`
+- Cline: `.clinerules/`
+- Continue: `.continue/rules/`
+- Gemini CLI: `GEMINI.md`
+- Aider: `.aider.conf.yml` (reads `AGENTS.md`)
+- Cursor / Claude Code / Codex unchanged
+
+## 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

package/CLAUDE.md

@@ -13,12 +13,19 @@ This repository uses **duaer-spec**: coding agents are digital employees.
 
 ## Layout
 
-| Host | Rules | Skills |
+| Host | Always-on | Skills / notes |
 |---|---|---|
-| Claude Code | `.claude/rules/` | `.claude/skills/` |
 | Cursor | `.cursor/rules/` | `.cursor/skills/` |
-
-Both are installed by `npx duaer-spec init --here` / `update`.
+| Claude Code | `CLAUDE.md` + `.claude/rules/` | `.claude/skills/` |
+| Codex | `AGENTS.md` | `.agents/skills/` |
+| Copilot | `.github/copilot-instructions.md` | also reads `AGENTS.md` |
+| Windsurf / Devin | `.windsurf/rules/`, `.devin/rules/` | — |
+| Cline | `.clinerules/` | — |
+| Continue | `.continue/rules/` | — |
+| Gemini CLI | `GEMINI.md` | — |
+| Aider | `.aider.conf.yml` | reads `AGENTS.md` |
+
+Installed by `npx duaer-spec init --here` / `update`.
 
 ## Branches
 

package/DUADER.md

@@ -14,7 +14,7 @@ runs Brief → work → accept. Humans are not the operators of the phase machin
 
 ## Agent procedure (autonomous)
 
-Follow the `duaer-do` skill (`.cursor/skills/` or `.claude/skills/`) 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,13 @@ 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|skills/                  # Cursor host
-.claude/rules|skills/ + CLAUDE.md      # Claude Code host
+.cursor/rules|skills/                  # Cursor
+.claude/rules|skills/ + CLAUDE.md      # Claude Code
+.agents/skills/ + AGENTS.md            # Codex (+ shared skills)
+.github/copilot-instructions.md        # Copilot
+.windsurf/rules/ + .devin/rules/       # Windsurf / Devin
+.clinerules/ + .continue/rules/        # Cline / Continue
+GEMINI.md + .aider.conf.yml            # Gemini / Aider
 ```
 
 Worktree and Brief are different layers. Prefer

package/GEMINI.md

@@ -0,0 +1,9 @@
+# GEMINI.md — duaer-spec
+
+This project uses **duaer-spec**: coding agents are digital employees.
+
+**Precedence:** `AGENTS.md` (ops) wins over `DUADER.md` / `.duaer/` (method).
+
+- Follow `AGENTS.md` § Autonomous job loop
+- Job skill (when available): `.agents/skills/duaer-do/SKILL.md`
+- Branches / worktrees: `docs/agent/branching-and-release.md`

package/README.md

@@ -19,9 +19,9 @@ npx duaer-spec init --here
 npx duaer-spec update
 ```
 
-Then use **Cursor** or **Claude Code** as usual — describe what you want.
+Then use **Cursor**, **Claude Code**, **Codex**, **Copilot**, **Windsurf**, **Cline**, **Continue**, **Gemini**, or **Aider** — describe what you want.
 
-Install writes both `.cursor/` and `.claude/` (plus `CLAUDE.md`).
+Install writes host adapters for each (see [`ADOPT.md`](ADOPT.md)).
 
 中文说明：[`README.zh-CN.md`](README.zh-CN.md)
 

package/README.zh-CN.md

@@ -2,9 +2,9 @@
 
 **Duaer** 把 AI 编程助手变成**数字员工**：你用自然语言提需求，它自己跑 Spec → 实现 → 验收；只有交接干净才算完成。
 
-你**不用**操作流程。装一次之后，在 **Cursor** 或 **Claude Code** 里说话即可。
+你**不用**操作流程。装一次之后，在 **Cursor** / **Claude Code** / **Codex** / **Copilot** / **Windsurf** / **Cline** / **Continue** / **Gemini** / **Aider** 里说话即可。
 
-`init` / `update` 会同时写入 `.cursor/` 与 `.claude/`（以及 `CLAUDE.md`）。
+`init` / `update` 会写入各宿主适配文件（详见 [`ADOPT.md`](ADOPT.md)）。
 
 ## 安装
 

package/bin/duaer.mjs

@@ -211,20 +211,25 @@ function installMethod(target, opts) {
 
   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 installCursorMethod(target, opts) {
-  ensureDir(join(target, '.cursor', 'skills'))
+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(
@@ -236,13 +241,12 @@ function installCursorMethod(target, opts) {
 }
 
 function installClaudeMethod(target, opts) {
-  ensureDir(join(target, '.claude', 'skills'))
-  const skillsRoot = join(PKG_ROOT, '.cursor', 'skills')
-  for (const name of readdirSync(skillsRoot)) {
-    if (!name.startsWith('duaer-')) continue
-    copyPath(join(skillsRoot, name), join(target, '.claude', 'skills', name), opts)
-  }
-  console.log('  .claude/skills/duaer-*  (mirrored from .cursor/skills)')
+  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')
@@ -269,6 +273,155 @@ function installClaudeMethod(target, 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 stripRuleComment(md) {
+  return md.replace(/^<!--[\s\S]*?-->\s*/, '').trim()
+}
+
+function withYamlFrontmatter(body, lines) {
+  return `---\n${lines.join('\n')}\n---\n\n${stripRuleComment(body)}\n`
+}
+
+function loadPackagedRule(name) {
+  const claudePath = join(PKG_ROOT, '.claude', 'rules', name)
+  if (existsSync(claudePath)) return readFileSync(claudePath, 'utf8')
+  const mdc = name.replace(/\.md$/, '.mdc')
+  return cursorRuleToClaude(readFileSync(join(PKG_ROOT, '.cursor', 'rules', mdc), 'utf8'), '.claude')
+}
+
+function genericHostRuleBody(name) {
+  let body = loadPackagedRule(name)
+  body = body.replaceAll(
+    '.claude/skills/duaer-do/SKILL.md',
+    'AGENTS.md § Autonomous job loop (and `.agents/skills/duaer-do/SKILL.md` when present)',
+  )
+  body = body.replaceAll('.claude/skills/', '.agents/skills/')
+  return body
+}
+
+function defaultGeminiMd() {
+  return `# GEMINI.md — duaer-spec
+
+This project uses **duaer-spec**: coding agents are digital employees.
+
+**Precedence:** \`AGENTS.md\` (ops) wins over \`DUADER.md\` / \`.duaer/\` (method).
+
+- Follow \`AGENTS.md\` § Autonomous job loop
+- Job skill (when available): \`.agents/skills/duaer-do/SKILL.md\`
+- Branches / worktrees: \`docs/agent/branching-and-release.md\`
+`
+}
+
+function defaultCopilotInstructions() {
+  return `# GitHub Copilot — duaer-spec
+
+Treat agents as **digital employees**. Humans state intent; you run Brief → work → accept.
+
+**Precedence:** \`AGENTS.md\` > \`DUADER.md\` / \`.duaer/\`
+
+1. Isolate on \`feat|fix/<name>\` under \`.worktree/feat-<name>/\` (never name the worktree after \`.duaer/specs/<nnn-slug>/\`).
+2. Follow \`AGENTS.md\` § Autonomous job loop (skill: \`.agents/skills/duaer-do/SKILL.md\` when present).
+3. Do not ask the human to operate slash commands or phase names.
+4. One handoff line; never claim done unless \`delivery.json\` is \`accepted\`.
+
+See also: \`DUADER.md\`, \`docs/agent/branching-and-release.md\`.
+`
+}
+
+function defaultAiderConf() {
+  return `# duaer-spec — point Aider at the shared agent contract
+read: [AGENTS.md, DUADER.md]
+`
+}
+
+function installRuleSet(target, relDir, names, frontmatterLines, opts, label) {
+  const dir = join(target, ...relDir.split('/'))
+  ensureDir(dir)
+  for (const name of names) {
+    const dest = join(dir, name)
+    if (existsSync(dest) && !opts.force) {
+      console.log(`skip (exists): ${dest}  (use --force to overwrite)`)
+      continue
+    }
+    const body = genericHostRuleBody(name)
+    const content = frontmatterLines?.length
+      ? withYamlFrontmatter(body, frontmatterLines)
+      : `${stripRuleComment(body)}\n`
+    ensureDir(dirname(dest))
+    writeFileSync(dest, content, 'utf8')
+  }
+  console.log(`  ${label}`)
+}
+
+function installExtraHosts(target, opts) {
+  console.log('Installing common host adapters…')
+
+  // GitHub Copilot
+  ensureDir(join(target, '.github'))
+  writeIfNeeded(
+    join(target, '.github', 'copilot-instructions.md'),
+    defaultCopilotInstructions(),
+    opts,
+  )
+  console.log('  .github/copilot-instructions.md')
+
+  // Gemini CLI
+  const geminiSrc = join(PKG_ROOT, 'GEMINI.md')
+  if (existsSync(geminiSrc)) {
+    copyPath(geminiSrc, join(target, 'GEMINI.md'), opts)
+  } else {
+    writeIfNeeded(join(target, 'GEMINI.md'), defaultGeminiMd(), opts)
+  }
+  console.log('  GEMINI.md')
+
+  // Aider
+  writeIfNeeded(join(target, '.aider.conf.yml'), defaultAiderConf(), opts)
+  console.log('  .aider.conf.yml')
+
+  const ruleNames = ['duaer-spec.md', 'agents-workflow.md', 'ai-ui-copy.md']
+
+  // Windsurf (Cascade) + Devin Desktop
+  installRuleSet(
+    target,
+    '.windsurf/rules',
+    ruleNames,
+    ['trigger: always_on'],
+    opts,
+    '.windsurf/rules/*',
+  )
+  installRuleSet(
+    target,
+    '.devin/rules',
+    ruleNames,
+    ['trigger: always_on'],
+    opts,
+    '.devin/rules/*',
+  )
+
+  // Cline
+  installRuleSet(target, '.clinerules', ruleNames, null, opts, '.clinerules/*')
+
+  // Continue.dev
+  installRuleSet(
+    target,
+    '.continue/rules',
+    ruleNames,
+    ['alwaysApply: true'],
+    opts,
+    '.continue/rules/*',
+  )
+}
+
 function cursorRuleToClaude(mdc, skillHost) {
   let body = mdc.replace(/^---\n[\s\S]*?\n---\n+/, (fm) => {
     const desc = (fm.match(/^description:\s*(.+)$/m) || [])[1]
@@ -406,6 +559,9 @@ function cmdInit(opts) {
   if (opts.mode === 'all' || opts.mode === 'ops') {
     installOps(target, opts)
   }
+  if (opts.mode === 'all' || opts.mode === 'method' || opts.mode === 'ops') {
+    installExtraHosts(target, opts)
+  }
   if (opts.mode === 'all' || opts.mode === 'method') {
     writeInitMarker(target, opts)
   }
@@ -413,7 +569,7 @@ function cmdInit(opts) {
   console.log(`
 Hired.
 
-Talk to the agent in plain language.
+Talk to the agent in plain language (Cursor, Claude, Codex, Copilot, and more).
 Later update:  npx duaer-spec update
 `)
 }
@@ -551,7 +707,14 @@ function checkWorkplace(target) {
     ['.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'],
+    ['GEMINI.md', 'method'],
+    ['.github/copilot-instructions.md', 'method'],
+    ['.windsurf/rules/duaer-spec.md', 'method'],
+    ['.clinerules/duaer-spec.md', 'method'],
+    ['.continue/rules/duaer-spec.md', 'method'],
+    ['.aider.conf.yml', 'method'],
     ['AGENTS.md', 'ops'],
     ['.cursor/rules/agents-workflow.mdc', 'ops'],
     ['.claude/rules/agents-workflow.md', 'ops'],

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

@@ -39,6 +39,8 @@ the table for their app.
 | 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 |
+| E2E-016 | Init installs Copilot/Windsurf/Cline/Continue/Gemini/Aider adapters | manual |
 
 ## Traceability
 
@@ -58,3 +60,5 @@ the table for their app.
 | 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 |
+| E2E-016 | Extra host adapters | Copilot+Windsurf+Cline+… |

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "duaer-spec",
-  "version": "0.7.0",
-  "description": "Digital employees for Cursor and Claude Code; main/develop/feat/fix",
+  "version": "0.9.0",
+  "description": "Digital employees for Cursor, Claude, Codex, Copilot, Windsurf, Cline, Continue, Gemini, Aider",
   "type": "module",
   "bin": {
     "duaer": "bin/duaer.mjs",
@@ -14,6 +14,7 @@
     ".claude",
     "AGENTS.md",
     "CLAUDE.md",
+    "GEMINI.md",
     "DUADER.md",
     "ADOPT.md",
     "CHANGELOG.md",
@@ -47,7 +48,16 @@
     "ai-engineering",
     "controllable-delivery",
     "claude",
-    "claude-code"
+    "claude-code",
+    "codex",
+    "openai-codex",
+    "copilot",
+    "windsurf",
+    "cline",
+    "continue",
+    "gemini",
+    "aider",
+    "devin"
   ],
   "license": "MIT",
   "scripts": {