This directory holds cross-package experiment state that is too operational for publications/ and too run-specific for workflows/.
Use this layer for manifests, ledgers, metric rules, and temporary state that coordinate several packages or channels. Durable process belongs in ../workflows/. Package-local outputs belong in the relevant package. Execution evidence belongs in ../reviewable-runs/.
| Experiment | Owner Workflow | State Files | Posture |
|---|---|---|---|
youtube-cinematic-pilot/ |
../workflows/youtube-cinematic-pilot/README.md |
public copy/; private .private/youtube/cinematic-pilot/ state |
Bounded pilot orientation and private historical metric surface |
youtube-cinematic-rollout/ |
../workflows/youtube-cinematic-rollout/README.md |
public orientation only; active state in .private/youtube/ |
Evergreen active rollout state |
youtube-reference-comments/ |
draft-only experiment, no stable owner workflow yet | pilot_manifest.yaml, drafts/, notes.md |
Small-cohort backfill pilot for curated references comments |
youtube-explainer-shorts/ |
../workflows/youtube-channel-ops/README.md |
metrics/ |
Historical experiment metric surface |
youtube-insight-authority/ |
../workflows/youtube-channel-ops/README.md |
public spec/rubric only; cohort and readback state in .private/youtube/ |
Active read-only cohort for cinematic authority claims |
youtube-analytics/ |
../workflows/youtube-channel-ops/README.md |
decision_rules.yaml; generated jobs, ledgers, snapshots, and reports in .private/youtube/ |
Active recommendation-only analytics layer |
- Keep experiment state indexed here before adding new root scripts or manifests.
- Do not treat experiment manifests as package source authority unless a workflow or package README explicitly names them.
- Keep external channel mutations behind the YouTube workflow approval boundaries.
- Move stable package-specific outputs back into package
artifacts/,distribution/, orsocials/folders when an experiment becomes normal publication work.