Assisted-by: DeepSeek Harness (claude-opus-5-5, deepseek-flash, qwen3.8-flash-next iq3, gpt-6.1-sol, gpt-6-luna)
2.1 KiB
Git delivery examples
Illustrative messages that follow SKILL.md. Repository conventions still decide prefixes and trailers. Keep the important consequence in the commit; use the PR for context and review details.
A self-explaining change
feat(cli): add a --json flag to the status command
The flag explains its effect. Which script asked for machine-readable output belongs in the PR, not a commit body.
A deletion outside the diff
fix(logs): delete rotated logs older than seven days
Every nightly run deletes rotated logs older than seven days, including unshipped ones.
Logs already shipped to the archive are unaffected.
The body names the runtime deletion and what survives. These consequences matter when someone investigates missing logs; file lists and debugging history do not.
A stored format changes meaning
fix(config): store the sync interval as a duration string
Integer intervals are read as seconds once and rewritten on the next save.
Clients older than 2.4 cannot read the rewritten value.
The body records the compatibility effect. Upgrade order and measured impact belong in the PR when they help review.
Cite the commit being fixed
fix(logs): keep unshipped logs during rotation
Rotation skips unshipped logs again; logs it already deleted cannot be recovered.
Refs: 9f8e7d6 (fix(logs): delete rotated logs older than seven days)
A hash with its subject identifies the earlier change without a lookup. Use the repository's trailer format; required disclosure follows the body too.
Separate PR review points
Rotation keeps unshipped logs, so a slow archive upload no longer loses them. Review the shipping
check in `rotate.py` first.
- Logs deleted before this change cannot be recovered.
- Disk use grows while the archive is unreachable; the existing disk alert still fires at 90%.
- The rotation test now covers an unshipped log; no host has run the new rotation yet.
Distinct points get separate lines. Word limits bound the content; useful paragraph breaks and bullets do not spend that budget.