From 4139c8f732f3861be48469b6b0bfe700c44389be Mon Sep 17 00:00:00 2001 From: Sluijsens Date: Sat, 31 Oct 2026 22:43:40 +0100 Subject: [PATCH] Adds the second unit's code generation plan Co-Authored-By: Claude Opus 5.5 --- .../features/prerendering/aidlc-state.md | 2 +- aidlc-docs/features/prerendering/audit.md | 24 + .../display-fallbacks-code-generation-plan.md | 527 ++++++++++++++++++ 3 files changed, 552 insertions(+), 1 deletion(-) create mode 100644 aidlc-docs/features/prerendering/construction/plans/display-fallbacks-code-generation-plan.md diff --git a/aidlc-docs/features/prerendering/aidlc-state.md b/aidlc-docs/features/prerendering/aidlc-state.md index ba037aa..dca25fa 100644 --- a/aidlc-docs/features/prerendering/aidlc-state.md +++ b/aidlc-docs/features/prerendering/aidlc-state.md @@ -5,7 +5,7 @@ - **Feature Slug**: prerendering - **Project Type**: Brownfield - **Start Date**: 2026-10-31T14:15:01Z -- **Current Stage**: CONSTRUCTION - Code Generation planning (unit 2: display-fallbacks) +- **Current Stage**: CONSTRUCTION - Code Generation (unit 2: display-fallbacks): plan approved; batch B0 running - **Branch**: feature/prerendering (from master c4c2f83); commits and pushes allowed for this feature (owner, 2026-10-31) - **Worktree**: K:\Development\SlpSoftware\Projects\AndreaSlopFotografie-prerendering diff --git a/aidlc-docs/features/prerendering/audit.md b/aidlc-docs/features/prerendering/audit.md index 99d80cb..1499a66 100644 --- a/aidlc-docs/features/prerendering/audit.md +++ b/aidlc-docs/features/prerendering/audit.md @@ -299,3 +299,27 @@ **Context**: Functional Design unit 2 approved. --- + +## Code Generation - Unit 2 Plan Approval Prompt + +**Timestamp**: 2026-11-01T00:40:00Z + +**User Input**: "(none: plan written by a Sonnet sub-agent, reviewed by the main session)" + +**AI Response**: "Reviewed construction/plans/display-fallbacks-code-generation-plan.md: 29 steps in 9 batches. Asked for approval." + +**Context**: Code Generation Part 1, unit 2. Awaiting approval. + +--- + +## Code Generation - Unit 2 Plan Approval + +**Timestamp**: 2026-11-01T00:50:00Z + +**User Input**: "Approve plan" + +**AI Response**: "Plan approved. Started batch B0 with a Haiku sub-agent." + +**Context**: Code Generation Part 2, unit 2. + +--- diff --git a/aidlc-docs/features/prerendering/construction/plans/display-fallbacks-code-generation-plan.md b/aidlc-docs/features/prerendering/construction/plans/display-fallbacks-code-generation-plan.md new file mode 100644 index 0000000..42d0a89 --- /dev/null +++ b/aidlc-docs/features/prerendering/construction/plans/display-fallbacks-code-generation-plan.md @@ -0,0 +1,527 @@ +# Code Generation Plan - Unit 2: Display fallbacks + +Feature: prerendering. Unit: 2 "display-fallbacks" (fade-in, no JavaScript, first photo). This plan is the single source of truth for Code Generation (Part 2). Execute the steps in order, mark each checkbox `[x]` as soon as its "Done when" is met, and do not deviate from the plan. + +## 0. Context an executor needs + +### 0.1 What is built + +The site is React 19.3 + TanStack Start static prerendering + Chakra UI v3 in `web/`, hosted statically (nginx on test, IIS on production) with a strict CSP (`script-src 'self'` + Umami; `style-src 'self' 'unsafe-inline'`). Unit 1 is built: every page is a prerendered HTML file, inline scripts are moved to files by a build step that fails on violations, and the hydration rule holds: the first browser render equals the HTML; browser-only values apply afterwards (`useHydrated`, server-safe defaults). + +Unit 2 covers FR-PR-09 to 13, FR-PR-21 and the no-JavaScript side of FR-PR-22, plus NFR-PR-P-01 and P-03 (measurement), NFR-PR-Q-01 and Q-03 (tests), NFR-PR-SEC-01. It does five things: + +1. `Reveal` is visible in the HTML and in the first browser render; after hydration only an element wholly below the viewport is hidden (without transition) and fades in on scroll (BR-RVL). +2. `DeferredImage` gets a `