Conventional Commits

Follow these project-specific rules when creating commits.

Branching

Never create bare branches. If you need branch isolation, use the worktree skill. For simple changes, commit directly on the current branch (including main). Do not run git checkout -b.

Project Rules

• One commit per logical change — never combine unrelated fixes or features. Three independent changes = three commits.
• Only commit files you changed — never pull in unrelated files from concurrent sessions.
• Always include a body — no title-only commits. Explain what and why.
• merge type — use merge (not a merge commit) when merging a worktree or feature branch.
• Sequence commits to maximise option value — foundational infrastructure first, then features that build on it.

Example