Organize project instructions with grouping headers for readability - PR_26126_061-project-instructions-organization

Author: DavidQ

docs/dev/PROJECT_INSTRUCTIONS.md

@@ -5,6 +5,8 @@ You are working in a docs-first repo workflow.
 Workflow:
 PLAN_PR → BUILD_PR → APPLY_PR
 
+# WORKFLOW & EXECUTION
+
 ## PR NAMING STANDARD
 
 PR names MUST follow:
@@ -104,6 +106,8 @@ Example:
 
 `Normalize palette contract to manifest SSoT and remove tool-level schema drift - PR_26124_001-palette-baseline`
 
+# TESTING & VALIDATION
+
 ## PLAYWRIGHT VALIDATION REQUIREMENT
 
 Every PR must include a clear Playwright section.
@@ -305,6 +309,8 @@ Every PR must document:
 - whether full samples test was skipped or run
 - reason for decision
 
+# RUNTIME & BEHAVIOR CONTRACTS
+
 ## WORKSPACE V2 CURRENT CONTRACT
 
 Workspace manifest is the runtime contract.
@@ -362,6 +368,8 @@ Rules:
 - Do not claim sample launch works until sample JSON has been updated to schema.
 - Sample validation will happen after tool completion.
 
+# TOOL & ARCHITECTURE RULES
+
 ## TOOL COMPLETION RULES
 
 During tool completion:

docs/dev/reports/project_instructions_organization.txt

@@ -0,0 +1,23 @@
+PR_26126_061-project-instructions-organization
+
+Purpose:
+Improve PROJECT_INSTRUCTIONS.md readability by inserting grouping headers only.
+
+Grouping headers added:
+- WORKFLOW & EXECUTION
+- TESTING & VALIDATION
+- RUNTIME & BEHAVIOR CONTRACTS
+- TOOL & ARCHITECTURE RULES
+
+Validation notes:
+- docs/dev/PROJECT_INSTRUCTIONS.md was the only target document edited.
+- Existing rule text was not modified, reordered, or deleted.
+- Diff is insertion-only: 8 inserted lines, 0 deleted lines.
+- No roadmap, code, samples, schema, package, test, or start_of_day files were modified.
+- Playwright impacted: No.
+- No Playwright impact. This PR is docs/workflow only.
+
+Manual test notes:
+- Open docs/dev/PROJECT_INSTRUCTIONS.md.
+- Confirm the four grouping headers improve readability.
+- Confirm all pre-existing rule sections remain in the same order.