init: ai-prompts repo with project briefings and onboarding prompts
This commit is contained in:
55
general/git-conventions.md
Normal file
55
general/git-conventions.md
Normal file
@@ -0,0 +1,55 @@
|
||||
# Git Commit Conventions
|
||||
|
||||
Standard commit message format used across all repos on this Gitea instance.
|
||||
|
||||
## Format
|
||||
|
||||
```
|
||||
type: short description (max 72 chars)
|
||||
|
||||
Optional longer body explaining WHY, not what.
|
||||
```
|
||||
|
||||
## Types
|
||||
|
||||
| Type | Use for |
|
||||
|------|---------|
|
||||
| `init` | First commit in a repo |
|
||||
| `feat` | New feature or capability |
|
||||
| `fix` | Bug fix |
|
||||
| `update` | Enhancement to existing feature |
|
||||
| `chore` | Maintenance — deps, config, ignores |
|
||||
| `docs` | Documentation only |
|
||||
| `refactor` | Code restructure, no behaviour change |
|
||||
| `remove` | Deleting files or features |
|
||||
| `deploy` | Deployment-related changes |
|
||||
|
||||
## Examples
|
||||
|
||||
```
|
||||
init: initial dotfiles
|
||||
feat: add automount for NAS share
|
||||
fix: correct SSH config hostname typo
|
||||
update: extend deploy script to restart php-fpm
|
||||
chore: add .gitignore for node_modules
|
||||
docs: add README for arduino sketches
|
||||
remove: drop legacy rsync deploy script
|
||||
```
|
||||
|
||||
## Branch Naming
|
||||
|
||||
```
|
||||
main / master — stable, production-ready
|
||||
dev — active development
|
||||
feature/NAME — specific feature work
|
||||
fix/NAME — specific bug fix
|
||||
```
|
||||
|
||||
## Tags (for deployments)
|
||||
|
||||
```
|
||||
v1.0.0 — major release
|
||||
v1.2.0 — minor feature addition
|
||||
v1.2.1 — patch / hotfix
|
||||
deploy-YYYYMMDD — deployment snapshot
|
||||
```
|
||||
Reference in New Issue
Block a user