Skip to content

docs: add release plan for CF go-live 2026-06-15#144

Open
mlehotskylf wants to merge 21 commits into
mainfrom
docs/release-plan-v2
Open

docs: add release plan for CF go-live 2026-06-15#144
mlehotskylf wants to merge 21 commits into
mainfrom
docs/release-plan-v2

Conversation

@mlehotskylf

@mlehotskylf mlehotskylf commented Jun 12, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor

Summary

  • Adds docs/release-plan.md with the full go-live plan for Monday 2026-06-15
  • Covers Friday prep tasks (Stripe, mentorship-sync, Mandrill key, validation script), Monday go-live sequence, manual smoke test checklist, post-launch backlog (Intercom, AI docs, e2e gaps), and rollback procedure

No code changes — docs only

🤖 Generated with Claude Code

@mlehotskylf mlehotskylf requested a review from lewisojile as a code owner June 12, 2026 23:32
Copilot AI review requested due to automatic review settings June 12, 2026 23:32
Copilot AI reviewed Jun 12, 2026
View reviewed changes

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds a standalone release/go-live runbook for the Crowdfunding (CF) production cutover, intended to coordinate Friday prep, Monday go-live steps, smoke testing, and rollback planning across engineering and DevOps.

Changes:

  • Added docs/release-plan.md detailing pre-launch tasks (Stripe, mentorship sync, Mandrill, migration validation), go-live sequencing, and verification steps
  • Documented a manual smoke test checklist and known E2E coverage gaps
  • Included post-launch backlog items and a rollback procedure

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread docs/release-plan.md Outdated
Comment thread docs/release-plan.md Outdated
Comment thread docs/release-plan.md Outdated
Copilot AI review requested due to automatic review settings June 13, 2026 00:00
Copilot AI reviewed Jun 13, 2026
View reviewed changes

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated 7 comments.

Comment thread docs/release-plan.md
Comment thread docs/release-plan.md
Comment thread docs/release-plan.md Outdated
Comment thread docs/release-plan.md Outdated
Comment thread docs/release-plan.md Outdated
Comment thread docs/release-plan.md Outdated
Comment thread docs/release-plan.md
Copilot AI review requested due to automatic review settings June 13, 2026 00:46
Copilot AI reviewed Jun 13, 2026
View reviewed changes

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated 3 comments.

Comment thread docs/release-plan.md
Comment thread docs/release-plan.md Outdated
Comment thread docs/release-plan.md Outdated
Copilot AI review requested due to automatic review settings June 13, 2026 01:20
Copilot AI reviewed Jun 13, 2026
View reviewed changes

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated 5 comments.

Comment thread docs/release-plan.md
Comment thread docs/release-plan.md Outdated
Comment thread docs/release-plan.md Outdated
Comment thread docs/release-plan.md Outdated
Comment thread docs/release-plan.md Outdated
Copilot AI review requested due to automatic review settings June 13, 2026 01:29
Copilot AI reviewed Jun 13, 2026
View reviewed changes

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated 3 comments.

Comment thread docs/release-plan.md
Comment thread docs/release-plan.md
Comment thread docs/release-plan.md Outdated
Copilot AI review requested due to automatic review settings June 13, 2026 01:38
Copilot AI reviewed Jun 13, 2026
View reviewed changes

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated 2 comments.

Comment thread docs/release-plan.md
Comment thread docs/release-plan.md Outdated
Copilot AI review requested due to automatic review settings June 13, 2026 02:02
@mlehotskylf mlehotskylf changed the title docs: add release plan for CF go-live 2026-06-16 docs: add release plan for CF go-live 2026-06-15 Jun 13, 2026
@mlehotskylf

mlehotskylf commented Jun 13, 2026

Copy link
Copy Markdown
Contributor Author

Review Feedback Addressed

Commit: dc8df1d

Changes Made

  • docs/release-plan.md: Corrected Stripe webhook URL from /v1/hooks/stripe to /v1/stripe/webhook — confirmed against backend/cmd/initiatives-api/server.go:168 (per copilot[bot])
  • docs/release-plan.md: Fixed script paths from db/scripts/ to backend/db/scripts/ — no top-level db/ directory exists (per copilot[bot])
  • docs/release-plan.md: Fixed kubectl logs command in GO12 — added -l app=initiatives-api --since=1h -f (per copilot[bot])
  • docs/release-plan.md: Corrected smoke test section header to reference GO9 (the URL forward step), not GO8 (per copilot[bot])
  • PR title/description: Updated date from 2026-06-16 to 2026-06-15, which is the actual Monday (per copilot[bot])

Declined

  • Table formatting: Leading pipe in GFM tables is standard syntax — renders correctly on GitHub (flagged by copilot[bot])
  • /lfx-intercom skill reference: Intentional — this is an internal Claude Code skill used by the team during development (flagged by copilot[bot])

Threads Resolved

