assign-experiment

name	assign-experiment
description	Create a typed assignment branch and draft PR for one student. Use when the advisor has a concrete hypothesis and the student has no open `status:wip` or `status:review` assignment.
argument-hint	<student-name> <hypothesis-slug> <problem-dir>
model	claude-sonnet-4-6
effort	high

Assign an experiment

Read the current baseline and program.md, then write one complete assignment:

• a falsifiable hypothesis and mechanism;
• exact files and changes in scope;
• baseline metrics and W&B evidence;
• commands, run limits, metrics, and stopping conditions; and
• one student, one branch, and one experiment.

Fetch the configured advisor branch and record its exact remote SHA. Call create_assignment with this operation-specific payload; the runtime supplies and enforces the configured advisor branch and student allowlist:

{
  "assignment_id": "stable-assignment-id",
  "revision_id": "initial-revision-id",
  "student": "student-name",
  "expected_base_sha": "FETCHED_REMOTE_ADVISOR_SHA",
  "head_branch": "student-name/hypothesis-slug",
  "title": "Concise hypothesis title",
  "body": "Complete actionable experiment brief"
}

The tool creates an empty assignment commit without changing the advisor worktree, pushes the branch with a lease, creates or reconciles one draft PR, adds the exact routing labels, embeds the typed assignment marker, verifies the result, and rejects a second active assignment for the student.

Do not create the branch, PR, labels, or assignment marker through shell commands. If the tool reports stale state, refresh the named SHA and re-evaluate rather than bypassing the precondition.