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
+25-2Lines changed: 25 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -47,7 +47,28 @@ When the plan is wrong, stop and document the conflict in a comment, then update
47
47
1. Run the [Copilot review loop](../Contribution-Workflow.md#the-copilot-review-loop) until it reports a clean round.
48
48
2. Triage each thread and CI failure per [Review Etiquette](../Review-Etiquette.md): fix in scope and propagate the same fix elsewhere; file a follow-up for out-of-scope; reply, then resolve.
49
49
50
-
### 5. Finalize and hand off
50
+
### 5. Standards and framework alignment pass
51
+
52
+
Run this once per implementation session, when the change is otherwise complete and before the pull request is marked ready — not on every commit. Re-read the applicable guidance in precedence order and reconcile the whole diff against it:
53
+
54
+
1.**Process** — the [Ways of Working](../index.md) pages that govern this stage, including [Commit Conventions](../Commit-Conventions.md), [PR Format](../PR-Format.md), and [Branching and Merging](../Branching-and-Merging.md).
55
+
2.**Standards** — the [Coding Standards](../../Coding-Standards/index.md) chapters that apply to the languages and file types actually changed.
56
+
3.**Framework and domain documentation** — the documentation the repository's framework or product owns, such as the module-framework documentation for a module repository or the action contract for an action repository.
57
+
58
+
Process defines the method; standards and framework documentation define correctness details. Where the layers overlap, the narrower layer supplies the detail and the broader layer supplies the method — a framework page never overrides a process rule it does not own. Read the canonical pages instead of recalling them; that is what keeps guidance written once and referenced everywhere.
59
+
60
+
Record the outcome as one row per changed surface:
A result is `Aligned`, `Fixed in this PR`, or `Exception` with a link that justifies it. Carry the table into the pull request's Technical details block per [PR Format](../PR-Format.md), so [Review](Review.md) can verify the pass instead of guessing whether it happened.
68
+
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
+
71
+
### 6. Finalize and hand off
51
72
52
73
When the change meets the [Definition of Ready for Review](../Definition-of-Ready-and-Done.md):
53
74
@@ -60,11 +81,13 @@ When the change meets the [Definition of Ready for Review](../Definition-of-Read
60
81
2. Progress is visible — the delivery issue is updated as plan steps complete, not in bulk.
61
82
3. Draft pull request from the start; stay in the issue's scope.
62
83
4. Mark ready only when the change meets the Definition of Ready for Review — never with open plan steps.
63
-
5. Return unplanned work to [Define](Define.md) and hand review-ready work to [Review](Review.md).
84
+
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).
64
86
65
87
## Where this connects
66
88
67
89
-[Contribution Workflow](../Contribution-Workflow.md) — the draft-first loop this runs.
90
+
-[Coding Standards](../../Coding-Standards/index.md) — the standards layer the alignment pass reconciles against.
68
91
-[Issue Lifecycle](../Issues/Process/Lifecycle.md) and [Issue Relationships](../Issues/Process/Relationships.md) — delivery-leaf eligibility and blockers.
69
92
-[Definition of Ready and Done](../Definition-of-Ready-and-Done.md) — the gate this hands off at.
70
93
-[PR Format](../PR-Format.md) and [Branching and Merging](../Branching-and-Merging.md) — packaging and landing.
0 commit comments