MAX-542: add course waterfall build

artifacts/MAX-542/build-waterfall-comment.md

@@ -0,0 +1,22 @@
+## Build Waterfall
+
+Completed Content Engine v2 parent waterfall for MAX-542.
+
+- PR: https://github.com/maxtechera/orchestrator/pull/32
+- Committed build.md path: `artifacts/MAX-542/build.md`
+- Existing course outline path: `artifacts/MAX-542/course-outline-orchestrate-ai-agents.md`
+- Existing proof pack path: `docs/proofs/MAX-542/`
+- Deployed preview URL: https://github.com/maxtechera/orchestrator/tree/feat/MAX-542-content-waterfall-v2/artifacts/MAX-542
+
+Validation:
+```bash
+python3 /data/workspace/tools/package-builder.py validate-md --input artifacts/MAX-542/build.md
+# ✅ build.md valid + hashes fresh
+```
+
+Quality signals:
+- artifact_delta: added canonical v2 `build.md` with Ingredients, Script, Storyboard, and Presentation for the Orchestrate AI Agents course offer.
+- business_delta: course idea is now ready for Content Engine child placement spawning (landing + email) instead of legacy package/schema handling.
+- surface_correctness: work is in `maxtechera/orchestrator` (not openclaw-config), PR #32, with Linear visual proof attachments included.
+
+Visual proof attached from `docs/proofs/MAX-542/`.

artifacts/MAX-542/build.md

@@ -0,0 +1,120 @@
+---
+ticket: MAX-542
+brand: maxtechera
+content_type: lead_magnet
+created: "2026-05-08T14:18:29Z"
+hashes:
+  ingredients: "sha256:93ba16cc39202957"
+  script: "sha256:62ea9f32dd800480"
+  storyboard: "sha256:cb2bea6dfbd09c75"
+  presentation: "sha256:8f541a43a307ce08"
+placements:
+  - channel: landing
+    source: {script_beats: "all"}
+  - channel: email
+    source: {script_beats: "all"}
+gamma_file_id: null
+remotion_comp: null
+---
+
+## Ingredients
+- hook: "Stop being the QA department for your own AI agents."
+- cta: "Install the free Orchestrator workflow, run one verified ticket, then join the $197 Orchestrate AI Agents course for the full operating system."
+- value_prop: "A practical course that turns scattered AI-agent prompting into a ticket-based delivery machine with external verification, visual proof, and human review only where it matters."
+- offer: "$197 bilingual course (EN + ES) for operators, founders, and technical leads who want reliable AI-agent throughput across Linear, GitHub Issues, Notion, Jira, content, engineering, and ecommerce work."
+- intro: "Most AI-agent failures are not model failures; they are system failures. Orchestrate AI Agents teaches the verification layer, lifecycle, board design, domain skills, and self-improving rules that make agent work inspectable and scalable."
+
+## Script
+Beat 1 — Problem: Your AI agent can write, code, research, and draft. But if you still inspect every output manually, the agent did not remove work; it moved QA onto your plate.
+
+Beat 2 — Belief shift: Reliable agent operations do not come from better prompts alone. They come from separating execution from verification and forcing every ticket to produce proof.
+
+Beat 3 — Course promise: Orchestrate AI Agents teaches a practical operating system for running agents through scoped tickets, board states, verification criteria, domain skills, review gates, and continuous rule improvement.
+
+Beat 4 — Module 1: The Verification Problem. Students learn why AI self-grading fails, how hallucinated completion shows up, and why external artifacts beat agent confidence.
+
+Beat 5 — Module 2: Board Setup. Students build an agent-readable source of truth in Linear, GitHub Issues, Notion, or Jira with objective, delivery surface, proof, owner, and state fields.
+
+Beat 6 — Module 3: The 5-Stage Ticket Lifecycle. Students map work through Intake, Execute, Verify, Review, and Done so agents stop declaring victory before business intent and proof line up.
+
+Beat 7 — Module 4: Writing Verification Criteria. Students convert vague requests into observable checks: artifact delta, business delta, and surface correctness.
+
+Beat 8 — Module 5: Domain Skills. Students learn reusable execution patterns for content, engineering, ecommerce, and internal operations instead of rebuilding context from scratch every time.
+
+Beat 9 — Module 6: Self-Improving Rules. Every failure becomes a sharper instruction, verifier check, or routing rule so the system improves after mistakes instead of repeating them.
+
+Beat 10 — Module 7: Team Mode + Sweep Scheduling. Students coordinate specialist agents, verifier agents, and human reviewers across recurring sweeps without turning the founder into the bottleneck.
+
+Beat 11 — Funnel: The free GitHub Orchestrator install gives users their first verified ticket. The course CTA appears when they understand the gap: one workflow is useful, but domain depth is what makes the system durable.
+
+Beat 12 — CTA: Start with the free Orchestrator repo. After your first verified ticket, take Orchestrate AI Agents to build the full bilingual operating system for agent work.
+
+## Storyboard
+```yaml
+- n: 1
+  t_start: 0.0
+  duration_s: 6
+  script: "If you still inspect every AI-agent output manually, you are the QA department."
+  visual: "Split screen: agent claims Done; human buried in review comments."
+  sfx: "low_hit"
+  motion: "slow_push_in"
+  broll: "GitHub issue and Linear review proof"
+  on_camera: false
+  slide_ref: 1
+  emphasis: "hook"
+- n: 2
+  t_start: 6.0
+  duration_s: 7
+  script: "The fix is not just better prompting. It is a delivery system with external verification."
+  visual: "Simple diagram: Execute agent -> Verify agent -> Human review -> Done."
+  sfx: "whoosh_transition"
+  motion: "diagram_build"
+  broll: "auto"
+  on_camera: false
+  slide_ref: 2
+  emphasis: "belief_shift"
+- n: 3
+  t_start: 13.0
+  duration_s: 8
+  script: "Orchestrate AI Agents teaches the operating system: tickets, proof, routing, review gates, and self-improving rules."
+  visual: "Course promise slide with five pillars."
+  sfx: "soft_rise"
+  motion: "pillar_reveal"
+  broll: "auto"
+  on_camera: false
+  slide_ref: 3
+  emphasis: "promise"
+- n: 4
+  t_start: 21.0
+  duration_s: 18
+  script: "Modules cover the verification problem, board setup, the five-stage lifecycle, verification criteria, domain skills, self-improving rules, and team sweep scheduling."
+  visual: "Seven-module curriculum grid, EN/ES badges, $197 price anchor."
+  sfx: "click_sequence"
+  motion: "grid_reveal"
+  broll: "auto"
+  on_camera: false
+  slide_ref: 4
+  emphasis: "curriculum"
+- n: 5
+  t_start: 39.0
+  duration_s: 9
+  script: "Start with the free GitHub repo. After your first verified ticket, take the course to build the full system."
+  visual: "Funnel: GitHub install -> first verified ticket -> course CTA."
+  sfx: "resolve_chime"
+  motion: "arrow_flow"
+  broll: "repo screen capture"
+  on_camera: false
+  slide_ref: 5
+  emphasis: "cta"
+```
+
+## Presentation
+Slide 1 — Hook: "Stop being the QA department for your own AI agents." Show agent output beside human review burden.
+
+Slide 2 — Core mechanism: External verification. Diagram the handoff from Execute to Verify to Review to Done.
+
+Slide 3 — Course promise: A ticket-based AI-agent operating system for founders, operators, and technical leads.
+
+Slide 4 — Curriculum: seven modules: verification problem; board setup; 5-stage lifecycle; verification criteria; domain skills; self-improving rules; team mode + sweep scheduling.
+
+Slide 5 — Offer and funnel: Free GitHub Orchestrator install -> first verified ticket -> $197 bilingual EN/ES course CTA.

