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
Define validation lane routing and blocker escalation rules for Workspace V2, engine, integration, and targeted tool testing - PR_26146_006-validation-lane-routing-and-blockers
Copy file name to clipboardExpand all lines: docs/dev/PROJECT_INSTRUCTIONS.md
+37Lines changed: 37 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -472,6 +472,43 @@ Integration lanes are the only allowed cross-tool blockers.
472
472
473
473
Reports must clearly identify whether samples were skipped.
474
474
475
+
### Validation Lane Routing And Blockers
476
+
477
+
Targeted PRs execute only affected validation lanes by default.
478
+
479
+
Full Workspace V2 suite validation is not the default for every PR.
480
+
481
+
Validation reports must state why each lane was executed.
482
+
483
+
Lane expansion must be justified in reports.
484
+
485
+
Hidden validation expansion is prohibited.
486
+
487
+
Engine or runtime changes may expand validation scope when they affect dependent lanes.
488
+
489
+
Unrelated failures are `WARN` unless they are explicitly in scope.
490
+
491
+
Lane ownership:
492
+
- contract: manifest, toolState, workspace lifecycle, and validation contract behavior
493
+
- runtime: tool-specific runtime behavior and user-facing tool interactions
494
+
- integration: explicit cross-tool or workspace handoff behavior
495
+
- engine: engine/shared runtime behavior and dependent runtime surfaces
496
+
- samples: affected sample validation when sample scope is active
497
+
- recovery/UAT: explicitly requested recovery or user-acceptance validation lanes
498
+
499
+
Blocker classification rules:
500
+
- targeted tool failures block the targeted lane only
501
+
- engine failures block dependent lanes
502
+
- integration failures block the integration lane only
503
+
- sample failures block only when sample scope is active
504
+
- flaky failures cannot automatically escalate to global blockers
505
+
506
+
Shared-runtime blocker escalation requires identifying the root shared dependency, affected dependent lanes, and the reason the shared dependency blocks those lanes.
507
+
508
+
Integration-lane escalation is allowed only when an explicit cross-tool, workspace handoff, manifest handoff, palette propagation, or toolState open/save contract is in scope.
509
+
510
+
Tool tests must not validate unrelated engine behavior.
0 commit comments