5 targets in platform-neutral contract
World-Class Operator Runbook
A single operating page for collecting the remaining human and external evidence. It coordinates action, but does not accept evidence or change the ledger.
-Fast Path
- Run the real external or human work for one evidence item.
- Generate and fill the matching submission draft.
- Validate intake and inspect the submission review queue.
- Refresh the ledger and run the claim guard before making any completion claim.
Coordination Plan
These steps tell the assistant what to run and where the user must supply real provider, reviewer, client, or telemetry input. Every row is operational guidance only and keeps counts_as_completion false.
| Step | Evidence | Owner | User | User action | Assistant action | Command | Pass condition |
|---|---|---|---|---|---|---|---|
prepare-evidence-session | all | assistant + user | true | Confirm provider access, reviewer availability, target client path, and telemetry client path before collection starts. | Run preflight and prepare submission drafts without accepting them as evidence. | python3 scripts/yao.py world-class-preflight . --submissions-dir evidence/world_class/submissions && python3 scripts/yao.py world-class-submission-kit . --output-dir evidence/world_class/submissions --prefill-artifacts | Preflight lists the same pending evidence keys and no credential values are printed. |
collect-provider-holdout | provider-holdout | assistant + operator with provider credentials | true | Provide the provider API key through an environment variable and confirm the model to use. | Run provider-backed output execution, verify aggregate timing and token metadata, then prepare the evidence packet. | python3 scripts/yao.py output-exec . --provider-runner openai --provider-model <model> --timeout-seconds 60 | reports/output_execution_runs.json has model_executed_count > 0 and token_observed_count > 0. |
collect-human-adjudication | human-adjudication | human reviewer + assistant | true | Open the blind review kit, choose winners for all pairs, add reviewer metadata and reasons, and keep the answer key hidden until decisions are saved. | Generate the review kit, import decisions, validate integrity, and prepare the human evidence packet. | python3 scripts/yao.py output-review-kit . && python3 scripts/yao.py output-review . | reports/output_review_adjudication.json has pending_count == 0 and ready_for_human_evidence == true. |
collect-native-permission-enforcement | native-permission-enforcement | target client or installer integrator + assistant | true | Select a real target client or external installer guard that can enforce declared capabilities instead of metadata-only fallback. | Run runtime permission probes, package verification, install simulation, and prepare the native enforcement evidence packet. | python3 scripts/yao.py runtime-permissions . --package-dir dist | reports/runtime_permission_probes.json has native_enforcement_count > 0 and failure_count == 0. |
collect-native-client-telemetry | native-client-telemetry | real client integrator + assistant | true | Install the native host manifest in a real Browser, Chrome, IDE, or provider client and trigger a metadata-only event. | Generate native host assets, import the external event JSONL, refresh adoption drift, and prepare the telemetry evidence packet. | python3 scripts/yao.py telemetry-import . --input-jsonl .yao/telemetry_spool/external_events.jsonl --source external | reports/adoption_drift_report.json has source_types.external > 0 and adoption_sample_count > 0. |
review-and-release-gate | all | assistant + ledger reviewer | true | Approve only validated evidence packets and confirm the release wording after the claim guard passes. | Run intake, submission review, ledger, claim guard, benchmark, evidence consistency, Review Studio, and CI before final publish. | python3 scripts/yao.py world-class-intake . --submissions-dir evidence/world_class/submissions && python3 scripts/yao.py world-class-submission-review . --submissions-dir evidence/world_class/submissions && python3 scripts/yao.py world-class-ledger . --submissions-dir evidence/world_class/submissions && python3 scripts/yao.py world-class-claim-guard . && make ci-test | Ledger ready_to_claim_world_class, benchmark public_claim_ready, claim guard violation_count == 0, Review Studio has no blockers, and CI passes. |
Phase Queue
- Unblock access
unblock-access: 4 / 4Assign a real reviewer identity before claiming human adjudication. - Collect source
collect-source: 9 / 9Set reviewer_attestation only after choices are completed before opening the answer key.
Evidence Items
Provider Holdout
Next Source Actions
- Import at least one metadata-only event from a real client.
Source Evidence Snapshot
- External events
external_source_events: 0 / >0Import at least one metadata-only event from a real client. - Adoption sample
adoption_sample_count: 1 / >0Telemetry must include adoption outcome evidence. - Raw content blocked
raw_content_allowed: False / falseTelemetry must stay metadata-only.
Release Gate
Run make ci-test in a clean worktree and verify GitHub Actions before converting the PR out of Draft.
+| Check | Current | Expected | Status | Artifact |
|---|---|---|---|---|
| World-class ledger ready | evidence-pending | ready_to_claim_world_class == true | blocked | reports/world_class_evidence_ledger.json |
| Claim guard clean | violations 0; ledger ready False | violation_count == 0 and ledger_ready_to_claim_world_class == true | blocked | reports/world_class_claim_guard.json |
| Benchmark public claim ready | public_claim_ready False | public_claim_ready == true | blocked | reports/benchmark_reproducibility.json |
| Review Studio clean | blockers 0; warnings 3 | blocker_count == 0 and warning_count == 0 | blocked | reports/review-studio.json |
| Evidence consistency clean | consistent | decision == consistent and fail_count == 0 | pass | reports/evidence_consistency.json |
Boundary
- Planned work, draft packets, metadata fallback, pending human decisions, and local command runners do not count as completion.
- Valid intake means ready for submission review; ledger review still requires passing source evidence.
- The world-class ledger and claim guard remain the source of truth.