Files
documentation/presentations/less-prompting-more-shipping/README.md
T
jarvis-at-skic f23bf1c5f4
Build and publish Eldorado documentation / build (pull_request) Successful in 48s
docs: align published presentation and verify horizon source traceability
2026-10-08 18:14:45 +00:00

40 lines
5.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Less Prompting, More Shipping — v1.0.1
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 assignment content. Read with the same-build Strategy: **Target → Roadmap → 6 Months Target → 6 Months Roadmap → Beyond 6 Months**. The six-month contribution does not replace the long-term human-controlled autonomous SDLC destination or authorize its execution. The source map records exact source-document hashes, the historical long-term/assignment origins and correction authority; it does not mislabel a historical revision as current. This 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.