Git Workflow

Inspired by: wshobson/commands — adapted for Alexey's projects

Conventional Commits — Message Format

type(scope): brief description

Examples:
feat(auth): add JWT authentication
fix(bot): fix message_callback handling
refactor(routes): extract logic into services
chore(deps): update @maxhub/max-bot-api to 0.3.0
deploy: update staff-bot in production

Standard Cycle

# 1. See what changed
git status
git diff

# 2. Add files (not everything — only what is needed)
git add server/routes/feature.js
git add public/app.html
# NOT: git add .env  ← never!

# 3. Commit
git commit -m "feat(feature): add new endpoint"

# 4. Push
git push origin main

# 5. Deploy → see deploy skill

Rolling Back Changes

# Undo last commit (files remain)
git reset --soft HEAD~1

# View a specific commit
git show abc1234

# Restore a file from last commit
git checkout HEAD -- server/routes/auth.js

# Rollback in production (via rsync of old version)
git checkout abc1234  # old commit locally
rsync -avz ... # deploy old version

.gitignore — Mandatory Minimum

node_modules/
.env
.env.local
*.log
dist/
.DS_Store

Pre-Commit Check

# Any secrets in staged files?
git diff --cached | grep -i "password\|token\|secret\|key"

# Status after add
git status

Common Mistakes