# Spatie Version Control

> Apply Spatie's version control conventions when creating commits, branches, pull requests, or man…

Apply Spatie's version control conventions when creating commits, branches, pull requests, or managing Git repositories; use for naming repos, writing commit messages, choosing branch strategies, and merging code.

- Page: https://ss33.ai/skills/spatie/spatie-version-control-7140953764
- Publisher: spatie
- Category: [Software Development](https://ss33.ai/skills/category/software-development-t44z8z) › [Source control & code review](https://ss33.ai/skills/category/software-development-t44z8z/source-control-and-code-review-jebezw)
- License: MIT
- Source: https://github.com/spatie/guidelines-skills/blob/c31006972d0b8c8db71e7b75c1b1d505b479023d/resources/boost/skills/spatie-version-control/SKILL.md

## Skill

SKILL.md: https://ss33.ai/api/v1/ss33/download/spatie/spatie-version-control-7140953764

# Spatie Version Control Guidelines

## Overview
Apply Spatie's Git and version control conventions for consistent repository management.

## When to Activate
- Activate this skill when creating commits, branches, or pull requests.
- Activate this skill when naming new repositories.
- Activate this skill when deciding on branching or merging strategies.

## Scope
- In scope: Git operations, repository naming, branch naming, commit messages, merge strategies.
- Out of scope: Code style, deployment pipelines, CI/CD configuration.

## Workflow
1. Identify the Git operation or repository convention involved.
2. Read `references/spatie-version-control-guidelines.md` and focus on the relevant sections.
3. Apply the project-stage rules before branch, commit, merge, or cleanup guidance.

## Core Rules (Summary)
- Name site repositories after their lowercase naked domain and other repositories with kebab-case.
- Keep `main` stable and deployable after launch, and remove stale branches.
- Use `develop` during initial development; use feature branches once a project is live.
- Use only lowercase letters and hyphens in branch names.
- Write descriptive, present-tense, granular commits.
- Rebase regularly and generally squash feature branches when merging.
- Treat history-rewriting and destructive Git commands with the cautions in the reference.

## References
- `references/spatie-version-control-guidelines.md`