Samples: curriculum validation

Author: DavidQ

docs/dev/CODEX_COMMANDS.md

@@ -2,37 +2,21 @@ MODEL: GPT-5.4
 REASONING: high
 
 COMMAND:
-Implement BUILD_PR_LEVEL_6_1_SAMPLES_PHASE_ALIGNMENT.
+Implement BUILD_PR_LEVEL_6_2_SAMPLE_CURRICULUM_VALIDATION.
 
-Goal:
-Normalize the samples area into canonical phase-based locations and update only the references required to keep sample navigation working.
+Scope:
+- samples/ and samples/index.html only
 
-Use this captured plan exactly:
-1. Map every sample to a canonical `phaseXX/####` location.
-2. Identify outliers/misnumbered entries and define move/rename rules.
-3. Validate links/index metadata against the new phase structure.
-4. Apply in one surgical delta (structure + references + verification).
-
-Scope limits:
-- samples/ only
-- `samples/index.html`
-- direct sample metadata or link surfaces used by `samples/index.html`
-- no engine/game/tool changes
-- no sample logic rewrites unless path references require them
-
-Required steps:
-1. Build an exact move-map for current sample locations to canonical `samples/phase-XX/####-*` targets.
-2. Identify and resolve misnumbered/misplaced entries with exact rename targets.
-3. Apply moves/renames in one pass.
-4. Update `samples/index.html` and only the direct references required for navigation correctness.
-5. Verify there are no broken sample-navigation references after the move.
+Steps:
+1. Analyze sample ordering by phase/number.
+2. Ensure each sample has one clear primary concept.
+3. Identify overlaps and resolve by reordering or flagging (no deletes unless exact duplicates).
+4. Update samples/index.html if ordering changes.
 
 Validation:
-- every sample in scope has one canonical final location
-- no duplicate/ambiguous final placements
-- `samples/index.html` resolves correctly
-- smoke validation for sample navigation passes
+- clean progression
+- no overlapping adjacent concepts
+- navigation intact
 
-Return:
-- COMPLETE repo-structured ZIP only
-- path: <project folder>/tmp/BUILD_PR_LEVEL_6_1_SAMPLES_PHASE_ALIGNMENT.zip
+Output:
+<project folder>/tmp/BUILD_PR_LEVEL_6_2_SAMPLE_CURRICULUM_VALIDATION.zip

docs/dev/COMMIT_COMMENT.txt

@@ -1 +1 @@
-Plan: Sample curriculum validation
+Samples: curriculum validation

docs/dev/reports/change_summary.txt

@@ -1 +1 @@
-Plan for validating sample curriculum progression.
+Validated and normalized sample curriculum progression.

docs/dev/reports/validation_checklist.txt

@@ -1,2 +1,3 @@
-[ ] plan only
-[ ] progression defined
+[ ] progression valid
+[ ] no overlap
+[ ] index valid

docs/pr/BUILD_PR_LEVEL_6_2_SAMPLE_CURRICULUM_VALIDATION.md

@@ -0,0 +1,22 @@
+# BUILD PR — Level 6.2 Sample Curriculum Validation
+
+## Purpose
+Validate that samples follow a clean, progressive, one-concept learning path.
+
+## Scope
+- samples/ structure + metadata only
+- no engine/game/tool changes
+
+## Changes
+- verify progression order
+- ensure one primary concept per sample
+- flag/remove overlapping or redundant samples (no deletes without exact duplicates)
+- update samples/index references if ordering changes
+
+## Validation
+- progression is strictly increasing in complexity
+- no duplicate concepts across adjacent samples
+- samples remain standalone understandable units
+
+## Output
+<project folder>/tmp/BUILD_PR_LEVEL_6_2_SAMPLE_CURRICULUM_VALIDATION.zip