Skip to content

Add release TODO checks to the release script - #2945

Merged
kuzdogan merged 1 commit into
stagingfrom
feat/release-todos
Aug 27, 2026
Merged

Add release TODO checks to the release script#2945
kuzdogan merged 1 commit into
stagingfrom
feat/release-todos

Conversation

@kuzdogan

Copy link
Copy Markdown
Member

Summary

Manual steps around a production deploy were easy to forget, because the release script only looked at package versions. Migrations are applied by hand, and the "Deploy latest to production" PR had an empty body. See the discussion on #2937 (drop idx_code_code_first_75).

This adds scripts/release/release_todos.sh, wired into main.sh:

  • .release-todos/<pr-number>-<short-name>.md files with optional ## before and ## after sections. before items are shown at the start of the release, after items once the deploy PR is merged. The script deletes the files on the release branch, so the directory only holds open items.
  • New migration files since the last deploy are listed automatically, with a reminder to apply them on staging and production.
  • TODO_RELEASE markers in added lines are listed as a safety net.
  • All collected items become the body of the "Deploy latest to production" PR, so its reviewer sees the same list.

Everything is scoped to git diff master...staging, so an item shows up for exactly one release.

Notes

  • .release-todos/README.md documents the format. services/database/README.md and CLAUDE.md now say that every migration PR must add such a file.
  • Not included: a CI check that fails a migration PR without a .release-todos/ file. Can follow in a separate PR.

🤖 Generated with Claude Code

Manual steps around a production deploy (migrations, load balancer or
Cloud Run settings, secrets, follow-up scripts) were easy to forget
because the release script only looked at package versions.

- .release-todos/<pr>-<name>.md files with optional '## before' and
  '## after' sections; shown at the start / after the deploy PR merge,
  then deleted on the release branch
- automatic listing of new migration files since the last deploy
- TODO_RELEASE marker grep, scoped to git diff master...staging
- collected items become the body of the 'Deploy latest to production' PR

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@kuzdogan kuzdogan moved this from Triage to Sprint - Needs Review in Sourcify Public Aug 26, 2026

@marcocastignoli marcocastignoli left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I didn't test it, but I think this is a very clean solution!

@kuzdogan
kuzdogan merged commit d263534 into staging Aug 27, 2026
10 of 11 checks passed
@github-project-automation github-project-automation Bot moved this from Sprint - Needs Review to Sprint - Done in Sourcify Public Aug 27, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: Sprint - Done

Development

Successfully merging this pull request may close these issues.

2 participants