ai: Prioritize succinct commit messages with optional lists
Add guidance to start with a single sentence, use lists only when multiple
distinct reasons require explanation, otherwise keep to one paragraph.
Assisted-by: Claude Haiku 4.5 via Claude Code
diff --git a/ai/claude/commands/commit.md b/ai/claude/commands/commit.md
index 860ec81c..7ec7d6be 100644
--- a/ai/claude/commands/commit.md
+++ b/ai/claude/commands/commit.md
@@ -13,15 +13,18 @@ When committing:
2. If a fileset is provided, use `jj commit <fileset>` to commit only
matching files
3. If no fileset is provided, use `jj commit` to commit all changes
-4. Invoke the `writing` skill for assistance with commit message style
-and conventions
+4. Use any available writing skills for assistance with commit message style
+and conventions (e.g., elements-of-style)
5. Draft a clear, concise commit message:
+ - Start with a single sentence that captures the change's purpose
- Focus on why the change was made, not what changed (the diff shows
what changed)
- CRITICAL: Do NOT include information that is obvious from reading
the diff. The reviewer has the diff; your message should provide
context and reasoning that cannot be inferred from the code changes
alone
+ - Only use a bulleted list if multiple distinct reasons or changes
+ require explanation; otherwise keep the message to one paragraph
- Avoid describing file changes, added/removed lines, or renamed
variables unless the reason for these changes is non-obvious
- Follow repository conventions