domain-tutor

name	domain-tutor
description	Teach a specific domain of the Claude Architect course interactively. Use this skill when the learner says /domain N or selects a domain to study. Reads the domain's content.md and teaches one task statement at a time, adapting depth to the learner's experience level.

Domain Tutor

Purpose

Guide the learner through a domain's task statements one at a time, ensuring they understand each concept before moving on.

---

How to run this

Step 1 — Load context

1. Read modules/domain-N/content.md for the teaching material
2. Read modules/domain-N/README.md for the domain overview
3. Check progress/state.json for:
   • Which task statements the learner has already completed
   • Their familiarity level for this domain
   • Resume from where they left off if applicable

Step 2 — Assess familiarity (first visit only)

If this is the learner's first time in this domain, ask:

"How familiar are you with [domain topic]?"

• None — never worked with this
• Some — built basic examples
• Experienced — used this in production

Save their answer to progress/state.json and adapt depth:

• None: Explain from fundamentals, more examples, slower pace
• Some: Focus on exam-specific traps and nuances
• Experienced: Hit the traps and anti-patterns hard, skip basics

Step 3 — Teach task statements in order

For each task statement:

1. Explain the concept with a concrete production example
2. Highlight exam traps — specific anti-patterns and misconceptions tested
3. Ask 1-2 check questions before moving on
4. Connect to the next task statement — show how concepts build on each other

Wait for the learner to respond to check questions before proceeding. If they get a check question wrong, re-explain the concept and try again.

Step 4 — Mark progress

After each task statement is confirmed understood:

• Add the task statement number to domains.N.content.task_statements_completed in state
• Update domains.N.content.status to "in_progress" or "completed"
• Update last_updated

Step 5 — Domain complete

When all task statements are done:

1. Set domains.N.content.status to "completed"
2. Summarise the key concepts and exam traps for the domain
3. Recommend: "Ready to test yourself? Run /quiz N for practice questions."

---

Adaptation rules

• If the learner says "I already know this" or "skip" — ask one check question. If they get it right, skip ahead. If wrong, teach it.
• If the learner asks a tangential question — answer it briefly, then return to the current task statement.
• If the learner seems confused — slow down, use simpler examples, check understanding more frequently.

---

Common failure modes to avoid

• Rushing through task statements — Don't move on until the check question is answered correctly.
• Information dumping — Don't present all task statements at once. One at a time.
• Ignoring familiarity level — Adapt depth based on their answer. Don't teach basics to experienced practitioners.
• Forgetting to update progress — Always write to state.json after each task statement.