Git Conventions

Commit Format

<type>(<scope>): <description>

One commit = one clear, revertable objective. No emoji prefix.

Allowed Types

Type	Usage
feat	New feature
fix	Bug fix
docs	Documentation only
refactor	Refactoring without behavior change
test	Adding or fixing tests
ci	CI/CD changes
build	Build / dependency changes
chore	Maintenance tasks

Allowed Scopes

main · renderer · preload · shared · ws · overlays · khinsider · timer · discord · security · perf · docs

Valid Examples

feat(renderer): add quick reconnect status badge
fix(ws): guard malformed overlay payload
refactor(main): split twitch auth callback helper
docs(docs): align agent commit rules
fix(security): bind oauth callback to 127.0.0.1 explicitly
chore(build): update electron to 35.x

Pre-commit Checklist

pnpm typecheck   # must pass without error
pnpm lint        # must pass without error
pnpm build       # must compile without error

Rules

• Do not mix unrelated topics in the same commit
• Description in English (international community)
• Title length: 72 characters max