claude
ae0d1da93b
Lock the course direction before applying it across modules: - AGENTS.md: the git reframe (concepts + "the AI drives git"; arithmetic-by-hand in M1-3, calculator/AI from M4 on; don't re-teach basics); Claude Code as the concrete worked example while staying model-agnostic in principle; lesson-vs-lab rule (lesson = theory only); no-slop voice rule (kill "prose" etc.). - _TEMPLATE.md: Key concepts = theory with example output (never "run this"); Hands-on lab is the only place things run, and from M4 on the learner directs the AI to do git/setup and verifies. Foundation for the M1-6 fixes and the M7-27+capstone sweep. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01TfzV5QvtPDz8LJS3Pu5VLT
95 lines
2.9 KiB
Markdown
95 lines
2.9 KiB
Markdown
<!--
|
||
Module template for *The Workflow*.
|
||
|
||
Copy this file to modules/NN-slug/README.md and fill every section. The shape is fixed on purpose:
|
||
it makes the course feel coherent and lets partial drafts be reviewed against a known structure.
|
||
Keep the section headings; delete these HTML comments and the guidance italics as you write.
|
||
|
||
Voice: direct, concrete, rigorous. Lead with the pain. Show the command and the failure mode.
|
||
No padding. See AGENTS.md for the full conventions.
|
||
-->
|
||
|
||
# Module NN — <Title>
|
||
|
||
> **<One-line hook.>** *Why this module exists for an IT pro — the pain it removes or the payoff it
|
||
> unlocks. One sentence. Make them want to keep reading.*
|
||
|
||
---
|
||
|
||
## Prerequisites
|
||
|
||
*Which prior modules this one depends on, named explicitly (the dependency chain). If a reader could
|
||
parachute in here with only some of the course, say what they minimally need.*
|
||
|
||
- Module X — <what it gave you that this module uses>
|
||
|
||
---
|
||
|
||
## Learning objectives
|
||
|
||
*3–5 outcomes, action verbs, phrased as what the reader can **do** afterward — not "understand X."*
|
||
|
||
By the end of this module you can:
|
||
|
||
1. …
|
||
2. …
|
||
3. …
|
||
|
||
---
|
||
|
||
## Key concepts
|
||
|
||
*The teaching content — **theory only**. Explain the concept and why it matters; reframe an ops
|
||
instinct the reader already has. To show a command, show it **with example output** as illustration —
|
||
do NOT tell the reader to run anything here (all hands-on is the lab, and the lesson must not
|
||
duplicate it). No "prose"/slop words. No fixed length — go as deep as the topic needs, no further.*
|
||
|
||
---
|
||
|
||
## The AI angle
|
||
|
||
*The module's AI-specific reason for existing — the thing that makes this more than a generic devops
|
||
lesson. Pull it from the syllabus entry for this module and make it concrete. This section is the
|
||
differentiator; never skip it.*
|
||
|
||
---
|
||
|
||
## Hands-on lab
|
||
|
||
*The only place the reader runs things. End at a keyboard, not a quiz. State the lab language
|
||
(Python or shell) once; provide starter files in `lab/` and reference them by path. **From Module 4
|
||
on, the learner directs the AI agent (Claude Code as the worked example) to do the git/setup work
|
||
and then verifies it — they don't type the commands by hand.** In Modules 1–3 the learner still
|
||
runs git manually, on purpose.*
|
||
|
||
**You'll need:** *<tools/setup required for this lab>*
|
||
|
||
**Steps:**
|
||
|
||
1. …
|
||
2. …
|
||
|
||
---
|
||
|
||
## Where it breaks
|
||
|
||
*The honest caveats — limits, pitfalls, where a tool or analogy stops holding. This section builds
|
||
trust with a skeptical audience. Always present; never sanded off.*
|
||
|
||
---
|
||
|
||
## Check for understanding
|
||
|
||
*A short self-check or a concrete "you're done when…" criterion. Self-assessment only — no grading.*
|
||
|
||
**You're done when:** …
|
||
|
||
---
|
||
|
||
## Verify-before-publish
|
||
|
||
*For fast-moving topics only: what to re-check at build/publish time — versions, pricing, tool
|
||
behavior, UI labels that drift. Omit this section for durable-core modules with nothing volatile.*
|
||
|
||
- [ ] …
|