Core workflow
- Treat
docs/30-contracts/test-gate.contract.yamlas the canonical authored testing-intent contract. - Restore the pinned tool with
dotnet tool restore. - Generate raw evidence with
pwsh -File scripts/testing/run-quality-evidence.ps1orbash ./scripts/testing/run-quality-evidence.sh. - Normalize and summarize with
dotnet tool run workbench quality sync --results artifacts/quality/raw/test-results --coverage artifacts/quality/raw/coverage. - Inspect the current report with
dotnet tool run workbench quality showordotnet tool run workbench quality show --format json.
Path conventions
- Authored intent:
docs/30-contracts/test-gate.contract.yaml - Raw test results:
artifacts/quality/raw/test-results/*.trx - Raw coverage:
artifacts/quality/raw/coverage/*.cobertura.xml - Generated quality artifacts:
artifacts/quality/testing/
Guardrails
- Generated artifacts under
artifacts/quality/testing/are derived. Do not hand-edit them. - Keep the quality report advisory only. Do not add merge blocking or policy enforcement in this workflow.
- When test scope changes, update the authored contract before trusting the generated summary.