Files
documentation/presentations/less-prompting-more-shipping

Less Prompting, More Shipping — v1.0.0

An explanation for the CTO and engineering leads: decide how a solo AI Architect should invest the first six months. The original AI_Architect_Test_Task.pdf governs the content. Read together with the reviewed Strategy at revision fcaa84f3bf9058f4ede0a097d16d0e3571590a6b; it is not a second Strategy landing page.

Source and build

  • slides.mjs: 17 talk slides (35 minutes), one 15-minute discussion slide, one zero-minute reference appendix. Every slide has narration, timing and source references. EXP-01 remains fictional throughout.
  • theme.css: Lato, gold #ffc950, charcoal #14131a/#1f1f29 and light surfaces, derived from src/css/custom.css. Separate standalone document prevents Reveal/global CSS leaking into the portal. Portrait re-composes the same content, landscape retains the room presentation.
  • runtime.js: Reveal initialization, reduced motion, portrait/orientation adaptation and accessible toolbar.
  • scripts/build-presentations.mjs: generates static/presentations/less-prompting-more-shipping/, including source-map.json and locally copied, exact-pinned Reveal.js 5.2.1 + notes plugin, Lato fonts and licenses. Generated output is ignored, rebuilt before both start and production build. No production CDN. The existing pipeline runs content tests and verifies the generated route and homepage entry.

From repository root: pnpm install --frozen-lockfile, pnpm build, pnpm verify:build. Serve build/ under /eldorado-v1/documentation/ with a static server. The dedicated route is /eldorado-v1/documentation/presentations/less-prompting-more-shipping/. Relative links/assets also work if the site base path changes. Homepage entry uses a normal document navigation, not a React-router handoff.

Present

Use arrows or touch swipes. Esc/Overview shows the slide grid. F/Fullscreen enters fullscreen. S/Notes opens Reveal's speaker window (allow popups); notes require HTTP(S), not file://. Notes are not confidential: they ship in HTML. Named deep links, e.g. #/qualification, survive refresh. Autoplay is off. Reduced-motion preference disables transitions.

Print opens ?print-pdf: use Chromium, landscape, no margins and background graphics. The default export has 19 slides without speaker notes. No PDF/PPTX/ZIP is added to the public site. Printing is secondary to the interactive presentation.

Verify

pnpm test:presentation -- http://127.0.0.1:4180 against a prefix-correct static server runs 19 slides at desktop, portrait and landscape, checks bounds/errors/local links, refresh/hash, keyboard, touch, overview, notes popup, fullscreen, homepage integration and 19-page print layout. It writes ordered, individual PNGs plus JSON and a print diagnostic to .cache/presentation/. Set PLAYWRIGHT_CHROMIUM_EXECUTABLE if using an installed Chromium rather than Playwright's default binary. Inspect every slide individually after the final build. Local Docusaurus serve on Node26 incorrectly redirects WOFF2 paths with a trailing slash in this environment; use a regular static server for production-equivalent font verification, not missing-font screenshots.

Official implementation references: https://revealjs.com/installation/, https://revealjs.com/speaker-view/, https://revealjs.com/pdf-export/. The pinned 5.2.1 package is intentional; consult its runtime for API compatibility rather than assuming the current documentation's latest-version distribution paths. License is MIT; notes is bundled from plugin/notes/notes.js.

Content traceability

PDF Q1 → slides 2–8 (context, influence, months and capacity). PDF Q2 → slides 9–14 (balanced measures, misleading signals, one example and two decision states). PDF Q3 → slide 15 (realistic observable change and evidence). PDF Q4 → slide 16 (conditional choices beyond six months). Opening/alignment → slides 1 and 17; discussion → 18; references → 19. The generated source-map.json gives each slide's exact Strategy page and PDF section. Slides 5–7 simplify the six-month/roadmap diagrams; slides 3, 11–14 simplify Stage01 handoff/qualification/feedback without changing human approval or recovery semantics. No screenshots of documentation diagrams are used.

Boundaries

No company gains, approved thresholds, staffing commitments, tool inventory or deployed autonomy are claimed. The numerical example reproduces EXP-01 rather than inventing a second example. The title is mild self-aware humor, not a claim that fewer prompts intrinsically improve output.

Initial production audit after adding Reveal: 2 critical, 2 high, 2 moderate (uuid, http-cache-semantics, braces, postcss-selector-parser, tinypool). Same inherited counts as the parent; Reveal itself has no runtime dependencies. This is not risk acceptance or a clean security audit. This branch is a review candidate, not a publication. The dependent reviewer owns merge, exact-main CI and deployed verification.