release-patterns

Release Patterns Skill

TEMPLATE: This skill uses {{PLACEHOLDER}} tokens. Replace with your project values before use.

Purpose

Ensure consistent PR creation, CI/CD validation, and release coordination following rebase-first workflow.

When This Skill Applies

• Creating pull requests
• Running pre-PR validation
• Checking CI/CD status
• Coordinating merge timing
• Verifying rebase status

Stop-the-Line Conditions

FORBIDDEN Patterns

# FORBIDDEN: Missing ticket reference
gh pr create --title "feat: add feature"  # Missing [{{TICKET_PREFIX}}-XXX]

# FORBIDDEN: Using squash/merge commits (breaks linear history)
gh pr merge --squash
gh pr merge --merge

# FORBIDDEN: Skipping CI validation
git push origin feature  # Without {{CI_VALIDATE_COMMAND}} first

# FORBIDDEN: Pushing without rebase
git push origin feature  # When branch is behind {{MAIN_BRANCH}}

CORRECT Patterns

# CORRECT: Ticket reference in title
gh pr create --title "feat(scope): description [{{TICKET_PREFIX}}-XXX]"

# CORRECT: Rebase merge only
gh pr merge --rebase --delete-branch

# CORRECT: CI validation before push
{{CI_VALIDATE_COMMAND}} && git push --force-with-lease

# CORRECT: Always rebase first
git fetch origin && git rebase origin/{{MAIN_BRANCH}}
git push --force-with-lease origin {{TICKET_PREFIX}}-XXX-description

Pre-PR Checklist (MANDATORY)

Before creating any PR:

• Branch name: {{TICKET_PREFIX}}-{number}-{description}
• Commits follow: type(scope): description [{{TICKET_PREFIX}}-XXX]
• Rebased on latest {{MAIN_BRANCH}}: git fetch origin && git rebase origin/{{MAIN_BRANCH}}
• CI passes locally: {{CI_VALIDATE_COMMAND}}
• Linear history: No merge commits (git log --oneline --graph -10)

CI/CD Validation Command

# MANDATORY before any PR
{{CI_VALIDATE_COMMAND}} && echo "READY FOR PR" || echo "FIX ISSUES FIRST"

PR Creation Template

gh pr create --title "feat(scope): description [{{TICKET_PREFIX}}-XXX]" --body "$(cat <<'EOF'
## Summary

Implements [feature/fix] as specified in ticket {{TICKET_PREFIX}}-XXX.

**Ticket**: https://linear.app/{{LINEAR_WORKSPACE}}/issue/{{TICKET_PREFIX}}-XXX

## Changes Made

- Change 1
- Change 2

## Testing

{{CI_VALIDATE_COMMAND}}
# All checks passed

## Pre-merge Checklist

- [x] Rebased on latest {{MAIN_BRANCH}}
- [x] CI passes
- [x] Ticket referenced
EOF
)"