teaching-pipeline

name	teaching-pipeline
description	Full teaching-lifecycle orchestrator for university professors. 4-agent team driving the six sibling skills through staged gates over the Course Passport: design → alignment gate → build → assess → quality gate → semester delivery loop → reflection → next-term improvement. Resumable from the passport at any week of the term; mid-entry at any stage. Triggers on: teach a course, prepare my course, semester, full course pipeline, course lifecycle, new semester, what's next for my course, course status, 开课, 备一门课, 新学期, 整门课, 课程全流程, 教学流程, 下一步.
metadata	{"version":"1.0.0","last_updated":"2026-06-10","status":"active","pipeline_stage":"orchestrator","related_skills":["course-designer","lesson-builder","assessment-architect","student-mentor","submission-auditor","teaching-reflector"]}

Teaching Pipeline — Course Lifecycle Orchestrator

Orchestrates the whole teaching lifecycle — design, build, assess, deliver, reflect, improve — by dispatching the six sibling skills in backward-design order over a single Course Passport (shared/course_passport_schema.md). The professor brings the discipline, the students, and every decision; this skill brings sequence, gates, and memory across the semester and across terms.

Prime rule: unlike a paper pipeline, teaching is cyclic and calendar-bound. Stage 4 is a loop, not a step, and Stage 6 feeds Stage 1 of the next term. The passport plus today's position in the academic calendar — never the chat history — determines what happens next.

Quick Start

I'm teaching a new course on machine learning next semester — run the whole pipeline
新学期要开一门《数据结构》，帮我把整门课准备出来
I already have a syllabus from last year — pick it up from there
It's week 6, what's next for my course?
课程现在什么状态？下一步做什么？
Term just ended, here are my student evals — close out the semester

Modes

Mode	Trigger intent	What it does
full	"Teach/prepare a whole course", new course from scratch	Stage 0 onward: intake → passport → all stages in order, every gate, every checkpoint
mid-entry	Professor arrives with existing materials or mid-process ("I already have a syllabus", "it's week 9")	Detect/ask where they are, validate existing materials into the passport (via course-designer align-check, not re-derivation), enter at the matching stage per the routing table below
status	"What's next?", "course status", 下一步	Read passport + calendar position; report current stage, gate states, pending confirmations, and the next concrete action. Read-only
new-term	"Teaching it again", new semester of an existing course	Stage 6 → Stage 1 re-entry: load iteration_history evidence + the redesign brief, dispatch course-designer redesign with the evidence attached
dashboard	"Show me my course", "course overview", 课程总览	Run python3 scripts/build_dashboard.py <passport> → single-file course_dashboard.html next to the passport: gates (stored + live re-check), outcomes, assessment plan, week-by-week resources with clickable local artifact links, ledger, workload, iteration history. Regenerated at any checkpoint on request — it is a build product of the passport, never hand-edited

Mode dispatch rule: a passport already on disk + a vague request → run status first and propose the next action; never restart full on top of an existing passport. Detect intent in any language.

Stage Map

Stage 0  CONTEXT    — intake → initialize Course Passport            🧑 checkpoint
Stage 1  DESIGN     — course-designer (full | redesign)              🧑 checkpoint
Gate 1.5 ALIGNMENT  — alignment_gate_protocol; BLOCK → back to 1     ✓ machine + professor ack
Stage 2  BUILD      — lesson-builder week-batch, in batches the
                      professor sizes (just-in-time by default)      🧑 checkpoint per batch
Stage 3  ASSESS     — assessment-architect per assessment_plan
                      entry + integrity-check                        🧑 checkpoint per instrument
Gate 3.5 QUALITY    — quality_gate_protocol; BLOCK → back to 2/3     ✓ machine + professor ack
Stage 4  DELIVER    — weekly loop for the whole term:
                      just-in-time builds · student-mentor on demand
                      · midcourse feedback at week 4–6               🧑 checkpoint per cycle
Stage 5  REFLECT    — teaching-reflector eval-analysis +
                      evidence triangulation                         🧑 checkpoint
Stage 6  IMPROVE    — iteration record → passport iteration_history;
                      prioritized change list; offer re-entry:
                      next term → Stage 1 redesign with evidence     🧑 checkpoint

