Skip to content

feat: add GitHub issue-closing keywords to PR template (issue #600)#1726

Open
ElizioMartins wants to merge 4 commits into
obra:devfrom
ElizioMartins:feat/pr-closing-keywords
Open

feat: add GitHub issue-closing keywords to PR template (issue #600)#1726
ElizioMartins wants to merge 4 commits into
obra:devfrom
ElizioMartins:feat/pr-closing-keywords

Conversation

@ElizioMartins

Copy link
Copy Markdown

Who is submitting this PR?

Field Value
Your model + version Nemotron 3 Ultra (via OpenCode)
Harness + version OpenCode (latest)
All plugins installed superpowers
Human partner who reviewed this diff Elizio Martins

What problem are you trying to solve?

Issue #600: When the finishing-a-development-branch skill creates a PR (Option 2), it generates a PR body with Summary and Test Plan sections but doesn't prompt the user to link related GitHub issues using closing keywords (Closes #123, Fixes #123, Resolves #123).

This means issues that are fully resolved by the PR don't get auto-closed on merge, requiring manual cleanup.

What does this PR change?

  • Adds Closes #<issue-number> placeholder in the PR body template (Option 2)
  • Adds guidance before the template reminding the agent to check for related GitHub issues
  • Documents supported closing keywords: Closes, Fixes, Resolves (case-insensitive)

Is this change appropriate for the core library?

Yes - this affects all users creating PRs via the skill, regardless of project domain.

What alternatives did you consider?

Alternative would be to auto-detect related issues from commit messages or branch names, but that adds complexity and may be inaccurate. The explicit placeholder approach is simple and matches GitHub's documented pattern.

Does this PR contain multiple unrelated changes?

No - single cohesive change to the PR template and guidance.

Existing PRs

Environment tested

Harness Harness version Model Model version/ID
OpenCode latest Nemotron 3 Ultra nemotron-3-ultra-free

Evaluation

Rigor

  • This change was tested adversarially, not just on the happy path
  • I did not modify carefully-tuned content (Red Flags table, rationalizations, "human partner" language)

Human review

  • A human has reviewed the COMPLETE proposed diff before submission

obra and others added 4 commits May 29, 2026 13:05
Add a mandatory self-identification disclosure (model, harness, harness
version, all installed plugins) to the PR template and all three issue
templates, and document the requirement in the contributor guidelines.
We weigh contributions differently depending on what produced them:
content reasoned from documentation is held to a different bar than work
grounded in a real session.

Also state explicitly, in both CLAUDE.md and the PR template, that all
PRs must target the dev branch rather than main.
- skills/test-driven-development/SKILL.md: remove @ from testing-anti-patterns.md reference
- skills/writing-skills/SKILL.md: remove @ from testing-skills-with-subagents.md reference

The @ prefix is not a valid markdown convention and doesn't resolve to the actual file. Both files exist in the same directory as the referencing SKILL.md.
…ssue obra#1090)

Adds keep-coding-instructions: true to the YAML frontmatter of all 14 skills:
- brainstorming
- dispatching-parallel-agents
- executing-plans
- finishing-a-development-branch
- receiving-code-review
- requesting-code-review
- subagent-driven-development
- systematic-debugging
- test-driven-development
- using-git-worktrees
- using-superpowers
- verification-before-completion
- writing-plans
- writing-skills

This preserves user's CLAUDE.md coding instructions when skills are invoked, per Claude Code 2.1.94+ feature.
- Add 'Closes #<issue-number>' placeholder in PR body template
- Add guidance to check for related GitHub issues before creating PR
- Documents supported closing keywords: Closes, Fixes, Resolves

This enables auto-closing of issues when PR is merged.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants