| 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).
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:
{
"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.