22 of 22 unresolved threads addressed.

Copilot AI reviewed Jun 13, 2026
View reviewed changes

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated 2 comments.

Comment thread docs/release-plan.md
Comment thread docs/release-plan.md
@mlehotskylf

mlehotskylf commented Jun 13, 2026

Copy link
Copy Markdown
Contributor Author

⚠️ Pre-existing CI failure: `MegaLinter` is failing but is unrelated to this PR's changes.

The failures are in `backend/db/scripts/migrate_dynamo_to_postgres.py`:

  • `pylint`: `E0401: Unable to import 'boto3'` and `E0401: Unable to import 'psycopg2'` — third-party packages not installed in the linter environment
  • `black`: formatting diff in the existing migration script

This PR only modifies `docs/release-plan.md`. The same Python lint failures appear on the `feat/mentorship-sync` branch and are pre-existing. No action needed from this PR.

Copilot AI review requested due to automatic review settings June 13, 2026 02:22
Copilot AI reviewed Jun 13, 2026
View reviewed changes

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated 2 comments.

Comment thread docs/release-plan.md Outdated
Comment thread docs/release-plan.md Outdated
Copilot AI review requested due to automatic review settings June 14, 2026 04:14
Copilot AI reviewed Jun 14, 2026
View reviewed changes

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated no new comments.

@mlehotskylf mlehotskylf force-pushed the docs/release-plan-v2 branch from 79ce081 to 052076b Compare June 14, 2026 08:23
Copilot AI review requested due to automatic review settings June 14, 2026 08:25
Copilot AI reviewed Jun 14, 2026
View reviewed changes

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.

Comment thread docs/release-plan.md
mlehotskylf and others added 21 commits June 14, 2026 01:45
@mlehotskylf @claude
docs: add release plan for CF go-live 2026-06-16
5e32fb3 
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Signed-off-by: Michal Lehotsky <mlehotsky@linuxfoundation.org>
@mlehotskylf @claude
docs: polish release plan — fix dates, consolidate items, simplify st…
3af0576 
…ructure

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Signed-off-by: Michal Lehotsky <mlehotsky@linuxfoundation.org>
@mlehotskylf @claude
docs: link known gaps to LFXV2-2145
c40b0d2 
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Signed-off-by: Michal Lehotsky <mlehotsky@linuxfoundation.org>
@mlehotskylf @claude
docs: add prod deploy step, consolidate mentorship-sync items, remove…
c968e01 
… ledger-stats verify

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Signed-off-by: Michal Lehotsky <mlehotsky@linuxfoundation.org>
@mlehotskylf @claude
docs: add SS LaunchDarkly flag flip to go-live sequence
c9f23d0 
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Signed-off-by: Michal Lehotsky <mlehotsky@linuxfoundation.org>
@mlehotskylf @claude
docs: confirm CROWDFUNDING_API_BASE_URL already set in SS prod
79711b2 
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Signed-off-by: Michal Lehotsky <mlehotsky@linuxfoundation.org>
@mlehotskylf @claude
docs: simplify SS LD flag items — Michal owns the flip
a1f7081 
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Signed-off-by: Michal Lehotsky <mlehotsky@linuxfoundation.org>
@mlehotskylf @claude
docs: add weekend testing and data comparison for Michal, Lewis, Efren
2dc34f1 
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Signed-off-by: Michal Lehotsky <mlehotsky@linuxfoundation.org>
@mlehotskylf @claude
docs: link e2e tests to LFXV2-2073
fcad2bb 
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Signed-off-by: Michal Lehotsky <mlehotsky@linuxfoundation.org>
@mlehotskylf @claude
docs: clean up confirmed section, remove known gaps, update rollback
d819ab0 
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Signed-off-by: Michal Lehotsky <mlehotsky@linuxfoundation.org>
@mlehotskylf @claude
docs: update rollback — remove 2-week Lambda note, clarify Ledger/RS …
5fb5eda 
…dependency

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Signed-off-by: Michal Lehotsky <mlehotsky@linuxfoundation.org>
@mlehotskylf @claude
docs: clarify rollback — revert Ledger+RS restores old LFF Lambda
7f443c8 
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Signed-off-by: Michal Lehotsky <mlehotsky@linuxfoundation.org>
@mlehotskylf
docs: fix review feedback in release-plan.md
26e1400 
- Correct Stripe webhook URL: /v1/hooks/stripe → /v1/stripe/webhook (per copilot[bot])
- Fix script paths: db/scripts/ → backend/db/scripts/ (per copilot[bot])
- Fix kubectl logs command: add -l app=initiatives-api --since=1h -f (per copilot[bot])
- Fix smoke test header: references GO9 (forward step), not GO8 (per copilot[bot])

