Skip to content

Add a PR template matching the repo's What/Why/How/Verified convention#87

Merged
thdxg merged 1 commit into
mainfrom
claude/serene-buck-74b9fe
Jun 13, 2026
Merged

Add a PR template matching the repo's What/Why/How/Verified convention#87
thdxg merged 1 commit into
mainfrom
claude/serene-buck-74b9fe

Conversation

@thdxg

@thdxg thdxg commented Jun 13, 2026

Copy link
Copy Markdown
Owner

What

Adds .github/pull_request_template.md so every new PR opens pre-filled with the What / Why / How / Verified structure the repo already uses by hand.

Why

Recent merged PRs (#85, #84) all follow the same body shape, but nothing enforced it — each was written from scratch. A template makes that convention the default, and surfaces two project-specific reminders at PR-open time: that PRs squash-merge (so the title should be a good squash subject focused on the "why"), and that the mise run format / lint / test gate must pass.

How

The template mirrors the observed convention:

  • What / Why / How / Verified sections, with Closes # under Why (matching Add configurable Next/Previous Pane keybindings #84, which release-drafter uses to build the changelog).
  • A Verified checklist hardcoding this app's gate: format / lint / test, running via mise run run, and adding tests for the unit-tested layers (model / persistence / palette / hotkey).
  • An optional Notes for reviewers section for branch-history caveats and UI screenshots, which several PRs use.
  • HTML comments guide each section and are stripped from the rendered PR.

No Claude Code footer baked in — the repo's commit convention forbids AI sign-offs, so a per-PR footer would be noise.

Verified

PRs already follow this structure by hand; codifying it as a template
keeps new PRs consistent and surfaces the squash-title and
format/lint/test gate up front.
@github-actions github-actions Bot added the area:docs Documentation label Jun 13, 2026
@thdxg thdxg merged commit d704e6a into main Jun 13, 2026
5 checks passed
@thdxg thdxg deleted the claude/serene-buck-74b9fe branch June 13, 2026 06:10
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:docs Documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant