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.
Commenting is not possible because the repository is archived.
No reviewers
No labels
No milestone
No project
No assignees
1 participant
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.