Signed-off-by: Michal Lehotsky <mlehotsky@linuxfoundation.org>
@mlehotskylf
fix(ci): fix MegaLinter failures
432499d 
- .markdownlint.json: add config disabling MD013 for tables/code blocks/headings
  (table rows cannot be wrapped; all other MD013 violations are pre-existing in
  backend/docs/rewrite/ and were previously unflagged due to missing config)
- docs/release-plan.md: wrap long paragraph to stay under 400-char limit
- .pylintrc: disable E0401 (import-error) — boto3/psycopg2 not installed in
  MegaLinter env; pyright already suppressed via backend/db/scripts/pyrightconfig.json
- backend/db/scripts/migrate_dynamo_to_postgres.py: apply black formatting

Signed-off-by: Michal Lehotsky <mlehotsky@linuxfoundation.org>
@mlehotskylf
Revert "fix(ci): fix MegaLinter failures"
025c810 
This reverts commit 5b8bbc4.

Signed-off-by: Michal Lehotsky <mlehotsky@linuxfoundation.org>
@mlehotskylf
docs: wrap long paragraph in release-plan.md
526c198 
Wraps the weekend testing paragraph to stay under the 400-char markdownlint
line limit.

Signed-off-by: Michal Lehotsky <mlehotsky@linuxfoundation.org>
@mlehotskylf
docs: fix kubectl commands in release-plan.md
b246dab 
- F-M4: expand second kubectl get pods to a full runnable command
- GO12: fix pod selector — chart uses app.kubernetes.io/name label,
  not app= (per copilot[bot])

Signed-off-by: Michal Lehotsky <mlehotsky@linuxfoundation.org>
@mlehotskylf
docs: fix go-live sequence ordering and maintenance mode gaps
a67cb16 
- Swap smoke test before URL forward: smoke test is now GO9, forward is GO10.
  Line 47 (DevOps Slack note) already said forward happens after smoke test
  confirms pass — the sequence now matches. (per @dealako)
- Update smoke test section header to reflect it runs before the forward,
  against the new CF domain directly. (per @dealako)
- Add explicit LFF maintenance mode exit to GO10 (happy path) and GO13
  (rollback), so the old site isn't left in a half-maintenance state.
  (per @dealako)

Signed-off-by: Michal Lehotsky <mlehotsky@linuxfoundation.org>
@mlehotskylf @claude
docs: remove go-live-checklist.md (superseded by release plan)
48cb347 
All items are now covered by docs/release-plan.md or already resolved.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Signed-off-by: Michal Lehotsky <mlehotsky@linuxfoundation.org>
@mlehotskylf @claude
docs: remove F-M2 (Stripe subscription retry setting) from release plan
965ae8f 
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Signed-off-by: Michal Lehotsky <mlehotsky@linuxfoundation.org>
@mlehotskylf @claude
docs: fix broken README link to go-live-checklist
857260a 
backend/docs/go-live-checklist.md was removed in this branch and
replaced by docs/release-plan.md. Update the README docs table to
point at the new file.

Fixes MegaLinter dead-link failure.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Signed-off-by: Michal Lehotsky <mlehotsky@linuxfoundation.org>
@mlehotskylf mlehotskylf force-pushed the docs/release-plan-v2 branch from fd246ad to 857260a Compare June 14, 2026 08:45
@mlehotskylf

mlehotskylf commented Jun 14, 2026

Copy link
Copy Markdown
Contributor Author

Review Feedback Addressed

Commit: 857260a

Changes Made

  • README.md:59 — updated broken link from deleted backend/docs/go-live-checklist.md to docs/release-plan.md (per copilot-pull-request-reviewer). This also fixes the MegaLinter dead-link failure.

@dealako blocking issue — GO9/GO11 ordering

Thanks for the careful re-review. I re-read the table against line 46 and believe the ordering is consistent:

  • GO9 = smoke test (run against new CF directly, before forwarding)
  • GO10 = URL forward + exit LFF maintenance mode
  • GO11 = flip LaunchDarkly flag in Self Serve

Line 46 says "once smoke test passes (GO9), set a forward... and exit LFF maintenance mode (GO10)" — which matches the table exactly. The smoke test runs first, then forwarding, then the LD flag. The smoke test section header also says "run against new CF before forwarding traffic", which is consistent with GO10 coming after GO9.

Could you point me to the specific line you see as contradictory? Happy to reword anything that reads ambiguously even if the logic is correct.

Pre-existing CI failure

  • MegaLinter Python lint (migrate_dynamo_to_postgres.py — missing boto3/psycopg2) — pre-existing, unrelated to this docs-only PR. No action taken.

Threads Resolved

1 of 1 unresolved threads addressed.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

Copilot code review Copilot Copilot left review comments

@lewisojile lewisojile Awaiting requested review from lewisojile lewisojile is a code owner

@emlimlf emlimlf Awaiting requested review from emlimlf emlimlf is a code owner

@dealako dealako Awaiting requested review from dealako dealako is a code owner

Requested changes must be addressed to merge this pull request.

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

3 participants

@mlehotskylf @dealako