improvement(academy): set 2, pages for the new video wave (workflow embeds, 2K players, full sequencing) by ouiliame · Pull Request #5382 · simstudioai/sim

ouiliame · 2026-07-02T23:32:10Z

Companion to simstudioai/sim-academy-videos PR #18 (Academy set 2 → main). Written supplements for the new video wave, in the videos' own pedagogical register.

What's here

Seven new pages: chat/intro, chat/building, agents/block, agents/tool-calling, agents/skills, agents/memory, knowledge-bases/connectors, tables/operations, tables/workflow-columns, files/object — house template (video → what-you-will-learn → chapters → prose), chapters timed to each recorded intro + VO.
academy-video-workflows.ts — a new workflow-preview registry reproducing, block-for-block, the workflows the videos actually build (invoice intake, the Qualify agent ± tools/skills, the memory agent, the Table query, support-desk with condition branches, content-agent with its parallel container). Every page embeds its video's machine.
Retimed/updated: tables/intro and files/intro (their videos were replaced by the recomposed/working-day cuts — new chapters; files/intro's embed swapped to the new machine), workflows/logs (gains its player src — the video now exists).
All players → the 2K blob set (academy/<slug>.mp4, 2560×1440@60): 20 pages rewritten off the old academy-preview URLs.
meta.json fully sequenced: Workflows(6) → Chat(2) → Agents(5) → Tables(3) → Files(2) → Knowledge Bases(2) → Use Cases.

Register

No poetry — plain explainer prose throughout, matching the narration register ("The same agent, with and without memory", not "The warm and cold split"); Related-documentation links point at real docs routes, not other academy pages.

Not included

Pages for agents-patterns / files-operations (DRAFT — variant selection open)
Use-case pages keep src-less placeholders (videos not produced)

…lls pages, sequenced in meta.json — pages for the four approved videos, blob src pattern, chapters offset by each recorded intro

…(mothership/agents/logs-debugging/deployment), not other academy videos

…pts pedagogy), sequenced after tables/intro

…-bases/connectors, tables/operations, files/object) + retimed chapters on the redone tables/files intros (recomposed/working-day cuts) + full meta.json sequencing — Chat · Agents(5) · Tables(3) · Files(2) · KB(2)

…eo-workflows.ts registry — invoice intake, Qualify, memory, table ops, tools/skills agents, support-desk, content-agent) + plain pedagogical headings throughout (no poetry: 'The warm and cold split' → 'The same agent, with and without memory', 'From one pass to a loop' → 'What tools change', etc.); files/intro's embed swapped to the video's machine

…p4) — 20 pages rewritten from academy-preview/*-light-with-intro, files/intro plays the new files-intro cut, workflows/logs gains its src (video now exists); use-case placeholders stay src-less (no videos yet)

vercel · 2026-07-02T23:32:13Z

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
docs	Ready	Preview, Comment	Jul 3, 2026 12:36am

cursor · 2026-07-02T23:32:21Z

PR Summary

Low Risk
Documentation and static MDX/TS content only; no runtime product logic, auth, or data paths.

Overview
Expands the English Academy with written supplements for the second video wave: new MDX lessons for Chat (intro, building with chat), Agents (block, tool calling, skills, memory), Tables (operations, workflow columns), Files (file object), and Knowledge bases (connectors), each using the shared lesson layout (video, learn list, chapters, prose, FAQ).

Adds academy-video-workflows.ts with block-accurate PreviewWorkflow definitions for the machines shown in those videos (invoice intake, Qualify ± tools/skills, memory agent, table query, support desk, content agent). Pages that match a video swap or add WorkflowPreview embeds to that registry instead of generic previews.

meta.json reorders and extends the sidebar: Workflows → Chat → Agents (five lessons) → Tables (three) → Files (two) → Knowledge bases (two) → Use cases.

Across existing and new pages, video URLs move from academy-preview/* to academy/<slug>.mp4 (2K blob set). workflows/logs gets a player src; files/intro and tables/intro get retimed chapters and updated embeds where the cut changed. Widespread copy tweaks (punctuation, FAQs on many workflow/agent pages) align tone with the narration; use-case pages stay placeholder-only for video.

^{Reviewed by Cursor Bugbot for commit 184b19d. Bugbot is set up for automated code reviews on this repo. Configure here.}

greptile-apps · 2026-07-02T23:33:54Z

Greptile Summary

This PR adds the next Academy content wave and updates the video set.

New Chat, Agents, Tables, Files, and Knowledge Bases Academy pages.
A new Academy workflow-preview registry for page embeds.
Existing Academy players moved to the academy/ blob paths.
Academy sidebar sequencing updated in meta.json.

Confidence Score: 4/5

The Academy pages are mostly safe, but the support-desk workflow embed has a broken condition branch configuration.

The new workflow registry can render the Chat workflow incorrectly because the condition rows are stored under the wrong field.
The Logs page now depends on a new production blob URL and has no page-level fallback if that asset is missing.
The navigation and most MDX content changes are straightforward.

apps/docs/components/workflow-preview/academy-video-workflows.ts; apps/docs/content/docs/en/academy/workflows/logs.mdx

Important Files Changed

Filename	Overview
apps/docs/components/workflow-preview/academy-video-workflows.ts	Adds Academy-specific workflow preview constants, with one condition block using the wrong field for branch rows.
apps/docs/content/docs/en/academy/meta.json	Adds the new Academy pages to the sidebar sequence with matching page entries.
apps/docs/content/docs/en/academy/workflows/logs.mdx	Switches the Logs Academy page from a placeholder card to a real video source.
apps/docs/content/docs/en/academy/*/.mdx	Adds and refreshes Academy pages with updated video sources and workflow embeds.