artifacts/MAX-542/final-proof-comment.md

@@ -0,0 +1,23 @@
+MAX-542 final verification — course outline delivery
+
+Mandatory pickup/check fields:
+- identifier: MAX-542
+- id/state: Linear ticket MAX-542, state In Review
+- labels: none visible from CLI output
+- inputs: Offer Stack `/orchestrator`; free repo `https://github.com/maxtechera/orchestrator`; course price $197; EN/ES title/tagline; requested module list; funnel trigger GitHub install → first verified ticket → course CTA
+- deliverables: finalized course outline, EN module script structure, ES adaptation notes/title/tagline, course page/CTA copy, README CTA
+- todo checklist: deliverables above are present in repo artifacts and README/docs surfaces
+- verification/acceptance criteria: Markdown package validates; expected artifacts exist; README CTA exists; PR created for human review
+- proof: `docs/proofs/MAX-542/` screenshots/video and command output
+- artifacts: `artifacts/MAX-542/course-outline-orchestrate-ai-agents.md`, `artifacts/MAX-542/build.md`, `docs/course-outline.md`, `README.md`
+
+Verification run:
+```bash
+cd /data/workspace/wt-MAX-542-orchestrator
+python3 /data/workspace/tools/package-builder.py validate-md --input artifacts/MAX-542/build.md
+test -s artifacts/MAX-542/course-outline-orchestrate-ai-agents.md && test -s docs/course-outline.md && test -s README.md
+```
+Result: ✅ `build.md valid + hashes fresh`; artifact smoke check passed.
+
+PR: https://github.com/maxtechera/orchestrator/pull/32
+Branch artifact URL: https://github.com/maxtechera/orchestrator/tree/feat/MAX-542-content-waterfall-v2/artifacts/MAX-542