@dalzoubi/dev-agents-sync 2.0.24 → 2.0.25

package/README.md

@@ -51,9 +51,9 @@ npx --yes @dalzoubi/dev-agents-sync@1 init --targets codex
 
 Codex is **opt-in only**. Unlike other targets there is no filesystem signal to detect (there is no `.codex/` directory), so `codex` is never auto-selected — you must pass `--targets codex` explicitly. You can combine it with other targets, e.g. `--targets claude,codex`.
 
-**Output shape.** `init --targets codex` writes six directory-per-skill files — one per agent — at `.agents/skills/<agent>/SKILL.md` (`analyze`, `define`, `implement`, `supervise`, `test`, `validate`), plus a thin root `AGENTS.md` index. Codex discovers these by scanning from the working directory up to the repo root, so each agent lives at its own `.agents/skills/<agent>/SKILL.md` path. Every file carries the managed-by marker, and `update` and `check` scope to these paths exactly like the other targets.
+**Output shape.** `init --targets codex` writes one directory-per-skill file per agent at `.agents/skills/<agent>/SKILL.md` — covering the full `define`/`deliver` topology listed under [Agents](#agents) — plus a thin root `AGENTS.md` index. Codex discovers these by scanning from the working directory up to the repo root, so each agent lives at its own `.agents/skills/<agent>/SKILL.md` path. Every file carries the managed-by marker, and `update` and `check` scope to these paths exactly like the other targets.
 
-**Standalone.** Codex is a first-class standalone target. Each emitted `SKILL.md` bundles the workflow support docs it references, so a Codex-only install does **not** need `.claude/skills/*.md`, `.cursor/`, or any other target files to run the six agent workflows.
+**Standalone.** Codex is a first-class standalone target. Each emitted `SKILL.md` bundles the workflow support docs it references, so a Codex-only install does **not** need `.claude/skills/*.md`, `.cursor/`, or any other target files to run the agent workflows.
 
 **Model-invoked, not slash commands.** Codex Agent Skills are model-invoked: a Codex user triggers an agent through `/skills`, a `$<name>` mention, or implicit selection by the model — *not* by typing a literal `/define`-style slash command the way Claude commands work. This is an accepted approximation of the slash-command UX the other targets provide; the agent content is the same, only the invocation differs.
 
@@ -140,35 +140,45 @@ With `--no-hooks-wiring`, the hook scripts are still installed under `.claude/ho
 
 ## Agents
 
-Syncing installs six agents that form a spec-driven workflow:
-**Define → Analyze → Implement / Test / Validate**, or **Supervise** to run the
-loop autonomously. Each agent has a matching slash command (for example
-`/define`), and every agent reads the project's `CLAUDE.md` / `AGENTS.md` at the
-start of a session.
+Syncing installs the `define`/`deliver` agent topology: two user-facing
+orchestrators plus their namespaced workers (12 agents in total). Each agent has
+a matching slash command (for example `/define`), and every agent reads the
+project's `CLAUDE.md` / `AGENTS.md` at the start of a session.
+
+**`define` namespace — spec authoring:**
 
 | Agent | Command | Purpose |
 |---|---|---|
-| `define` | `/define` | Planning agent for spec-driven development. Runs a one-question-at-a-time Q&A to turn a vague ask into a spec, then writes it to the project's spec directory. Read-only on source code; produces spec markdown only and auto-runs Analyze when done. |
-| `analyze` | `/analyze` | Pre-implementation spec checker. Scans for unresolved `[NEEDS CLARIFICATION]` markers, checks structure and estimates, and emits a `PASS` or `BLOCKED` verdict. Read-only; reports only. |
-| `implement` | `/implement` | Build-and-refactor agent. Builds features from an approved spec, refactors, debugs, and runs fix-build-test loops. The only agent that changes source files; pauses at checkpoints and won't commit unless asked. |
-| `test` | `/test` | Test and quality agent. Writes unit/integration/regression tests, reproduces bugs with a failing test first, and adds edge cases. Edits **test files only** — never production code. |
-| `validate` | `/validate` | Review and risk agent. Audits the current branch before a PR for security, regressions, accessibility, performance, spec conformance, and coverage gaps. Read-only; outputs a severity-ranked report. |
-| `supervise` | `/supervise <spec-path> [--auto] [--verbose]` | Autonomous TDD orchestrator. Drives test → implement → validate across an approved spec's slices, one at a time, with per-slice cycle budgets and recurrence detection. Delegates to the other agents; pauses on recurring failures, budget exhaustion, or interrupt. |
+| `define` | `/define` | Q&A orchestrator. Runs a one-question-at-a-time Q&A to turn a vague ask into spec/plan/tasks artifacts, then auto-runs `define-analyze`. Read-only on source code. |
+| `define-spec` | `/define-spec` | Writes `spec.md` (requirements). |
+| `define-plan` | `/define-plan` | Writes `plan.md` (technical plan + authoritative working branch). |
+| `define-tasks` | `/define-tasks` | Writes `tasks.md` (slices + estimates). |
+| `define-analyze` | `/define-analyze` | Readiness gate. Scans for unresolved `[NEEDS CLARIFICATION]` markers, checks structure and estimates, and emits a `PASS` or `BLOCKED` verdict. Read-only; reports only. |
+
+**`deliver` namespace — autonomous TDD delivery:**
 
-A bonus command, `/preflight`, runs a pre-review checklist (lint, unit tests,
-and build if relevant) and summarizes what changed. It does not push or open a PR.
+| Agent | Command | Purpose |
+|---|---|---|
+| `deliver` | `/deliver <spec-path> [--auto] [--verbose] [--max-parallel=N]` | Autonomous TDD orchestrator. Drives the four-step cycle `deliver-test → deliver-solution → deliver-refactor → deliver-validate` across an approved spec's slices, with per-slice cycle budgets and recurrence detection; finalizes with `deliver-preflight`. Pauses on recurring failures, budget exhaustion, or interrupt. |
+| `deliver-solution` | `/deliver-solution` | Implementation and debugging worker. Builds features from an approved spec, debugs, and runs fix-build-test loops. Pauses at checkpoints and won't commit unless asked. |
+| `deliver-test` | `/deliver-test` | Test and quality worker. Writes failing-first unit/integration/regression tests and adds edge cases. Edits **test files only** — never production code. |
+| `deliver-refactor` | `/deliver-refactor` | Behavior-preserving refactor worker. Improves production-source structure after tests are green; no new features, never test files. |
+| `deliver-validate` | `/deliver-validate` | Review and risk worker. Audits the current branch before a PR for security, regressions, accessibility, performance, spec conformance, and coverage gaps. Read-only; outputs a severity-ranked report. |
+| `deliver-preflight` | `/deliver-preflight` | Pre-review gate. Runs lint, unit tests, and build if relevant, then summarizes what changed. Does not push or open a PR. |
+| `deliver-document` | `/deliver-document` | End-of-feature docs/CHANGELOG finalization; flips the spec's Status to Shipped. |
 
 ### When to use which
 
 | You want to… | Use |
 |---|---|
 | Scope a new feature or change before writing code | `/define` |
-| Confirm a spec is ready to build from | `/analyze` |
-| Build from an approved spec, refactor, or debug | `/implement` |
-| Add test coverage or pin a bug with a failing test | `/test` |
-| Audit risk right before opening a PR | `/validate` |
-| Build an approved spec largely hands-off, slice by slice | `/supervise` |
-| Run lint/tests/build before review | `/preflight` |
+| Confirm a spec is ready to build from | `/define-analyze` |
+| Build from an approved spec or debug | `/deliver-solution` |
+| Add test coverage or pin a bug with a failing test | `/deliver-test` |
+| Clean up structure once the scoped tests are green | `/deliver-refactor` |
+| Audit risk right before opening a PR | `/deliver-validate` |
+| Build an approved spec largely hands-off, slice by slice | `/deliver` |
+| Run lint/tests/build before review | `/deliver-preflight` |
 
 ## Common Flags
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dalzoubi/dev-agents-sync",
-  "version": "2.0.24",
+  "version": "2.0.25",
   "type": "module",
   "description": "CLI that syncs managed dev-agent prompts into consumer repos (.claude/ and/or .cursor/).",
   "license": "UNLICENSED",