Git Workflow & Safety Protocols
1. Safety & Confirmation
1.1 Dangerous Operations
Explicit user confirmation is REQUIRED for:
git commit(unless user pre-authorized)git pushgit reset --hardgit clean -fdgit checkout(if current branch has changes)
1.2 Command Standards
- Atomic Commits: One logical change per commit.
- No Parallel Git: Git relies on the index lock. Never run multiple git commands in parallel.
- Rollback Protocol:
checkoutrollbacks require confirmation.
2. Conventional Commits Specification
Format: <type>(<scope>): <subject>
Supported Input Parameters (Mental Model):
- Action: enum [commit, push, branch, log, status]
- Commit Type: enum [feat, fix, docs, style, refactor, perf, test, build, ci, chore, revert]
- Commit Scope: string (optional, e.g., auth, api, ui)
- Commit Message: string (max 50 chars)
| Type | Description |
|---|---|
feat |
A new feature |
fix |
A bug fix |
docs |
Documentation only changes |
style |
Changes that do not affect the meaning of the code (white-space, formatting, etc) |
refactor |
A code change that neither fixes a bug nor adds a feature |
perf |
A code change that improves performance |
test |
Adding missing tests or correcting existing tests |
build |
Changes that affect the build system or external dependencies |
ci |
Changes to our CI configuration files and scripts |
chore |
Other changes that don't modify src or test files |
revert |
Reverts a previous commit |
3. Branching Strategy
- Feature Branches:
feat/short-description - Bugfix Branches:
fix/issue-id-description - Chore Branches:
chore/description
Converted and distributed by TomeVault — claim your Tome and manage your conversions.