refactor(push): tighten PR body template with examples and rules #5

Merged
claudiomaradonna merged 2 commits from refactor/push-pr-body-template into main 2026-04-29 18:35:26 +02:00

The /push skill's step 6 previously gave only four bullet requirements with no structure or examples. The first PR opened by the skill on this repo (#4) drifted into a sectioned, per-commit-with-SHAs body — verbose, redundant with the PR commit list, and fragile in CLI markdown viewers because of adjacent bold spans. This rewrite replaces the bullet list with concrete rules: title constraints, a default narrative paragraph (~80–150 words, no headers, no SHA bullets), an opt-in sectioned form gated on real cross-area scope, markdown discipline against bold-span adjacency, and a one-line footer for merge style and refs. Two worked examples — one default, one sectioned — anchor the rules to output that matches the de-facto style of earlier accepted PRs (#2, #3). This very PR uses the new template as a smoke test.

Merge: rebase.

The `/push` skill's step 6 previously gave only four bullet requirements with no structure or examples. The first PR opened by the skill on this repo (#4) drifted into a sectioned, per-commit-with-SHAs body — verbose, redundant with the PR commit list, and fragile in CLI markdown viewers because of adjacent bold spans. This rewrite replaces the bullet list with concrete rules: title constraints, a default narrative paragraph (~80–150 words, no headers, no SHA bullets), an opt-in sectioned form gated on real cross-area scope, markdown discipline against bold-span adjacency, and a one-line footer for merge style and refs. Two worked examples — one default, one sectioned — anchor the rules to output that matches the de-facto style of earlier accepted PRs (#2, #3). This very PR uses the new template as a smoke test. Merge: rebase.
Step 6 previously gave only four bullet requirements without structure
or examples. The first PR opened by the skill on this repo
(claudiomaradonna/claude-plugins#4) drifted into a sectioned, per-
commit-with-SHAs body — verbose, redundant with the PR commit list,
and fragile in CLI markdown viewers because of adjacent bold spans.

Replace the bullet list with explicit rules: title constraints,
default narrative paragraph (~80–150 words, no headers, no SHA
bullets), an opt-in sectioned form gated on real cross-area scope,
markdown discipline against bold-span adjacency, and a one-line
footer for merge style and refs. Two worked examples — one default,
one sectioned — anchor the rules to concrete output that matches the
de-facto style of earlier PRs (#2, #3).
Patch bump for the refined /push body template. No new capability —
just tightened guidance and worked examples in step 6, so existing
contracts are unchanged.
Sign in to join this conversation.
No reviewers
No labels
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
claudiomaradonna/claude-plugins!5
No description provided.