Skip to content

docs: add lessons learned from v0.4.0-alpha.4 release to release-manager skill#560

Open
DamianReeves wants to merge 1 commit intomainfrom
docs/release-manager-lessons-learned
Open

docs: add lessons learned from v0.4.0-alpha.4 release to release-manager skill#560
DamianReeves wants to merge 1 commit intomainfrom
docs/release-manager-lessons-learned

Conversation

@DamianReeves
Copy link
Member

Summary

  • Added comprehensive "Lessons Learned (v0.4.0-alpha.4)" section to the release-manager skill
  • Documents key insights about cross-module dependencies, go.mod version management, and workspace setup
  • Added new principle "Consult This Runbook First" to emphasize checking the release procedure before making changes
  • Includes checklist for cross-module releases

Changes

  • Updated .claude/skills/release-manager/SKILL.md with:
    • Lessons learned section covering cross-module dependencies, go.mod references, workspace setup issues
    • External consumption test behavior on release branches
    • Release retry process guidance
    • New key principle about consulting the runbook first

Context

This documents the issues encountered and resolved during the v0.4.0-alpha.4 release, including:

  • GoReleaser dirty git state from go work sync
  • Cross-module dependency resolution timing
  • Two-stage release pattern for features spanning multiple modules

…ger skill

Key additions:
- Cross-module dependencies and two-stage release pattern
- Go.mod version reference management
- Workspace setup issues with go work sync
- External consumption test behavior on release PRs
- Release retry process
- Checklist for cross-module releases
- New principle: Consult runbook before making release process changes
@netlify
Copy link

netlify bot commented Jan 14, 2026

Deploy Preview for angry-raman-7c44f6 canceled.

Name Link
🔨 Latest commit aef7dee
🔍 Latest deploy log https://app.netlify.com/projects/angry-raman-7c44f6/deploys/6966e4af98ef140008964ee1

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant