Skip to content

v3.18.0 — Five Ship-phase commands (developer-workflows 0.22.1)

Choose a tag to compare

@alexherrero alexherrero released this 16 Jun 14:30
· 58 commits to main since this release

Summary

Five new commands for the Ship phase of the developer-workflows loop — the gap between /release (the merge gate) and production.

Added

  • /observe — instrumentation discipline: structured logging (log events, not strings), RED metrics (Request rate, Error rate, Duration), OpenTelemetry tracing, symptom-based alerting (alert on error rate, not CPU). Triggered when adding telemetry or shipping to production.
  • /deprecate — deprecation lifecycle: code-as-liability mindset, compulsory vs advisory classification, zombie code removal via the Beyonce Rule. Triggered when removing old systems or migrating callers off an interface.
  • /launch — pre-launch readiness gate: four-item checklist (observability wired, rollback tested, flag off-switch confirmed, staged rollout plan written), feature flag lifecycle table (created → dark launch → staged rollout → full rollout → flag removed).
  • /ci-cd — CI/CD pipeline authoring: Shift Left, Faster is Safer, quality gate pipeline (lint → typecheck → test → build → deploy, each blocks the next), failure feedback loops (no "ship anyway" bypass).
  • /document-decision — ADR trigger workflow: when to write and how to execute. References ### CHANGELOG + ADR shapes in CLAUDE.md; does not redefine the format.

Post-review fixes (0.22.1)

Adversarial review found 5 behavioral defects, all fixed before release:

  1. /deprecate — zombie check ran after compulsory deletion (ordering inverted); now runs before via Beyonce Rule in step 2.
  2. /deprecate — advisory zombie-check failure routed to the compulsory removal path; now extends the deprecation window.
  3. /observe — step 6 was missing PII scan and alert-symptom verification (both checklist items with no process step); added.
  4. /ci-cd — feedback loop closure missing ("confirmed re-run unblocked merge" in checklist but no step); step 7.5 added.
  5. /document-decision — CLAUDE.md section referenced as adr-shape / changelog-shape; corrected to ### CHANGELOG + ADR shapes.

Plugin version

developer-workflows 0.21.2 → 0.22.1

Full changelog: see CHANGELOG.md