Git Workflow

Agents can change code quickly, which makes git discipline more important, not less important.

Good Defaults

• keep changes small and reviewable
• commit one logical change at a time
• run checks before committing
• use separate branches or worktrees for parallel tasks

Worktrees For Parallel Agent Work

If multiple agents or sessions need to work in parallel, use git worktrees so they do not collide in the same checkout.

git worktree add ../feature-auth feature/auth
git worktree add ../feature-billing feature/billing

Commit Rules Worth Writing Down

Add these to your repo instructions:

• use conventional commits such as feat:, fix:, docs:, and test:
• do not batch unrelated changes into one commit
• only commit when the relevant checks pass
• keep PR descriptions short and specific

Agent-Assisted Review

Agents are useful reviewers when you give them a narrow job:

• look for regressions
• look for missing tests
• look for security or trust-boundary mistakes
• check whether the diff matches the requested scope

Practical Rule

Use agents to speed up branch work and review prep. Do not use them to skip human judgment on merges.