Template

Files

lmiranda 4ba38eb620 refactor: update internal command references in all plugin files

Updated:
- projman: 4 commands + 4 skills + integration snippet
- git-flow: 4 commands + 3 skills + integration snippet
- pr-review: 1 command cross-reference
- cmdb-assistant: 1 command + 1 skill
- data-platform: 8 commands + integration snippet
- viz-platform: 11 commands + integration snippet
- contract-validator: 1 command + 1 skill + 1 agent

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

2026-02-03 21:16:00 -05:00

2.2 KiB

Raw Permalink Blame History

Sync Workflow

Purpose

Defines push/pull patterns, rebase strategies, upstream tracking, and stale branch detection.

When to Use

Pushing commits in /git-commit-push
Full sync operations in /git-commit-sync
Detecting and reporting stale branches

Push Workflow

First Push (No Upstream)

git push -u origin <branch>

Sets upstream tracking for future pushes.

Subsequent Pushes

git push

Pushes to tracked upstream.

Push After Rebase

git push --force-with-lease

Safe force push - fails if remote has new commits.

Sync with Base Branch

# 1. Fetch all with prune
git fetch --all --prune

# 2. Rebase on base branch
git rebase origin/<base-branch>

# 3. Push (force if rebased)
git push --force-with-lease

Push Conflict Handling

When push fails due to diverged history:

Remote has changes not in your local branch.

Options:
1. Pull and rebase, then push (Recommended)
2. Pull and merge, then push
3. Force push (destructive - requires confirmation)
4. Cancel and review manually

Rebase Resolution

git pull --rebase origin <branch>
git push

Merge Resolution

git pull origin <branch>
git push

Stale Branch Detection

Find local branches tracking deleted remotes:

git branch -vv | grep ': gone]'

Report Format

Stale local branches (remote deleted):
  - feat/old-feature (was tracking origin/feat/old-feature)
  - fix/merged-bugfix (was tracking origin/fix/merged-bugfix)

Run /branch-cleanup to remove these branches.

Remote Pruning

Remove stale remote-tracking references:

git fetch --prune

Or fetch all remotes:

git fetch --all --prune

Sync Status Report

Sync complete:

Local:  feat/password-reset @ abc1234
Remote: origin/feat/password-reset @ abc1234
Base:   development @ xyz7890 (synced)

Your branch is up-to-date with development.
No conflicts detected.

Cleanup:
  Remote refs pruned: 2
  Stale local branches: 2 (run /branch-cleanup to remove)

Tracking Setup

Check tracking status:

git branch -vv

Set upstream:

git branch --set-upstream-to=origin/<branch> <branch>

skills/git-safety.md
skills/merge-workflow.md

2.2 KiB Raw Permalink Blame History