day-one-patch

Day-One Patch

Between the build that went to certification and the build users see at launch, problems show up — late-breaking telemetry, a cert reviewer finding, a marketing copy change. This skill scopes a focused mini- sprint patch, runs it through QA, and lands it on the user before they even notice the gap.

---

Phase 1: Source the Patch Scope

Resolve the source build:

• --from=<release-tag> -> read that tag.
• Otherwise consult production/releases/release-checklist-*.md for the latest release version and use its tag.

Source the candidate patch list from any of:

• --bug-list=<paths> -> explicit list.
• Recent BUG records filed since the release tag in production/qa/bugs/.
• Recent S1/S2 issues triaged in production/qa/triage-*.md.
• App Store / Play review feedback (if pasted by user).
• Late-breaking telemetry alerts (Sentry / Crashlytics digest).

Render the candidate list with severity, frequency (if known), and origin source.

---

Phase 2: Filter to Day-One Scope

Apply the day-one bar — only fixes that meet ALL of these qualify:

• Severity S1 or S2.
• Reproducible.
• Fix is small (< 2 days of engineering, ideally < 1).
• Fix is low-risk (touches a small, well-understood area).
• Fix has a regression test plan.

Any candidate failing the bar is either downgraded to a normal sprint, escalated to /hotfix, or rejected.

Use AskUserQuestion to confirm scope:

question: "Day-one scope candidates (top severity first):"
options:
  - "Accept the proposed scope"
  - "Add: [user provides]"
  - "Drop: [user provides]"
  - "Cancel — these are not day-one items"

---

Phase 3: Risk Assessment

For the agreed scope, run the patch-risk checklist:

• Each fix has a clear blast radius (which features, which user cohort).
• Combined diff stays under [project threshold, default 500 LOC].
• No fix changes the public API surface.
• No fix changes the on-disk data schema.
• No fix touches payment flow without a payments specialist on review.
• No fix touches auth flow without a security review.
• No fix is bundled with a feature change — patch is fixes only.