Skip to content
← Public packages

@kentcdodds/invisible-software-talk

Invisible Software: Kent C. Dodds's AI Coding Summit NYC 2026 talk deck. Agents become software's next billion users.

FollowForkOpen app

Files

AGENTS.md

47 lines · 3.8 KB · Markdown

Agent guide: invisible-software-talk

A Kody package app that serves one self-contained slide deck ("Invisible Software", AI Coding Summit NYC 2026). It makes no external requests: no CDNs, remote fonts, or analytics. It declares no credentials, secrets, jobs, or other capabilities; keep it that way so it can stay internet-visible.

  • app/router.ts: serves index.html for every path, the content-hashed assets under c/ (immutable cache headers), /favicon.ico, /health and the PWA files. Only index.html carries the x-invisible-software-deck header the service worker trusts.
  • app/assets.generated.ts and dist/index.html are generated by npm run build. Never edit them by hand; rebuild and commit both after any change under src/ or demo/.
  • scripts/build.mjs builds one page source two ways. dist/index.html inlines everything (Reveal, fonts, images, the phone demo as a srcdoc string) and opens from disk with zero network. The hosted index.html inlines only text (Reveal, CSS, JS, slides) and references fonts, images, icons and the phone demo document as content-hashed files (c/img/name.<hash>.webp, c/demo.<hash>.html with its own c/demo/... assets); the build fails if the hosted page inlines an image or font or references an unpublished file. It also rewrites each slide's @scope CSS into section#<id> selectors (keep @keyframes in a separate <style>) and fails on em/en dashes, curly quotes or missing notes.
  • src/sw.js: precaches the page, the PWA files and every hashed asset (list generated at build time); network-first for the page (deck-header check, so portals and error pages fall back to the cache), cache-first for hashed files (including the demo iframes' document), old caches deleted on activate. The page reports window.__pwa.state === 'ready' only once every precached file is in the cache.
  • The hosted page must live at a URL ending in / (its asset URLs are relative); a first inline script redirects /<mount> to /<mount>/.
  • demo/: Kent's invisible software phone demo, copied from @kentcdodds/invisible-software (only change: scene 6 clocks read 9:41 like the other phones) (do not edit that package from here). scripts/build-demo.mjs composes it into one document with every asset inlined; the deck embeds it as an iframe srcdoc and src/c/demo.js drives it from the deck's click steps (data-start, data-first, data-count on each .demo).
  • src/c/deck.js: Reveal config (1920x1080, linear navigation, fade transitions), the theme (follows the OS by default, ?theme=light|dark|system, T key), and the click-step engine (data-steps, data-at, data-until).
  • src/c/scenes.js: canvas scenes (seeded, deterministic) that follow the step engine's stepchange.
  • scripts/verify.mjs: walks every slide and beat in both themes at 1280x720 and 1920x1080 with the network blocked; checks the dome-safe box, clipped and overlapping text, contrast, fonts, notes, T, the speaker view and reflow, then serves the hosted build and runs scripts/offline-audit.mjs: after one visit, with the network cut, every precached file, image, font, demo phone and the speaker view must load from the cache. node scripts/check-live.mjs <url> runs the same audit on the live host.

Content rules

  • Big type for a dome: audience text is 40px or more on the 1920x1080 canvas.
  • Keep everything inside the safe box; nothing important in corners.
  • Elements fade in from fully transparent; no half-opaque resting states.
  • Motion is transforms and opacity only; nothing may reflow while a beat plays.
  • No em or en dashes anywhere, ASCII quotes only.
  • Kody appears in one line of narration (walled gardens); the demo scenes keep their Kody branding.
  • No tokens, private URLs, emails, or personal details. The package is public.