Example Implementation: Synchronization Boundary
This artifact defines the named fan-in contract that parallel branches must satisfy before review or execution may continue. It exists so Chapter 08 can discuss coordination cost and failure isolation with one canonical boundary.
Boundary Elements
- Change Identity
- Plan Revision
- Repository Scope
- Policy Classification
- Evidence Link Set
- Approval Route ID
Synchronization Rules
- Policy and evidence branches must refer to the same
Change IdentityandPlan Revision. Repository Scopemay narrow during analysis, but it may not silently widen after theReview Planrevision is fixed.Policy ClassificationandApproval Route IDmust agree withdesign/variation-paths.mdanddesign/shared-boundary.md.Evidence Link Setmust contain the references that the reviewer view and acceptance criteria expect for the selected route.Decision Packetand later artifacts may not be emitted from a partial boundary.
Failure Isolation Rules
- A missing policy result blocks synchronization and creates a named rework or manual review outcome.
- Missing evidence blocks human approval, but it does not rewrite the policy result.
- If one branch changes
Plan Revision, every synchronized artifact derived from an older revision becomes stale. - Retry is allowed only from the failed branch or from the synchronization point, not by bypassing the boundary.
Engineering Reading
The synchronization boundary is the operational form of the product-like Combined Review Context introduced in design/variation-paths.md.
It is also the guard that stops parallelism from collapsing the human review gate into a race between branches.
Relationship To Other Artifacts
This artifact complements implementation/orchestration-diagram.md and implementation/workflow.md.
It aligns with review/reviewer-view.md when the Decision Packet carries the same route, policy, and evidence meaning.