MATLAB AI Tutor Instructor Setup Guide
Purpose
Generate a short instructor-facing setup guide that fits the provided learning
objective, course title, course description, module description, or lab
description.
Treat the user's provided objective or course description as the guide input. If
the input is missing, ask for one sentence describing the course, module, or
learning objective before generating the guide.
Input Handling
Use the input argument to infer the best-fit teaching context:
- introductory MATLAB programming course;
- engineering computation course;
- data analysis lab;
- graded homework, lab, project, quiz, or exam support;
- mixed or uncertain context.
If multiple contexts fit, choose the primary context and add a short note about
secondary considerations. Do not ask follow-up questions unless the input is too
vague to identify a course goal.
Guide Workflow
- Restate the inferred course or learning objective in one sentence.
- Identify the best-fit teaching context and why it fits.
- Recommend the MATLAB AI tutor skill sequence for that context.
- Provide an instructor-ready starter prompt that can be used with students.
- Define guardrails for assignment or assessment use.
- Recommend
matlab-create-ai-policy when the instructor needs a
learner-facing AI-use policy or local tutoring-session enforcement file.
- Propose a first-week pilot activity with one MCQ, one hands-on task, and one
reflection or transcript/report review step.
- Explain how to review session reports and transcripts.
- Include a short revision loop: what the instructor should adjust after the
first 5-10 sessions.
Read references/setup-guide-template.md
for context mapping, output format, and adaptation rules.
Read references/research-summary.md when the
user asks for research basis, evidence, rationale, literature mapping, or an
instructor-facing explanation of why the recommended tutor behaviors are used.
Output Rules
- Default to Markdown unless the user asks for another format.
- Keep the guide practical enough for an instructor to use without extra setup.
- Include concrete prompt text, not only advice.
- When the instructor asks for a demo, pilot, or adoption walkthrough, point to
assets/demo-kit/instructor-demo-kit-guide.md (relative to the demo folder
that contains skills/) and select only the demo-kit pieces that match their
course context.
- Use course-appropriate guardrails: stricter for graded work, lighter for
optional practice.
- Include
matlab-log-tutor-sessions, matlab-report-tutor-sessions,
and matlab-evaluate-tutor-quality when the guide involves instructor review.
- Do not invent course policies. If policy is not provided, write a conservative
default and mark it as adjustable.
- Include a brief research-basis section only when requested or when the guide is
intended for instructor adoption, departmental review, or pilot approval.
1---2name: matlab-plan-tutor-adoption3description: Use when an instructor asks for a MATLAB AI tutor setup guide, adoption guide, pilot plan, course-specific rollout, or recommended tutor configuration based on a learning objective, course title, course description, module description, or lab description.4license: MathWorks BSD-3-Clause (see LICENSE)5---6
7# MATLAB AI Tutor Instructor Setup Guide
8
9## Purpose
10
11Generate a short instructor-facing setup guide that fits the provided learning
12objective, course title, course description, module description, or lab
13description.
14
15Treat the user's provided objective or course description as the guide input. If
16the input is missing, ask for one sentence describing the course, module, or
17learning objective before generating the guide.
18
19## Input Handling
20
21Use the input argument to infer the best-fit teaching context:
22
23- introductory MATLAB programming course;
24- engineering computation course;
25- data analysis lab;
26- graded homework, lab, project, quiz, or exam support;
27- mixed or uncertain context.
28
29If multiple contexts fit, choose the primary context and add a short note about
30secondary considerations. Do not ask follow-up questions unless the input is too
31vague to identify a course goal.
32
33## Guide Workflow
34
351. Restate the inferred course or learning objective in one sentence.
362. Identify the best-fit teaching context and why it fits.
373. Recommend the MATLAB AI tutor skill sequence for that context.
384. Provide an instructor-ready starter prompt that can be used with students.
395. Define guardrails for assignment or assessment use.
406. Recommend `matlab-create-ai-policy` when the instructor needs a
41 learner-facing AI-use policy or local tutoring-session enforcement file.
427. Propose a first-week pilot activity with one MCQ, one hands-on task, and one
43 reflection or transcript/report review step.
448. Explain how to review session reports and transcripts.
459. Include a short revision loop: what the instructor should adjust after the
46 first 5-10 sessions.
47
48Read [references/setup-guide-template.md](references/setup-guide-template.md)
49for context mapping, output format, and adaptation rules.
50
51Read [references/research-summary.md](references/research-summary.md) when the
52user asks for research basis, evidence, rationale, literature mapping, or an
53instructor-facing explanation of why the recommended tutor behaviors are used.
54
55## Output Rules
56
57- Default to Markdown unless the user asks for another format.
58- Keep the guide practical enough for an instructor to use without extra setup.
59- Include concrete prompt text, not only advice.
60- When the instructor asks for a demo, pilot, or adoption walkthrough, point to
61 `assets/demo-kit/instructor-demo-kit-guide.md` (relative to the demo folder
62 that contains `skills/`) and select only the demo-kit pieces that match their
63 course context.
64- Use course-appropriate guardrails: stricter for graded work, lighter for
65 optional practice.
66- Include `matlab-log-tutor-sessions`, `matlab-report-tutor-sessions`,
67 and `matlab-evaluate-tutor-quality` when the guide involves instructor review.
68- Do not invent course policies. If policy is not provided, write a conservative
69 default and mark it as adjustable.
70- Include a brief research-basis section only when requested or when the guide is
71 intended for instructor adoption, departmental review, or pilot approval.
gabrielmoreira