git:20260609.c723548 to git:20260611.3860ed5

0 added, 4 removed. Audit A to A.

---

name: nw-deliver-orchestration

description: DELIVER wave orchestration workflow -- 9 phases from baseline to finalization. Load when user invokes *deliver command. Covers state tracking, smart skip logic, retry, resume, and quality gate enforcement.

user-invocable: false

disable-model-invocation: true

---

# DELIVER Wave Orchestration

When invoked via `*deliver "{feature-description}"`, Apex orchestrates the complete DELIVER wave lifecycle.

## Orchestration Role

Parse feature description, derive feature ID, execute 9 phases in order. Track state for resume capability.

**Invocation**: `*deliver "Implement user authentication with JWT tokens"`

## 9 Phases

### Phase 1-2: Baseline Creation + Review

Create: `docs/feature/{feature-id}/deliver/baseline.yaml`. Reviewer: @nw-software-crafter-reviewer.

Smart skip: yes (if file exists AND `validation.status == "approved"`).

### Phase 3-4: Roadmap Creation + Dual Review

Create: `docs/feature/{feature-id}/deliver/roadmap.json`.

Reviewer 1: @nw-product-owner-reviewer (business) | Reviewer 2: @nw-software-crafter-reviewer (technical). Sequential reviews.

Smart skip: yes (if approved).

### Phase 5-6: Split + Review Each Step

Define steps in: `docs/feature/{feature-id}/deliver/roadmap.json`. Reviewer: @nw-software-crafter-reviewer (per roadmap step).

Smart skip: yes (if all approved).

### Phase 7: Execute All Steps

For each step: invoke `@nw-software-crafter` with step ID. Automatic dependency ordering (topological sort via Kahn's algorithm). 11-phase TDD per step (PREPARE through COMMIT). Local commit after each step (no push). Stop immediately if any step fails.

### Phase 8: Finalize

Archive to: `docs/evolution/{timestamp}_{feature-id}.md`. Clean up workflow files.

### Phase 9: Report Completion

Display comprehensive statistics | List all quality gates passed | Show next steps (review evolution doc, push commits, proceed to DEVOPS wave validation).

- ## ATDD-Pure Spine (roadmap-free)

- The 9 phases above describe the classic DELIVER spine. When `workflow.mode` is `atdd_pure`, DELIVER runs the **roadmap-free sibling spine** instead — a 7-phase A→G per-slice loop (ADR-028), not an extension of the classic phases. There is no Phase 3-4 roadmap step and no `execution-log.json`; each carpaccio slice flows A (green ATs) → G (commit), with an append-only AT-completion ledger as the phase record. The two spines are siblings selected by `workflow.mode` — classic stays roadmap-driven, `atdd_pure` is roadmap-free. The classic state-tracking and smart-skip logic below applies to the classic spine; the `atdd_pure` spine resumes from the AT-completion ledger.

## Smart Skip Logic

- File exists AND `validation.status == "approved"` -> skip creation, load for context

- File exists but not approved -> skip creation, proceed directly to review

- File missing -> create new artifact

## Quality Gates

| Gate | Reviews | Reviewer |

|------|---------|----------|

| Baseline | 1 | nw-software-crafter-reviewer |

| Roadmap | 2 | nw-product-owner-reviewer + nw-software-crafter-reviewer |

| Step files | N (per step) | nw-software-crafter-reviewer |

| TDD phases | 2N (per step) | REVIEW + POST-REFACTOR REVIEW |

**Total reviews per feature**: 3 + 3N (where N = number of steps)

## Retry Logic

- Max 2 attempts per review

- Rejected: regenerate artifact with feedback, retry review

- Rejected after 2 attempts: stop workflow, require manual intervention

## Stop-on-Failure Policy

- Any review fails after 2 attempts -> stop entire workflow

- Any step execution fails -> stop entire workflow

- User fixes issue manually, re-runs `*deliver` (resumes from failure point)

## State Tracking

Progress tracked in `docs/feature/{feature-id}/deliver/.deliver-progress.json`:

```json

{

"project_id": "user-authentication",

"started_at": "2025-01-13T10:30:00",

"last_updated": "2025-01-13T12:45:00",

"completed_phases": ["Phase 1", "Phase 2"],

"current_phase": "Phase 3",

"failed_phase": null,

"failure_reason": null,

"completed_steps": ["01-01", "01-02"],

"failed_step": null,

"skip_flags": {

"baseline": true,

"roadmap": false,

"split": false

"orchestration_complete": false

}

```

## Resume Capability

On re-invocation: Load `.deliver-progress.json` -> Skip completed phases -> Resume from failure point or current phase.

## Post-Completion

After DELIVER wave completes: All code committed locally (one commit per step) | Evolution document in `docs/evolution/` | User reviews commits and evolution document | User pushes: `git push` | Validate production readiness: `*validate-completion`.