PLAN_PR: enhance sample detail pages with metadata-driven UI

DavidQ · DavidQ · commit b558f3aac72e · 2026-04-10T16:20:45.000-04:00
diff --git a/docs/dev/CODEX_COMMANDS.md b/docs/dev/CODEX_COMMANDS.md
@@ -2,23 +2,13 @@ MODEL: GPT-5.4-codex
 REASONING: high
 
 COMMAND:
-Execute BUILD_PR_SAMPLES_FILTER_AND_SEARCH
-
-ENVIRONMENT:
-- Windows
-- Use Node.js or vanilla JS only
-- No npm install
-- No node_modules
+Create PLAN_PR_SAMPLES_DETAIL_PAGE_ENHANCEMENT
 
 RULES:
-- Do not change canonical paths
-- Do not modify gameplay
-- Keep changes minimal
-
-VALIDATION:
-- filters work
-- search works
-- 1316–1318 load correctly
+- Docs only
+- No implementation code
+- No gameplay changes
+- No engine changes
 
 ZIP:
-<project folder>/tmp/BUILD_PR_SAMPLES_FILTER_AND_SEARCH.zip
+<project folder>/tmp/PLAN_PR_SAMPLES_DETAIL_PAGE_ENHANCEMENT.zip
diff --git a/docs/dev/COMMIT_COMMENT.txt b/docs/dev/COMMIT_COMMENT.txt
@@ -1 +1 @@
-BUILD_PR: add filtering and search to samples index
+PLAN_PR: enhance sample detail pages with metadata-driven UI
diff --git a/docs/dev/reports/change_summary.txt b/docs/dev/reports/change_summary.txt
@@ -1 +1 @@
-Add phase filter, tag filter, and search to samples index
+Define improvements for sample pages including headers, previews, and navigation
diff --git a/docs/dev/reports/file_tree_delta.txt b/docs/dev/reports/file_tree_delta.txt
@@ -1,5 +1,2 @@
-MODIFIED:
-- samples/index.html
-
 ADDED:
-- minimal filter/search JS
+- docs/pr/PLAN_PR_SAMPLES_DETAIL_PAGE_ENHANCEMENT.md
diff --git a/docs/dev/reports/validation_checklist.txt b/docs/dev/reports/validation_checklist.txt
@@ -1,7 +1,6 @@
-[ ] phase filter works
-[ ] tag filter works
-[ ] search works
-[ ] combined filtering works
-[ ] links resolve (1316–1318)
-[ ] no console errors
+[ ] header enhancement defined
+[ ] preview support defined
+[ ] related samples defined
+[ ] navigation defined
+[ ] no path changes
 [ ] zip exists
diff --git a/docs/pr/PLAN_PR_SAMPLES_DETAIL_PAGE_ENHANCEMENT.md b/docs/pr/PLAN_PR_SAMPLES_DETAIL_PAGE_ENHANCEMENT.md
@@ -0,0 +1,20 @@
+# PLAN_PR_SAMPLES_DETAIL_PAGE_ENHANCEMENT
+
+## Objective
+Define enhancements for individual sample pages to improve usability, clarity, and navigation.
+
+## Scope
+- Add sample header enhancements (title, description)
+- Add optional preview/screenshot support
+- Add "related samples" links based on metadata
+- Add navigation (next/previous sample)
+
+## Out of Scope
+- gameplay changes
+- engine changes
+- directory structure changes
+
+## Acceptance
+- sample pages remain functional
+- enhancements are metadata-driven
+- navigation links resolve correctly

Original file line number	Diff line number	Diff line change
`@@ -1 +1 @@`
`1`		`-BUILD_PR: add filtering and search to samples index`
	`1`	`+PLAN_PR: enhance sample detail pages with metadata-driven UI`
Original file line number	Diff line number	Diff line change
`@@ -1 +1 @@`
`1`		`-Add phase filter, tag filter, and search to samples index`
	`1`	`+Define improvements for sample pages including headers, previews, and navigation`