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.
Evidence Items
Provider Holdout
No evidence packet has been submitted for review.
- Owner
- operator with provider credentials
- Ledger
pending- Blocked
2- Submission
evidence/world_class/submissions/provider-holdout.json
Source Runbook
- YAO_OUTPUT_EVAL_MODEL=gpt-4.1-mini OPENAI_API_KEY=<redacted> python3 scripts/yao.py output-exec --provider-runner openai --timeout-seconds 60
- python3 scripts/yao.py skill-os2-audit . --generated-at <YYYY-MM-DD>
- Copy evidence/world_class/templates/provider-holdout.intake.json to evidence/world_class/submissions/provider-holdout.json and fill only real evidence fields.
- python3 scripts/yao.py world-class-intake . --submissions-dir evidence/world_class/submissions
Commands
- prepare submission
python3 scripts/yao.py world-class-submission-kit . --evidence-key provider-holdout --output-dir evidence/world_class/submissions - validate intake
python3 scripts/yao.py world-class-intake . --submissions-dir evidence/world_class/submissions - review queue
python3 scripts/yao.py world-class-submission-review . --submissions-dir evidence/world_class/submissions - refresh ledger
python3 scripts/yao.py world-class-ledger . --submissions-dir evidence/world_class/submissions - guard claim
python3 scripts/yao.py world-class-claim-guard .
Must Collect
- provider-backed model run
- observed timing
- observed token metadata
Success Checks
- reports/output_execution_runs.json summary.model_executed_count > 0
- reports/output_execution_runs.json summary.timing_observed_count > 0
- reports/output_execution_runs.json summary.token_observed_count > 0
- reports/skill_os2_audit.json item provider-holdout status becomes pass
Privacy
- Do not commit provider credentials or environment dumps.
- The output execution report records output hashes and aggregate run metadata, not raw provider prompts.
Next Source Actions
- Run provider-backed output-exec with real credentials.
- Provider execution should return non-estimated token usage.
Source Evidence Snapshot
- Provider model run
model_executed_count: 0 / >0Run provider-backed output-exec with real credentials. - Timing observed
timing_observed_count: 10 / >0Provider execution should record timing metadata. - Token usage observed
token_observed_count: 0 / >0Provider execution should return non-estimated token usage.
Human Adjudication
No evidence packet has been submitted for review.
- Owner
- human reviewer
- Ledger
pending- Blocked
2- Submission
evidence/world_class/submissions/human-adjudication.json
Source Runbook
- python3 scripts/yao.py output-review-kit --write-template
- Open reports/output_review_kit.md and choose A or B for each pair without opening the answer key.
- python3 scripts/adjudicate_output_review.py --write-template
- Edit reports/output_review_decisions.json with winner_variant values and reviewer metadata.
- python3 scripts/yao.py output-review
- python3 scripts/yao.py skill-os2-audit . --generated-at <YYYY-MM-DD>
- Copy evidence/world_class/templates/human-adjudication.intake.json to evidence/world_class/submissions/human-adjudication.json and fill only real evidence fields.
- python3 scripts/yao.py world-class-intake . --submissions-dir evidence/world_class/submissions
Commands
- prepare submission
python3 scripts/yao.py world-class-submission-kit . --evidence-key human-adjudication --output-dir evidence/world_class/submissions - validate intake
python3 scripts/yao.py world-class-intake . --submissions-dir evidence/world_class/submissions - review queue
python3 scripts/yao.py world-class-submission-review . --submissions-dir evidence/world_class/submissions - refresh ledger
python3 scripts/yao.py world-class-ledger . --submissions-dir evidence/world_class/submissions - guard claim
python3 scripts/yao.py world-class-claim-guard .
Must Collect
- real reviewer identity
- blind A/B decisions
- answer key unopened until decisions exist
Success Checks
- reports/output_review_adjudication.json summary.pending_count == 0
- reports/output_review_adjudication.json summary.judgment_count == summary.pair_count
- reports/output_review_adjudication.json summary.invalid_decision_count == 0
- reports/skill_os2_audit.json item human-adjudication status becomes pass
Privacy
- Reviewer decisions should not include raw user data or private customer detail.
- Keep the answer key separate until after decisions are recorded.
Next Source Actions
- Record a reviewer choice for every pair.
- Every pair needs one valid human judgment.
Source Evidence Snapshot
- Review pairs exist
pair_count: 5 / >0Generate the blind A/B review pack. - No pending decisions
pending_count: 5 / ==0Record a reviewer choice for every pair. - Judgments complete
judgment_count: 0 / ==pair_countEvery pair needs one valid human judgment. - No invalid decisions
invalid_decision_count: 0 / ==0Fix malformed winner/confidence entries.
Native Permission Enforcement
No evidence packet has been submitted for review.
- Owner
- target client or installer integrator
- Ledger
pending- Blocked
1- Submission
evidence/world_class/submissions/native-permission-enforcement.json
Source Runbook
- Implement or connect a real target client or external installer runtime guard that blocks undeclared network, file_write, or subprocess capabilities.
- Update the generated target adapter only when the guard is actually enforced by that target.
- python3 scripts/yao.py package . --platform openai --platform claude --platform generic --platform vscode --output-dir dist --zip
- python3 scripts/yao.py install-simulate . --package-dir dist --install-root dist/install-simulation
- python3 scripts/yao.py runtime-permissions . --package-dir dist
- python3 scripts/yao.py skill-os2-audit . --generated-at <YYYY-MM-DD>
- Copy evidence/world_class/templates/native-permission-enforcement.intake.json to evidence/world_class/submissions/native-permission-enforcement.json and fill only real evidence fields.
- python3 scripts/yao.py world-class-intake . --submissions-dir evidence/world_class/submissions
Commands
- prepare submission
python3 scripts/yao.py world-class-submission-kit . --evidence-key native-permission-enforcement --output-dir evidence/world_class/submissions - validate intake
python3 scripts/yao.py world-class-intake . --submissions-dir evidence/world_class/submissions - review queue
python3 scripts/yao.py world-class-submission-review . --submissions-dir evidence/world_class/submissions - refresh ledger
python3 scripts/yao.py world-class-ledger . --submissions-dir evidence/world_class/submissions - guard claim
python3 scripts/yao.py world-class-claim-guard .
Must Collect
- real target client or external installer runtime guard
- native enforcement flag or externally accepted guard proof
- residual risk retained for fallback targets
Success Checks
- reports/runtime_permission_probes.json summary.native_enforcement_count > 0
- reports/runtime_permission_probes.json summary.failure_count == 0
- reports/runtime_permission_probes.json summary.installer_enforcement_pass_count records local installer enforcement but does not replace native evidence
- reports/skill_os2_audit.json item native-permission-enforcement status becomes pass
Privacy
- Do not mark native_enforcement true for metadata-only fallbacks.
- Keep residual risks visible for targets that still rely on operator enforcement.
Next Source Actions
- Collect real target-client or external runtime guard proof.
Source Evidence Snapshot
- Native enforcement
native_enforcement_count: 0 / >0Collect real target-client or external runtime guard proof. - Probe failures
failure_count: 0 / ==0Runtime permission probes must stay clean. - Installer support
installer_enforcement_ready: True / trueInstaller enforcement is supporting evidence, not native proof.
Native Client Telemetry
No evidence packet has been submitted for review.
- Owner
- Browser/Chrome/IDE/provider client integrator
- Ledger
pending- Blocked
2- Submission
evidence/world_class/submissions/native-client-telemetry.json
Source Runbook
- python3 scripts/telemetry_native_host.py . --write-launcher /tmp/yao-telemetry-host.sh --write-manifest /tmp/yao-telemetry-host.json --allowed-origin chrome-extension://<extension-id>/
- Install the generated native messaging manifest for the real client and send at least one accepted skill_activation or skill_output event.
- python3 scripts/yao.py telemetry-import . --input-jsonl .yao/telemetry_spool/external_events.jsonl
- python3 scripts/yao.py skill-atlas --workspace-root .
- python3 scripts/yao.py skill-os2-audit . --generated-at <YYYY-MM-DD>
- Copy evidence/world_class/templates/native-client-telemetry.intake.json to evidence/world_class/submissions/native-client-telemetry.json and fill only real evidence fields.
- python3 scripts/yao.py world-class-intake . --submissions-dir evidence/world_class/submissions
Commands
- prepare submission
python3 scripts/yao.py world-class-submission-kit . --evidence-key native-client-telemetry --output-dir evidence/world_class/submissions - validate intake
python3 scripts/yao.py world-class-intake . --submissions-dir evidence/world_class/submissions - review queue
python3 scripts/yao.py world-class-submission-review . --submissions-dir evidence/world_class/submissions - refresh ledger
python3 scripts/yao.py world-class-ledger . --submissions-dir evidence/world_class/submissions - guard claim
python3 scripts/yao.py world-class-claim-guard .
Must Collect
- real external client source
- metadata-only event
- local-first import path
Success Checks
- reports/adoption_drift_report.json summary.source_types.external > 0
- reports/adoption_drift_report.json summary.adoption_sample_count > 0
- reports/skill_os2_audit.json item native-client-telemetry status becomes pass
Privacy
- Telemetry must remain metadata-only and local-first.
- Do not package reports/telemetry_events.jsonl or any raw prompt, output, transcript, note, or message field.
Next Source Actions
- Import at least one metadata-only event from a real client.
- Telemetry must include adoption outcome evidence.
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: 0 / >0Telemetry must include adoption outcome evidence. - Raw content blocked
raw_content_allowed: False / falseTelemetry must stay metadata-only.
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.