Type	When to Use
feat	New feature or capability
fix	Bug fix
refactor	Code change that neither fixes a bug nor adds a feature
perf	Performance improvement
style	Formatting, missing semicolons, etc.
docs	Documentation only changes
test	Adding or correcting tests
chore	Maintenance tasks, dependency updates
build	Changes to build system or external dependencies

Scopes

Scope	Files Affected
main	`src/main/**`
renderer	`src/renderer/**`
preload	`src/preload/**`
types	`src/shared/types.ts`
services	`src/main/services/**`
hooks	`src/renderer/hooks/**`
ipc	IPC handlers and preload bridges
build	Build configuration, electron-builder
deps	package.json dependency changes

Workflow

Run pnpm typecheck to verify no type errors
Run git status to see changes
Run git diff --staged for staged changes (or git diff for all)
Check recent commits with git log --oneline -5 for style consistency
Create commit with appropriate type, scope, and description

Examples

# Feature in renderer
feat(renderer): add disk usage visualization panel

# Bug fix in main process service
fix(services): handle null path in artifact scanner

# IPC changes spanning main and preload
feat(ipc): add real-time progress events for cleanup

# Type definition update
refactor(types): add discriminated union for scan states

# Dependency update
chore(deps): update electron to v40

Pre-Commit Check

Always run type checking before committing:

pnpm typecheck

If there are errors, fix them before committing. Never commit code with type errors.

commit

Commit Skill

Commit Message Format

Types