Stage	Skill / mode dispatched	Artifacts	Checkpoint / gate
0 CONTEXT	(this skill) intake	course_passport.yaml initialized	🧑 context confirmed
1 DESIGN	course-designer full (or redesign in new-term)	passport design fields, syllabus.md, design_rationale.md	🧑 per course-designer's internal checkpoints
1.5 ALIGNMENT	gate_runner → shared/alignment_gate_protocol.md	gates.alignment_gate findings + status	✓ machine checks + professor acknowledgment; BLOCK → Stage 1, max 3 rounds
2 BUILD	lesson-builder week-batch	lessons/W* packages, schedule artifact_refs	🧑 per batch
3 ASSESS	assessment-architect (exam/quiz/project-brief/rubric… per assessment_plan type) + integrity-check	instruments + rubrics, ai_resilience set per assessment	🧑 per instrument
3.5 QUALITY	gate_runner → shared/quality_gate_protocol.md	gates.quality_gate findings + status	✓ machine checks + professor acknowledgment; BLOCK → Stage 2/3, max 3 rounds
4 DELIVER	weekly: lesson-builder week-batch (next week); student-mentor (on demand); submission-auditor spec/audit/batch-audit (on demand, when work comes in); teaching-reflector midcourse (week 4–6)	week materials, mentoring outputs, submission audit reports, midcourse report	🧑 per weekly cycle; person-affecting outputs per Checkpoint Protocol hard rule
5 REFLECT	teaching-reflector eval-analysis + triangulation with peer/artifact evidence	evaluation analysis report	🧑 analysis confirmed
6 IMPROVE	iteration_coach	iteration_history entry, prioritized change list, redesign brief	🧑 record confirmed; offer new-term

Build-ahead depth (Stage 2): the pipeline does not default to building all 16 weeks up front. At the Stage 2 entry checkpoint the professor chooses a batch depth — first week only, first unit, through the first exam, or everything. Just-in-time per week/unit is the recommended default: lessons built months ahead go stale against the real classroom. The choice is recorded in the passport and drives the Stage 4 loop.

Mid-Entry Routing

Mid-entry is first-class, not an exception. The orchestrator validates what exists into the passport (Iron Rule 3) and enters at the earliest stage whose entry invariants are unmet (references/pipeline_state_machine.md).

"I have…"	Entry point
Nothing — new course, blank page	Stage 0 full (offer course-designer socratic if aims are vague)
An old syllabus / inherited course outline	Stage 0 intake → back-fill passport from the syllabus (confirmed, not assumed) → course-designer align-check to validate → Gate 1.5 → Stage 2 (or back to Stage 1 redesign if the gate fails)
A full confirmed design but no class materials	Validate passport (or build one from the design) → Gate 1.5 if not_run → Stage 2
Materials built but no exams/rubrics	Validate → Stage 3 (Gate 1.5 must show pass; if not_run, run it first — it is cheap and catches what Stage 3 would inherit)
Mid-semester, week N, course already running	Validate passport + ask/confirm calendar position → enter the Stage 4 loop at week N; Gates run retroactively only if the professor wants the audit
Term just ended, student evals in hand	Validate → Stage 5 (eval-analysis) → Stage 6

Stage 4 — The Weekly Delivery Loop

Stage 4 is the term itself. Each cycle answers the Monday question: "Week N — what's due?"

each week N of the term:
  1. ORIENT   — passport + calendar: what's taught in W(N+lead), what assessments are
                due/upcoming, what's already built (artifact_refs)
  2. BUILD    — just-in-time window: lesson-builder week-batch for the next unbuilt
                week(s) within the professor's chosen lead time (default: next week)
  3. SUPPORT  — student-mentor on demand ONLY: feedback batches, a struggling student
                the professor brings up, emails, office-hours prep;
                submission-auditor when work comes in: spec confirmed at assignment
                release, audit/batch-audit at collection
  4. MIDCOURSE— at week 4–6 (once): offer teaching-reflector `midcourse` — early
                feedback while there is still time to act on it
  5. CHECK    — 🧑 weekly checkpoint: what shipped, what's pending, next Monday's picture

Rules of the loop:

• Resumable by calendar. "What week are we in?" is answered from the passport's stored term calendar + today's date; a fresh session lands in the right cycle without recap. If the calendar was never stored, ask once and store it (Iron Rule 5).
• Struggling-student support is on-demand and NEVER auto-initiated. The pipeline does not scan grades, attendance, or any data for struggling students — the professor brings the concern, with the evidence. Privacy is structural, not configurable.
• Person-affecting outputs (feedback on named work, intervention emails, letters) follow the Checkpoint Protocol hard rule: evidence-bound, never auto-finalized, final human pass — and none of it enters the passport (Iron Rule 6).
• Midcourse fires once, in the week 4–6 window, as an offer — the professor may decline; the decline is logged so it is not re-offered weekly.

Agent Team (4)

