Skip to content

Commit a584a00

Browse files
committed
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
1 parent b97c686 commit a584a00

1 file changed

Lines changed: 37 additions & 0 deletions

File tree

docs/dev/PROJECT_INSTRUCTIONS.md

Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -472,6 +472,43 @@ Integration lanes are the only allowed cross-tool blockers.
472472

473473
Reports must clearly identify whether samples were skipped.
474474

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.
511+
475512
Every PR must document:
476513
- whether full samples test was skipped or run
477514
- reason for decision

0 commit comments

Comments
 (0)