Git Commit Workflow (Worktree-Aware)

Prerequisites

Verify you're in a worktree (not main clone):

git rev-parse --show-toplevel
git worktree list

Workflow

Step 1: Analyze Changes

git diff --name-only
git diff --cached --name-only

Step 2: Format & Lint

# Format changed Python files
python -m black <changed_python_files>
python -m isort <changed_python_files>

# Fix license headers
python tests/lint/fix_license_header.py <changed_files>

# Lint
python -m pylint <changed_python_files> --rcfile=.pylintrc -rn -sn
python -m mypy <changed_python_files> --ignore-missing-imports

Step 3: Run Tests

python -m pytest tests/ -v --tb=short

Step 4: Review (use code-review skill)

Follow .ai-instructions/code-review/generic.md checklist.

Step 5: Stage Changes

git add path/to/changed/files
git diff --staged  # Final review

Never stage: __pycache__/, .env, *.egg-info/, build artifacts, coverage files

Step 6: Commit

Format: type(scope): description (72 chars max)

Types: feat, fix, refactor, test, docs, style, chore, perf

git commit -m "type(scope): description

Detailed explanation if needed.

Fixes #ISSUE_NUMBER"

No AI co-author lines. (per .ai-instructions/developing/commit-guidelines.md)

Step 7: Verify

git show HEAD --name-only
git log -1