Loading...
Loading...
Use after completing a task when all verifications pass, to commit the work, or when cutting a GitHub release. Covers the verification gate, splitting into logical commits, staging, the house commit-message format (no Co-Authored-By trailers), and release tagging.
npx skill4agent add snowfluke/engineering-skills git-commitpackage.jsonMakefilejustfilecargogomixpytestbun run type-check
bun test
bun run lint
bun run fmtgit status
git diff --stat# Commit 1: the fix
git add src/auth/session.ts tests/auth/session.test.ts
git commit -m "fix(auth): handle expired refresh token gracefully"
# Commit 2: the version bump (separate intent)
git add package.json jsr.json
git commit -m "chore: bump version to 5.4.2"git add -Agit add apps/api/src/modules/projects/
git add apps/api/src/db/migrations/0003_add_project_archive.sql
# etc..env*.pembun.lockpackage-lock.jsonCargo.lockgo.sumpoetry.lockdist/.next/target/build/__pycache__/CONTRIBUTING.mdcommitlint.config.*git log --oneline -20<type>(<scope>): <subject>| Type | Use when |
|---|---|
| New feature or behavior |
| Bug fix |
| Code change with no behavior change |
| Adding or fixing tests |
| Documentation changes only |
| Build config, tooling, dependency updates |
| Performance improvement |
authtasksganttdbcitype(scope): subject [ID][BE-S2-02]@<name>@<digit>@somethingv4v5major 4`@4`awk 'length > 80 { print "TOO LONG (" length "): " $0 }' /tmp/commit-msg.txt
git commit -F /tmp/commit-msg.txtawkecho -n "chore(auth): remove readme artifact and fix ErrorBoundary [FE-AUTH-06]" | wc -c
# must be 80 or fewergit commit -m "feat(projects): add project creation endpoint [BE-S2-02]"git commit -m "feat(tasks): enforce finish-to-start dependency [BE-S3-03]
Task B's checkbox is disabled when its prerequisite (Task A) is
not yet in completed status. Auto-unlock triggers after Task A
completes, changing Task B from locked to ready."Co-Authored-Bygit log --oneline -5chore: release vX.Y.Zgh release create vX.Y.Z --target main --title "vX.Y.Z" --notes-file notes.mdversion_tags_signedgh release create --targettag.gpgSign=true--targetgit tag -s vX.Y.Z <commit> -m "vX.Y.Z" # signed (gpg or ssh-format key)
git push origin vX.Y.Z
gh release create vX.Y.Z --title "vX.Y.Z" --notes-file notes.md # no --target
git verify-tag vX.Y.ZvX.Y.Zrelease-notes@<name>@<digit>v4npm view <pkg> versionmeta.json.env*.pemecho -n "..." | wc -c@<name>@<digit>v5# Good
feat(tasks): add dependency enforcement on task completion [BE-S3-03]
fix(auth): handle expired refresh token gracefully
test(projects): add service unit tests for template change [BE-S2-11]
chore(ci): add coverage threshold check to CI workflow
docs(onboarding): update setup steps for Docker dev environment
chore: bump demo CDN pin from v4 to v5
# Bad
update code
fix bug
WIP
added the task thing
chore: bump demo CDN pin from @4 to @5 # `@4`/`@5` become user mentions
fix: do thing and also bump version # two intents: split into two commits