Track curriculum migration: move source content into repo and align 3-course model

[projectamazonph]

Goal

Turn AMPH from a platform with imported lesson text into a current, job-ready Amazon PPC training product, per docs/CONTENT-AUDIT-2026-07-16.md and docs/CURRICULUM-REDESIGN.md.

Reference docs (already in docs/)

• docs/CONTENT-AUDIT-2026-07-16.md - critical P0/P1 issues + release plan
• docs/CURRICULUM-REDESIGN.md - target 3-course model, module map, assessments, production order
• docs/VIDEO-EXPLAINER-SCRIPTS.md - 8 Foundations video scripts
• docs/0-1-welcome-to-amph.md - Module 0 lesson 1 (sample)
• docs/1-1-read-ppc-data-before-you-change-it.md - Module 1 lesson 1 (sample)
• docs/CONTENT-UPDATE-PLAN.md - Release 1 file-by-file execution plan (new)

Release 1 - Trust and safety

• Move curriculum source into content/curriculum/ (stop reading from hard-coded Android path in scripts/import-amph-content.ts) - P0 (PR fix(content): version curriculum source in the repo, drop Android path #26)
• Replace legacy product/feature references (AdCraft, AI Mentor, Formula Calculator, wrong simulator names) - P0
• Correct factual claims: portfolios, attribution windows, auction/CPC, listing quality score, dayparting - P0
• Align three pricing tiers with access rules and actual content - P0 (code side done; see notes)
• Add factual-review metadata (Amazon Ads Fact Card) to time-sensitive lessons - P0

Release 2 - Foundations that lead to action

• Rewrite foundation + campaign-building lessons using the lesson-production standard (PRs content: rebuild Module 0 and Module 1 to the v2 production standard #31, content: audit modules 2-8, fix factual/arithmetic bugs and stale terms #32, content: rebuild Modules 2-8 to the full lesson-production standard #36 — all of Modules 0-8 now have the full 10-block structure: client outcome, decision card, worked case, your turn, tool/worksheet, client language, check, fact card)
• Ship short video explainers + matching practice sheets
• Add calculation, keyword-map, and campaign-rationale artifacts with rubrics

Release 3 - Operator and client readiness

• Build advanced optimization, reporting, client-delivery modules
• Add rubric-based assessments + portfolio capstone
• Add human-review workflows for Ultimate learners

Notes

• This issue tracks content work only. Code-side blockers (renderer cannot show tables/ordered lists/links/images/video) are called out in the audit and should get their own issue if not already present.
• Release 1 is code/content complete as of the work described in the comments below. Two follow-ups before the pricing-tier item is fully done end-to-end: (1) the fact cards' Last verified/Next review due/Owner fields are placeholders for the content owner to fill in, and (2) the new two-course split in scripts/import-amph-content.ts has not been run against a real database yet — verify against a non-production DB first.
• Release 2's first checklist item is now fully complete (see PR content: rebuild Modules 2-8 to the full lesson-production standard #36): Modules 2-8 (23 files) got the remaining "What you can do after this lesson", "The decision in one sentence", "Your turn", and "Client language" blocks that Modules 0-1 already had, closing the gap flagged in the earlier status comment. Video explainer production and rubric-graded artifacts remain open for Release 2.
• The module-numbering mismatch flagged in an earlier handoff is resolved (PR docs: reconcile curriculum redesign doc with the live module structure #35): docs/CURRICULUM-REDESIGN.md now describes the live module structure instead of an unimplemented reorg.

[projectamazonph]

Release 1 ("Trust and safety") is done. Summary:

Plan: docs/CONTENT-UPDATE-PLAN.md — file-by-file work order for every remaining P0, with exact lines and required-replacement text pulled from the audit.

Legacy references removed: AdCraft, AI Mentor, Formula Calculator, and "STR Triage Arena" purged from onboarding + module 4/6/7 practice-prep lessons. Replaced with the real platform (4-tab nav, 5 named tools).

Five factual corrections + fact cards, one per claim in the audit's table:

• Portfolios don't carry shared negatives/bid adjustments (campaign-level controls)
• Attribution windows aren't a fixed 7-day SP / 14-day SB rule — taught as an account setting to verify
• Auction isn't a simple "$0.01 above next bid" mechanic — reframed around bid ceiling + monitoring realized CPC
• "Listing Quality Score" reframed as "listing and ad relevance signals" (teaching shorthand, not a real inspectable metric)
• Dayparting qualified as eligibility-dependent, with a manual fallback

Course/tier split: scripts/import-amph-content.ts now creates two Course rows (ppc-foundations = modules 0-4, accelerated-mastery = modules 5-8) instead of one course tied to a single tier — matches the existing Course.pricingTierId schema, no migration needed. ultimate-transformation intentionally still has no course (its modules don't exist yet — Release 3).

Two things still need a human before this is fully closed out:

1. The fact cards' Last verified / Next review due / Owner fields are placeholders — need the content owner to fill in.
2. The course-split script has been reviewed by hand but not run against a real database (no DATABASE_URL in this session). If this importer has ever run against production before, the module 5-8 slug prefix changed (amph-foundations-* → accelerated-mastery-*) — reconcile old rows before re-running for real.

Full detail in SESSION-HANDOVER.md's "Content track: Release 1 plan + execution" section. Next up is Release 2 (full lesson rewrites to the 10-block production standard) per docs/CURRICULUM-REDESIGN.md.

---

Generated by Claude Code

[projectamazonph]

Status update from the Release 2 content pass (PRs #31, #32, #35, all merged):

Done:

• Modules 0 and 1 fully rewritten to the lesson-production standard in docs/CURRICULUM-REDESIGN.md (client outcome, decision card, worked case, your turn, tool/worksheet, client language, check, fact card) — PR content: rebuild Module 0 and Module 1 to the v2 production standard #31.
• Modules 2-8 (23 files): full factual/arithmetic audit (docs/CONTENT-AUDIT-MODULES-2-8.md), 14 P0 bugs fixed, Module 8 frontmatter data-loss bug fixed, stale "break-even CPC" terminology retired, and a full voice-guide cleanup pass (em-dashes, emoji, acronym definitions, Quick check + What to read next sections, quiz coverage for Modules 2-3) — PR content: audit modules 2-8, fix factual/arithmetic bugs and stale terms #32.
• Two further CodeRabbit review rounds on PR content: audit modules 2-8, fix factual/arithmetic bugs and stale terms #32 addressed with live-research-backed fixes (Amazon Ads mechanics: Search Frequency Rank, placement buckets, Rest of Search 2024 update, discontinued Item Comparison report, Brand Analytics access requirements, non-media title-length limits, etc.).
• Module-numbering mismatch between CURRICULUM-REDESIGN.md's original draft and the live MODULE_META resolved — the doc now describes the structure as built, not an unimplemented reorg — PR docs: reconcile curriculum redesign doc with the live module structure #35.

Not done — Release 2 checklist item 1 is only partially complete:
Modules 2-8 got factual fixes and voice-guide compliance, but not the full 10-block lesson-production-standard restructure (no "Client outcome" / "Decision card" / "Your turn" / "Client language" blocks — only Modules 0-1 have those). Rebuilding Modules 2-8 to the full standard is still open if that's wanted for Release 2 sign-off, versus treating the current factual+voice pass as sufficient for this release.

Still fully open:

• Release 2 checklist items 2 and 3 (video explainer production, calculation/keyword-map/campaign-rationale artifacts with rubrics) — untouched this pass.
• The two Release-1 follow-ups noted above: fact-card Last verified/Next review due/Owner placeholders need a content owner to fill in, and the two-course DB split in scripts/import-amph-content.ts has still never been run against a real database.

---

Generated by Claude Code