Git Workflows
Use repository evidence before applying a generic workflow. Treat local history, remote state, and hosting-platform state as separate sources of truth.
Principles
- Start with read-only inspection and identify the repository's own conventions.
- Preserve unrelated work and make the smallest reversible change.
- Require explicit authorization for writes to history, remotes, branches, PR state, or other collaborators' surfaces.
- Verify the exact resulting diff, history, remote state, and checks that matter to the requested outcome.
- Prefer Git's current help and repository tooling over copied command recipes.
Route
- Commit scope and messages: read
references/commits.md. - Clone and repository setup: read
references/repositories.md. .gitignorecreation or repair: readreferences/gitignore.md.- Branch, worktree, stash, and ref cleanup: read
references/cleanup.md. - Draft, ready, review, and merge decisions: read
references/pull-requests.md.
Load only the references needed for the request. Specialized PR skills remain authoritative for their narrower workflows.
Related skills
vp-stacked-prfor dependent branches or pull requests.vp-pr-briefingfor understanding an unfamiliar pull request before acting.vp-githubfor attachments, Markdown rendering, and GitHub credential boundaries.vp-pr-comment-resolverfor author-side PR feedback.vp-pr-review-followupfor reviewer-side PR follow-up.