Skip to content

docs: align M01.1 cohort operations and release evidence - #11

Open
tim8es wants to merge 6 commits into
feature/m01-1-content-qualityfrom
docs/m01-1-cohort-operations-pack
Open

docs: align M01.1 cohort operations and release evidence#11
tim8es wants to merge 6 commits into
feature/m01-1-content-qualityfrom
docs/m01-1-cohort-operations-pack

Conversation

@tim8es

@tim8es tim8es commented Sep 7, 2026

Copy link
Copy Markdown
Owner

Status

Canonical M01.1 cohort/release operations pack. Supersedes PR #9. Issue #4 now points to this pack and contains the exact external blocker.

Scope

Docs/operations only. No product runtime changes.

What this adds

  • executable P01–P05 cohort runbook pinned to the published M01.1 Pages SHA/blob;
  • clean-start rule for both PMO01 storage keys;
  • session evidence for strong alternative, discriminating evidence, falsifier and decision revision condition;
  • cohort review rules aligned to M01.1 falsifiable transfer;
  • release evidence checklist separating static verification from real-participant evidence;
  • structural regression test for the operations pack.

RED→GREEN

  • RED: Prototype CI #135 — 41 pass / 3 fail on missing runbook/evidence/checklist contracts.
  • GREEN: Prototype CI #140 on head be610dad4b2aa2c1fbc13366a9387e02ac4c12b6 — success.
  • PR merge-ref CI #141 — success, 44/44 tests.

Exact production under test

  • Pages SHA: c4f8ac2af6a66efdb79881baa58d4c091a0e6aed
  • M01.1 asset blob: 33b328d3ccc753cc3d0aee15da98bccd6913f92e

Guardrails

  • no M02 changes;
  • no telemetry changes;
  • no main changes;
  • no product-code changes;
  • do not merge without explicit owner approval.

Remaining empirical gate

At least five real eligible learner sessions P01–P05. Synthetic/AI sessions do not count. After ≥5 valid sessions, record exactly one outcome: PROMOTE / REVISE / REJECT. Until then Phase 2 remains blocked.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: be610dad4b

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment on lines +94 to +95
1. `project-system` Learning Lab;
2. `m01-drill-system` cold choice — first choice is frozen after feedback;

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Badge Start each lesson with its cold choice

In the runbook's “Exact session sequence,” completing the project-system Learning Lab is listed before taking m01-drill-system, even though app.js renders that drill inside the lab as step 01 and labReady() requires it for lesson completion; the same inversion occurs for system-diagnostic. A facilitator following this literally will either expose the worked example and technique before the supposedly cold choice or encounter an already-completed, frozen drill at the next step, invalidating the cold-decision evidence. Replace the lesson entries with an explicit open/start action and follow the rendered order through the cold drill before teaching content.

Useful? React with 👍 / 👎.

Comment on lines +107 to +110
- first choice;
- short reason;
- whether the learner chose or seriously considered a credible near-miss;
- feedback changed reasoning: `yes / no / unclear`;

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Badge Record the rationale before revealing feedback

For sessions without spontaneous think-aloud, this capture list does not tell the facilitator to obtain the reason and near-miss consideration before the learner selects an option. The inspected app.js radio-change handler renders option-specific feedback immediately and then freezes the cold choice, so asking for these observations afterward lets the explanation contaminate the purported pre-feedback rationale and makes “feedback changed reasoning” impossible to assess reliably. Require the learner to state and record the rationale/near-miss before clicking, then capture the post-feedback change separately.

Useful? React with 👍 / 👎.

Comment on lines +43 to +47
- [ ] P01 completed and valid.
- [ ] P02 completed and valid.
- [ ] P03 completed and valid.
- [ ] P04 completed and valid.
- [ ] P05 completed and valid.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Allow replacement IDs in the completion checklist

When any original session is excluded, the runbook explicitly requires recruiting another participant until five valid sessions exist, but this checklist permanently requires every one of P01–P05 to be valid. For example, excluding P02 and completing a valid P06 leaves the cohort eligible under the decision rules while this evidence checklist can never be completed, and the fixed summary tables likewise have no replacement row. Track five valid participant IDs dynamically or add replacement slots instead of requiring the original five IDs.

Useful? React with 👍 / 👎.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant