book: Handwired (handwired)

.github/ISSUE_TEMPLATE/tweak-book.yml

@@ -17,6 +17,7 @@ body:
       options:
         # BOOKS:START (auto-generated by generator/sync-issue-books.mjs — do not edit by hand)
         - "Already Clean — neural-networks-already-clean"
+        - "Handwired · If-else, loops and state as matrix multiply and relu — handwired"
         - "Jeva: Fresh Decisions · Fixed options, set-aware judgment, and reusable memory — jeva-fresh-decisions"
         - "Replay QA: { fully managed } · End-to-end testing that explores, runs and records on its own — replay-qa-promo"
         - "Speaking in Coordinates · How GroundingPI turns images and phrases into structured visual primitives — groundingpi-speaking-in-coordinates"

apps/bookshelf/src/viz/books/handwired/chapter-1.stories.tsx

@@ -0,0 +1,28 @@
+// Handwired — chapter 1 story. Scene authored by Claude Opus 5.5 (claude-opus-5-5).
+import type { Meta, StoryObj } from '@storybook/react-vite';
+import { Player } from '../../core';
+import { Render, vizScene } from './chapter-1';
+
+/**
+ * Both Branches Run — the README's if-else taken apart on a number line: two relu ramps subtract
+ * into a step, the step's bit picks ten or twelve while both are computed, then builder code, the
+ * four operations and a stack of layers that cannot loop.
+ */
+function Chapter1() {
+  const scene = vizScene();
+  return (
+    <div style={{ padding: '4vh 4vw' }}>
+      <Player timeline={scene.tl} loop>
+        {(s) => <Render s={s} />}
+      </Player>
+    </div>
+  );
+}
+
+const meta: Meta<typeof Chapter1> = {
+  title: 'Books/Handwired/Chapter 1',
+  component: Chapter1,
+};
+export default meta;
+
+export const Scene: StoryObj<typeof Chapter1> = {};

apps/bookshelf/src/viz/books/handwired/chapter-2.stories.tsx

@@ -0,0 +1,27 @@
+// Handwired — chapter 2 story. Scene authored by Claude Opus 5.5 (claude-opus-5-5).
+import type { Meta, StoryObj } from '@storybook/react-vite';
+import { Player } from '../../core';
+import { Render, vizScene } from './chapter-2';
+
+/**
+ * A Switch of Arithmetic — the toggle's 20-cell table as a wire tape: four comparisons, an and
+ * as relu, two selects, and the spring as a matrix power the host writes into four cells.
+ */
+function Chapter2() {
+  const scene = vizScene();
+  return (
+    <div style={{ padding: '4vh 4vw' }}>
+      <Player timeline={scene.tl} loop>
+        {(s) => <Render s={s} />}
+      </Player>
+    </div>
+  );
+}
+
+const meta: Meta<typeof Chapter2> = {
+  title: 'Books/Handwired/Chapter 2',
+  component: Chapter2,
+};
+export default meta;
+
+export const Scene: StoryObj<typeof Chapter2> = {};