docs + enforcement added/updated

DavidQ · DavidQ · commit 0d6eb4dc1549 · 2026-04-13T17:42:25.000-04:00
diff --git a/docs/dev.zip b/docs/dev.zip
diff --git a/docs/dev/CODEX_COMMANDS.md b/docs/dev/CODEX_COMMANDS.md
@@ -1,20 +1,6 @@
-MODEL: GPT-5.4
-REASONING: low
+PR Naming Rule:
+ALL PRs MUST follow:
+PR_<SECTION>_<STEP>_<SHORT_NAME>
 
-COMMAND:
-Implement BUILD_PR_LEVEL_6_5_SAMPLE_INDEX_NORMALIZATION.
+Reject any PR name that does not follow this format.
 
-Scope:
-- samples/index.html only
-
-Steps:
-1. Update paths to phase-XX structure.
-2. Sort entries by phase then id.
-3. Remove invalid/broken links.
-
-Validation:
-- links resolve
-- ordering correct
-
-Return ZIP:
-<project folder>/tmp/BUILD_PR_LEVEL_6_5_SAMPLE_INDEX_NORMALIZATION.zip
diff --git a/docs/dev/pr_naming_convention.md b/docs/dev/pr_naming_convention.md
@@ -0,0 +1,16 @@
+# PR Naming Convention
+
+Format:
+PR_<SECTION>_<STEP>_<SHORT_NAME>
+
+Rules:
+- SECTION = roadmap section (01–16)
+- STEP = incremental per section (01+)
+- SHORT_NAME = ALL_CAPS, concise, action-oriented
+
+Examples:
+PR_01_01_REPO_STRUCTURE_MOVE_MAP
+PR_01_02_REPO_STRUCTURE_APPLY
+PR_03_01_SHARED_NUMBERS_NORMALIZATION
+PR_06_07_SAMPLES_DEPENDENCY_CLEANUP
+PR_07_01_NETWORK_SERVER_DASHBOARD
diff --git a/docs/dev/pr_naming_convention.md.md b/docs/dev/pr_naming_convention.md.md
@@ -0,0 +1,14 @@
+# PR Naming Convention
+
+Format:
+PR_<SECTION>_<STEP>_<SHORT_NAME>
+
+Rules:
+- SECTION = roadmap section (01–16)
+- STEP = incremental per section (01+)
+- SHORT_NAME = ALL_CAPS, concise
+
+Examples:
+PR_01_01_REPO_STRUCTURE_MOVE_MAP
+PR_03_02_SHARED_STRINGS_EXTRACTION
+PR_06_07_SAMPLES_DEPENDENCY_CLEANUP
diff --git a/docs/pr/_template.md b/docs/pr/_template.md
@@ -0,0 +1,4 @@
+# PR Template
+
+PR Name must follow:
+PR_<SECTION>_<STEP>_<SHORT_NAME>
