local-sync

📋 TEMPLATE: This command is a template. See "Customization Guide" below to adapt for your infrastructure.

Perform complete local development environment sync after pulling from dev branch. This ensures dependencies, database, and validation are all up-to-date.

Workflow

1. Git Branch Cleanup (Best Practice)

Check current branch and switch to dev if needed:

CURRENT_BRANCH=$(git branch --show-current)
echo "Current branch: $CURRENT_BRANCH"

If on feature branch:

• Check for uncommitted changes
• If clean, switch to dev: git checkout dev
• If dirty, offer to stash: git stash && git checkout dev
• Save feature branch name for cleanup

Switch to dev branch:

git checkout dev

2. Git Pull

Pull latest changes from origin/dev:

git pull origin dev

If pull fails due to uncommitted changes:

• Stash changes: git stash
• Pull again
• Reapply stash: git stash pop

3. Branch Cleanup (Git Best Practice)

After pulling latest dev, clean up merged branches:

Check if previous feature branch is merged:

# If we switched from a feature branch, check if it's merged
git branch --merged dev | grep -v "^\*" | grep -v "dev" | grep -v "master"

Offer to delete merged feature branch:

# Example: {{TICKET_PREFIX}}-381-rename-slash-commands-remote-prefix
git branch -d {{TICKET_PREFIX}}-381-rename-slash-commands-remote-prefix

Prune remote tracking branches:

# Remove stale remote tracking branches
git fetch --prune origin

List stale local branches:

# Show branches not updated in 30+ days
git for-each-ref --sort=-committerdate refs/heads/ --format='%(refname:short) | %(committerdate:relative)' | grep -E 'weeks|months|years' ago

Offer to delete stale branches (interactive)

4. Smart Change Detection

Detect what changed to determine necessary steps:

# Check if package.json changed
DEPS_CHANGED=$(git diff HEAD@{1} HEAD -- package.json yarn.lock)

# Check if prisma schema changed
SCHEMA_CHANGED=$(git diff HEAD@{1} HEAD -- prisma/schema.prisma prisma/migrations/)