Agent	Role
pipeline_orchestrator_agent	Dispatch: reads passport, determines stage, invokes sibling skill modes, enforces stage order and gate blocking, routes mid-entry, collapses checkpoints on "just proceed"
passport_keeper_agent	State: passport read/validate/append per schema iron rules; reconciles hand-edited passports by asking; emits the status report; resume protocol for fresh sessions
gate_runner_agent	Gates: executes both gate protocols verbatim at 1.5 and 3.5; read-only except gates.*; findings cite passport ids; 3-round escalation rule
iteration_coach_agent	Stage 6: assembles semester evidence into the iteration record, prioritizes changes (impact × effort × evidence-confidence), writes iteration_history, prepares next term's redesign brief; protects what worked

Iron Rules

1. The passport is the single source of truth. State lives in course_passport.yaml, never in the conversation. A fresh session loads the passport and continues; anything not in the passport did not happen, and no skill assumes context the passport doesn't contain (Passport Iron Rule 2).
2. Gates are non-skippable in pipeline mode. Gate 1.5 and 3.5 always run and always end in professor acknowledgment. A BLOCK returns to the producing stage for at most 3 fix-and-rerun rounds; a BLOCK that survives 3 rounds is escalated to the professor as a recorded design decision, not repeated a fourth time. (Standalone sibling-skill use never forces a gate.)
3. Stage order is enforced downward only. Backward design (Pedagogy Foundations §1): no materials before confirmed outcomes, no instruments before a confirmed assessment plan, no delivery before the Quality Gate. But mid-entry validates existing work into the passport via align-check — it never makes a professor re-derive a design they already have.
4. Checkpoint provenance. confirmed_by_professor is set only at a real confirmation (Passport Iron Rule 4). "Just proceed" collapses checkpoints to minimal confirmations per the Checkpoint Protocol — it never skips the confirmation itself, and person-affecting outputs never collapse.
5. Calendar honesty. Never invent the academic calendar — term dates, breaks, exam weeks, add/drop deadlines are institutional facts. Ask once at Stage 0 (or first need), store in the passport, and compute "what week is it?" from that record only.
6. Person-affecting work stays out of the passport. Stage 4 outputs about identifiable students follow the Checkpoint Protocol's hard rule (evidence-bound, final human pass); student names, grades, and case details are never written into course_passport.yaml or any pipeline state file.

Extension Skills

Seven extension skills attach to pipeline stages on demand. The orchestrator offers them where they fit but never requires them — gates do not depend on extensions.

Stage	Extension dispatched	When
1 / 6	accreditation-mapper	Professor faces accreditation/program reporting; Stage 6 iteration records feed its continuous-improvement narrative
2	deck-studio	After lesson-builder slide outlines — render actual decks with the course theme
2	media-scripter	Flipped/online courses — script the recorded mini-lectures the flipped spec calls for
2–3	lab-forge	STEM courses — executable labs, per-student datasets, autograders (output feeds submission-auditor)
4	course-publisher	Weekly loop — announcements, weekly emails, course site, LMS packaging
4	ta-coordinator	Courses with TAs — onboarding before week 1, calibration before first graded assessment, consistency checks after
any	bilingual-courseware	Bilingual/EMI courses — glossary before the first translated artifact, sync checks on paired materials
0–1 / 4	cohort-analyst	Professor holds student readiness data — pre-term diagnostic before Stage 1 design; pre-lesson questionnaires feed week-N calibration in the Stage 4 loop. Aggregates only; never auto-initiated on individuals

Does NOT Trigger

Single-artifact requests route to the specific skill — the pipeline is for the lifecycle, not for one deliverable.

Scenario	Use instead
Design outcomes, a syllabus, or audit alignment only	course-designer
One lesson, lecture notes, slides, an activity, a case	lesson-builder
One exam, quiz, rubric, project brief, or an item analysis	assessment-architect
Feedback, a recommendation letter, a student email, office-hours prep	student-mentor
Check submissions against a template/standard, batch compliance reports	submission-auditor
Analyze evals, a peer observation, teaching statement, SoTL	teaching-reflector

Outputs

• course_passport.yaml — maintained continuously; the design, state, and audit record
• Stage artifacts produced via the sibling skills (syllabus, lesson packages, instruments, reports), each registered in passport artifacts[] with provenance
• Status reports (status mode) — stage, gates, pending confirmations, calendar position, next actions
• Iteration record (Stage 6) — iteration_history entry + prioritized change list + redesign brief for next term

References

• references/pipeline_state_machine.md — formal states, entry invariants, transitions, resumption algorithm
• Shared: shared/course_passport_schema.md, shared/alignment_gate_protocol.md, shared/quality_gate_protocol.md, shared/checkpoint_protocol.md, shared/ai_era_integrity.md, shared/pedagogy_foundations.md