_{Reviews (1): Last reviewed commit: "biome: format academy-video-workflows.ts" | Re-trigger Greptile}

greptile-apps · 2026-07-02T23:33:57Z

+      conditions: [
+        { id: 'condition-if', label: 'If', value: '<triage.urgent>' },
+        { id: 'condition-else', label: 'else' },
+      ],


Condition Branches Are Ignored

The workflow preview renderer reads condition rows from branches, but this new support-desk preview writes them under conditions. When the Chat page renders this workflow, the Urgent? block has no If/else branch rows or matching source handles, so the two outgoing condition edges attach to handles the node never creates.

Suggested change

conditions: [

{ id: 'condition-if', label: 'If', value: '<triage.urgent>' },

{ id: 'condition-else', label: 'else' },

],

branches: [

{ id: 'condition-if', label: 'If', value: '<triage.urgent>' },

{ id: 'condition-else', label: 'else' },

],

Note: If this suggestion doesn't match your team's coding style, reply to this and let me know. I'll remember it for next time!

greptile-apps · 2026-07-02T23:33:58Z

@@ -8,7 +8,7 @@ import { WhatYouWillLearn } from '@/components/ui/what-you-will-learn'
 import { VideoChapters } from '@/components/ui/video-chapters'
 import { WorkflowPreview, ROUTER_TRIAGE_WORKFLOW } from '@/components/workflow-preview'


Missing Video Fallback

This page changes from the src-less "Coming soon" state to a real player that points at a newly introduced blob URL. If academy/workflows-logs.mp4 is not present in the production blob set when this lands, VideoPlaceholder treats the page as playable and renders a broken video instead of falling back to the placeholder.

…ows:[] (the renderer's real fields — conditions: was never read, so Urgent? rendered without if/else handles and branch edges dangled); bgColor aligned to the product condition example

ouiliame · 2026-07-02T23:35:25Z

Review fixes in c9de5fe17:

Condition branches (cursor + greptile P1): fixed — the support-desk preview's Urgent? block now uses rows: [] + branches: (the fields the renderer actually reads), matching the CONDITION_ROUTE example; bgColor aligned to the product condition example while there.
workflows-logs blob (greptile P2): verified present — academy/workflows-logs.mp4 returns HTTP 200 on the production blob (uploaded with the full 2K set before this PR), so the player has a live asset at merge time.

…idea> — support-desk Triage and content-agent Writer message rows now match the product's Start output (same pattern as the file's other workflows)

…ex (grounded in the audited codebase facts: memory modes, the ten table ops, coerce/refuse, deploy surfaces + draft-vs-deployed, file parser formats; the FAQ component emits FAQPage JSON-LD for SEO); em-dashes 202 → 0 with hand-fixed splices; added copy where sparse (agent block placement, when-to-use-memory); SEO phrasing sprinkled naturally into FAQ answers ('visual platform for building AI workflows and agents', 'no-code', model names), not over-indexed

… pass (unquoted YAML scalars with a second colon broke every page)

cursor

Cursor Bugbot has reviewed your changes using default effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 184b19d. Configure here.}

cursor · 2026-07-03T00:32:53Z

+    },
+    { id: 'candidates-evaluator', source: 'candidates', target: 'evaluator' },
+    { id: 'evaluator-scores', source: 'evaluator', target: 'scores' },
+  ],


Content agent preview incomplete

Medium Severity

The new AV_CONTENT_AGENT_WORKFLOW embed is described in the same change as block-for-block video reproduction, but its parallel container only contains a single Writer block. The chat/building page text still describes multiple generation steps (image, deck, voiceover) alongside drafting and scoring, so the diagram understates the machine learners expect from the lesson.

Additional Locations (1)

apps/docs/content/docs/en/academy/chat/building.mdx#L19-L65

^{Reviewed by Cursor Bugbot for commit 184b19d. Configure here.}

ouiliame added 7 commits July 2, 2026 11:23

academy: Chat section (intro, building) + Agents tool-calling and ski…

dfb0ae2

…lls pages, sequenced in meta.json — pages for the four approved videos, blob src pattern, chapters offset by each recorded intro

