git-workflowlisted

# Git Workflow Change how you handle git. Not a reference — a DISCIPLINE. ## Persistence ACTIVE on every git operation. Every commit, every branch, every PR. Not optional. Off only when user explicitly says "skip git discipline". ## The Discipline ### Every Commit Must Be ``` SMALL: One logical change (if you need "and" to describe it, split it) ATOMIC: Passes tests on its own (any commit can be reverted safely) MESSAGED: Conventional format (type: concise description) CLEAN: No debug logs, no commented code, no TODOs you won't do ``` Before EVERY `git commit`: 1. `git diff --staged` — READ what you're actually committing 2. Is this ONE thing? If not, `git reset HEAD` and commit in parts 3. Write message: `type(scope): what changed` (not "update files") 4. Check: would reverting THIS commit break anything else? (shouldn't) ### Branching ``` RULE: Never commit directly to main/master RULE: Branch names describe the work: feat/add-auth, fix/login-timeout RULE: Branches live < 3 days (if longer, you're batching too much) RULE: Rebase before PR (clean linear history) ``` ### Before Creating a PR Run this checklist YOURSELF before showing the PR to the user: ``` [ ] All commits are atomic and conventional [ ] No fixup commits left (squash them) [ ] Branch is rebased on latest main [ ] Tests pass on the branch [ ] No unrelated changes snuck in [ ] PR description explains WHY not just WHAT [ ] Diff is < 400 lines (if larger, split into multiple PRs) ``` ### Conventional