You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: src/docs/Ways-of-Working/Workflow-Stages/Implement.md
+15-3Lines changed: 15 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -68,7 +68,18 @@ A result is `Aligned`, `Fixed in this PR`, or `Exception` with a link that justi
68
68
69
69
**Stop rule.** Fix what is in scope for the closing Task or Bug and small enough to keep the pull request reviewable. When a finding is out of scope, systemic across the repository, or would change the shape of the pull request, file a follow-up issue through [Define](Define.md), link it in the table as an exception, and leave the change as it is. The pass improves alignment; it does not turn into a second delivery.
70
70
71
-
### 6. Finalize and hand off
71
+
### 6. Issue convergence sweep
72
+
73
+
Run this once per implementation session, at the same timing as the standards/framework pass: when the change is otherwise complete and before the pull request is marked ready.
74
+
75
+
1. Search for already-open issues whose asks the finished diff now satisfies, not only the issue originally linked when the branch was opened.
76
+
2. Scope the sweep deliberately so it scales: prioritize the delivery leaf's parent and siblings in the [Issue Hierarchy](../Issues/Types/Hierarchy.md), then narrow by affected component, labels, keywords, or code paths. Do not read every open issue serially in large repositories.
77
+
3. Treat convergence as outcome-based:
78
+
-**Fully satisfied** — the diff already delivers the issue's ask. Add it to the pull request's Relevant issues block with a closing keyword (`Fixes`, `Closes`, or `Resolves`) so merge closes it.
79
+
-**Partially satisfied** — the diff helps but does not fully deliver the ask. Link it as non-closing context and keep or create a follow-up delivery leaf for the remaining gap.
80
+
4. Keep this pass focused on convergence and linkage. It does **not** rewrite, reformat, or otherwise "fix up" issue bodies to match issue templates; issue quality edits are separate work routed through [Define](Define.md).
81
+
82
+
### 7. Finalize and hand off
72
83
73
84
When the change meets the [Definition of Ready for Review](../Definition-of-Ready-and-Done.md):
74
85
@@ -82,12 +93,13 @@ When the change meets the [Definition of Ready for Review](../Definition-of-Read
82
93
3. Draft pull request from the start; stay in the issue's scope.
83
94
4. Mark ready only when the change meets the Definition of Ready for Review — never with open plan steps.
84
95
5. Run the standards and framework alignment pass once at session end, before marking the pull request ready, and record its result in the pull request.
85
-
6. Return unplanned work to [Define](Define.md) and hand review-ready work to [Review](Review.md).
96
+
6. Run the issue convergence sweep once at session end, before marking the pull request ready, and link every fully convergent issue in the pull request with closing keywords.
97
+
7. Return unplanned work to [Define](Define.md) and hand review-ready work to [Review](Review.md).
86
98
87
99
## Where this connects
88
100
89
101
-[Contribution Workflow](../Contribution-Workflow.md) — the draft-first loop this runs.
90
102
-[Coding Standards](../../Coding-Standards/index.md) — the standards layer the alignment pass reconciles against.
91
-
-[Issue Lifecycle](../Issues/Process/Lifecycle.md) and [Issue Relationships](../Issues/Process/Relationships.md) — delivery-leaf eligibility and blockers.
103
+
-[Issue Hierarchy](../Issues/Types/Hierarchy.md), [Issue Lifecycle](../Issues/Process/Lifecycle.md), and [Issue Relationships](../Issues/Process/Relationships.md) — delivery-leaf eligibility, convergence sweep targeting, and blockers.
92
104
-[Definition of Ready and Done](../Definition-of-Ready-and-Done.md) — the gate this hands off at.
93
105
-[PR Format](../PR-Format.md) and [Branching and Merging](../Branching-and-Merging.md) — packaging and landing.
0 commit comments