Skip to content

Commit 7bc460a

Browse files
committed
refine pull request standards
1 parent 543a7f5 commit 7bc460a

File tree

2 files changed

+2
-0
lines changed

2 files changed

+2
-0
lines changed

docs/pull-requests.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,7 @@ Useful pull requests are not just code dumps. They explain the operational chang
66

77
- state the problem first
88
- summarize the actual change in a short `Changes` section
9+
- describe the real diff between the base branch and the PR branch, not the idealized change you wish the branch contained
910
- keep the scope coherent instead of mixing unrelated work
1011
- start from a branch that is reasonably fresh against the target base branch
1112
- include docs or examples when behavior or workflow changes

docs/todo.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,7 @@
1212
- expose more explicit engineering-contract guidance for agents, including preferred edit boundaries and validation order
1313
- add machine-readable improvement priority or severity so agents can plan fixes more predictably
1414
- improve CLI and output UI so factor status, evidence, and guidance are easier to scan quickly
15+
- think through a dedicated `dev.kit` GitHub module or mode for PRs, issues, workflows, and repo operating signals
1516

1617
## Validation
1718

0 commit comments

Comments
 (0)