academy pages: Related documentation links point at real docs routes …

fbc1e06

…(mothership/agents/logs-debugging/deployment), not other academy videos

academy: Tables — Workflow Columns page (combined-cut chapters, recei…

93be6bf

…pts pedagogy), sequenced after tables/intro

biome: format academy-video-workflows.ts

562415c

cursor Bot reviewed Jul 2, 2026

View reviewed changes

Comment thread apps/docs/components/workflow-preview/academy-video-workflows.ts

greptile-apps Bot reviewed Jul 2, 2026

View reviewed changes

vercel Bot had a problem deploying to Preview July 2, 2026 23:35 Failure

fix (cursor/greptile): support-desk condition block uses branches + r…

c9de5fe

…ows:[] (the renderer's real fields — conditions: was never read, so Urgent? rendered without if/else handles and branch edges dangled); bgColor aligned to the product condition example

cursor Bot reviewed Jul 2, 2026

View reviewed changes

Comment thread apps/docs/components/workflow-preview/academy-video-workflows.ts Outdated

vercel Bot deployed to Preview July 2, 2026 23:40 View deployment

ouiliame added 2 commits July 2, 2026 16:41

biome: format meta.json (CI lint:check)

fbc21a0

fix (cursor): Start exposes <start.input>, not <start.ticket>/<start.…

0985082

…idea> — support-desk Triage and content-agent Writer message rows now match the product's Start output (same pattern as the file's other workflows)

vercel Bot deployed to Preview July 2, 2026 23:49 View deployment

ouiliame added 2 commits July 2, 2026 17:30

fix: quote frontmatter descriptions that gained colons in the em-dash…

184b19d

… pass (unquoted YAML scalars with a second colon broke every page)

cursor Bot reviewed Jul 3, 2026

View reviewed changes

vercel Bot deployed to Preview July 3, 2026 00:36 View deployment

waleedlatif1 changed the title ~~Academy set 2 — pages for the new video wave (workflow embeds, 2K players, full sequencing)~~ improvement(academy): set 2, pages for the new video wave (workflow embeds, 2K players, full sequencing) Jul 3, 2026

waleedlatif1 merged commit 3e71084 into staging Jul 3, 2026
19 checks passed

waleedlatif1 deleted the feat/docs-academy-videos-set-2 branch July 3, 2026 01:36

waleedlatif1 mentioned this pull request Jul 3, 2026

v0.7.22: competitor pages, seo fixes, billing usage table #5393

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

improvement(academy): set 2, pages for the new video wave (workflow embeds, 2K players, full sequencing)#5382

improvement(academy): set 2, pages for the new video wave (workflow embeds, 2K players, full sequencing)#5382
waleedlatif1 merged 12 commits into
stagingfrom
feat/docs-academy-videos-set-2

ouiliame commented Jul 2, 2026 •

edited by waleedlatif1

Loading

Uh oh!

vercel Bot commented Jul 2, 2026 •

edited

Loading

Uh oh!

cursor Bot commented Jul 2, 2026 •

edited

Loading

Uh oh!

Uh oh!

greptile-apps Bot commented Jul 2, 2026

Uh oh!

greptile-apps Bot Jul 2, 2026

Uh oh!

greptile-apps Bot Jul 2, 2026

Uh oh!

ouiliame commented Jul 2, 2026

Uh oh!

Uh oh!

cursor Bot left a comment

Uh oh!

cursor Bot Jul 3, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

		@@ -8,7 +8,7 @@ import { WhatYouWillLearn } from '@/components/ui/what-you-will-learn'
		import { VideoChapters } from '@/components/ui/video-chapters'
		import { WorkflowPreview, ROUTER_TRIAGE_WORKFLOW } from '@/components/workflow-preview'

Uh oh!

Conversation

ouiliame commented Jul 2, 2026 • edited by waleedlatif1 Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

What's here

Register

Not included

Uh oh!

vercel Bot commented Jul 2, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

cursor Bot commented Jul 2, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

PR Summary

Uh oh!

Uh oh!

greptile-apps Bot commented Jul 2, 2026

Greptile Summary

Confidence Score: 4/5

Important Files Changed

Uh oh!

greptile-apps Bot Jul 2, 2026

Choose a reason for hiding this comment

Uh oh!

greptile-apps Bot Jul 2, 2026

Choose a reason for hiding this comment

Uh oh!

ouiliame commented Jul 2, 2026

Uh oh!

Uh oh!

cursor Bot left a comment

Choose a reason for hiding this comment

Uh oh!

cursor Bot Jul 3, 2026

Choose a reason for hiding this comment

Content agent preview incomplete

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

ouiliame commented Jul 2, 2026 •

edited by waleedlatif1

Loading

vercel Bot commented Jul 2, 2026 •

edited

Loading

cursor Bot commented Jul 2, 2026 •

edited

Loading