fix(docs): address second round of PR review feedback

- Add npm command check to render script (was only checking node/npx)
- Memoize highlight() tokenization in CodeBlock — Remotion re-renders every
  frame and code is static per instance, so useMemo avoids repeated work
- Rewrite README to describe the IronClaw architecture video project instead
  of the default Remotion template

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: ilblackdragon

docs/architecture-video/README.md

@@ -1,54 +1,58 @@
-# Remotion video
+# IronClaw Architecture Overview Video
 
-<p align="center">
-  <a href="https://github.com/remotion-dev/logo">
-    <picture>
-      <source media="(prefers-color-scheme: dark)" srcset="https://github.com/remotion-dev/logo/raw/main/animated-logo-banner-dark.apng">
-      <img alt="Animated Remotion Logo" src="https://github.com/remotion-dev/logo/raw/main/animated-logo-banner-light.gif">
-    </picture>
-  </a>
-</p>
+A Remotion-based animated video that walks new contributors through IronClaw's
+internals — the five primitives, execution loop, CodeAct, thread state machine,
+skills pipeline, tool dispatcher, channels, extensibility traits, and the LLM
+provider decorator chain.
 
-Welcome to your Remotion project!
+See the project-level render script and Claude skill for end-to-end use:
+
+- `scripts/render-architecture-video.sh` — one-command MP4 render
+- `.claude/skills/architecture-video/SKILL.md` — how to update scenes when
+  architecture changes
 
 ## Commands
 
-**Install Dependencies**
+Install dependencies (first time only):
 
 ```console
-npm i
+npm ci
 ```
 
-**Start Preview**
+Preview in browser (Remotion Studio with hot reload):
 
 ```console
 npm run dev
 ```
 
-**Render video**
+Render to MP4 from this directory:
 
 ```console
-npx remotion render
+npx remotion render IronClawArchitecture out.mp4
 ```
 
-**Upgrade Remotion**
+Or from the repository root:
 
 ```console
-npx remotion upgrade
+./scripts/render-architecture-video.sh output.mp4
 ```
 
-## Docs
-
-Get started with Remotion by reading the [fundamentals page](https://www.remotion.dev/docs/the-fundamentals).
-
-## Help
+Type-check and lint:
 
-We provide help on our [Discord server](https://discord.gg/6VzzNDwUwV).
+```console
+npm run lint
+```
 
-## Issues
+## Structure
 
-Found an issue with Remotion? [File an issue here](https://github.com/remotion-dev/remotion/issues/new).
+- `src/IronClawArchitecture.tsx` — scene sequencing, durations, transitions
+- `src/scenes/*.tsx` — one file per scene (12 total)
+- `src/components/Code.tsx` — shared syntax-highlighted code block
+- `src/theme.ts` — shared colors and fonts
+- `src/Root.tsx` — Remotion composition registration
 
 ## License
 
-Note that for some entities a company license is needed. [Read the terms here](https://github.com/remotion-dev/remotion/blob/main/LICENSE.md).
+This video project is part of IronClaw and dual-licensed MIT OR Apache-2.0.
+Remotion itself has a [custom license](https://github.com/remotion-dev/remotion/blob/main/LICENSE.md);
+use is covered under the open-source free tier for this project.

docs/architecture-video/src/components/Code.tsx

@@ -1,3 +1,4 @@
+import React, { useMemo } from "react";
 import { COLORS, FONTS } from "../theme";
 
 type Token = { text: string; color?: string };
@@ -79,7 +80,8 @@ export const CodeBlock: React.FC<{
   opacity?: number;
   style?: React.CSSProperties;
 }> = ({ code, fontSize = 15, opacity = 1, style = {} }) => {
-  const lines = highlight(code);
+  // Memoize tokenization — Remotion re-renders every frame and `code` is static.
+  const lines = useMemo(() => highlight(code), [code]);
   return (
     <div
       style={{

scripts/render-architecture-video.sh

@@ -20,6 +20,11 @@ if ! command -v npx &>/dev/null; then
   exit 1
 fi
 
+if ! command -v npm &>/dev/null; then
+  echo "Error: npm is required to install dependencies." >&2
+  exit 1
+fi
+
 if [ ! -d "$VIDEO_DIR/node_modules" ]; then
   echo "Installing dependencies..."
   if [ -f "$VIDEO_DIR/package-lock.json" ]; then