BUILD_PR_RULES_OF_ENGAGEMENT_STANDARDIZATION

DavidQ · DavidQ · commit 0a7267a41824 · 2026-04-05T18:03:57.000-04:00
- Standardized rules into single source of truth
- Removed duplicate rule files
diff --git a/docs/archive/dev-ops/RULES.txt b/docs/archive/dev-ops/RULES.txt
diff --git a/docs/archive/dev-ops/WORKFLOW.md b/docs/archive/dev-ops/WORKFLOW.md
diff --git a/docs/dev/CODEX_COMMANDS.md b/docs/dev/CODEX_COMMANDS.md
@@ -1,49 +1,10 @@
-Toolbox Aid
-David Quesenberry
-04/05/2026
-codex_commands.md
-
 MODEL: GPT-5.4-codex
 REASONING: high
 
 COMMAND:
-Create BUILD_PR_DOCS_CLEANUP_AND_STRUCTURE_REORG implementation.
-
-Requirements:
-- Clean only documentation and documentation-adjacent artifacts
-- Do not modify engine, tools, samples, games, tests, or runtime code
-- Keep `docs/pr/` intact as history
-- Make `docs/dev/` active-only:
-  - README.md
-  - WORKFLOW_RULES.md
-  - active CODEX_COMMANDS.md
-  - active COMMIT_COMMENT.txt
-  - active NEXT_COMMAND.txt
-  - only currently valuable reports
-- Move durable architecture material out of `docs/dev/ARCHITECTURE.txt` into:
-  `docs/architecture/repo-operating-model.md`
-- Consolidate duplicate workflow/rules/start-of-day notes
-- Move older or lower-value generated artifacts to:
-  - `docs/archive/dev-ops/`
-  - `docs/archive/generated-reports/`
-- Delete obvious no-value doc artifacts when safe
-- Update key docs:
-  - README.md
-  - docs/README.md
-  - docs/getting-started.md
-  - docs/architecture/README.md
-  - docs/architecture/engine-api-boundary.md
-  - docs/dev/README.md
-  - docs/repo-directory-structure.md if present
-  - docs/review-checklist.md if present
-- Do not introduce broken links
-- Keep `docs/dev/commit_comment.txt` header-free
-- Package implementation output to:
-  <project folder>/tmp/BUILD_PR_DOCS_CLEANUP_AND_STRUCTURE_REORG_delta.zip
+Create RULES_OF_ENGAGEMENT.md and remove duplicate rule files.
 
-Report back:
-- exact docs/files removed
-- exact docs/files moved
-- exact docs/files updated
-- final active docs/dev structure
-- final archive structure
+- Consolidate RULES.txt and WORKFLOW.md
+- Keep single source of truth
+- Do not touch runtime code
+- Package to <project folder>/tmp/BUILD_PR_RULES_OF_ENGAGEMENT_STANDARDIZATION_delta.zip
diff --git a/docs/dev/COMMIT_COMMENT.txt b/docs/dev/COMMIT_COMMENT.txt
@@ -1 +1,4 @@
-docs: cleanup docs structure, archive stale dev artifacts, and normalize active dev surface
+BUILD_PR_RULES_OF_ENGAGEMENT_STANDARDIZATION
+
+- Standardized rules into single source of truth
+- Removed duplicate rule files
diff --git a/docs/dev/NEXT_COMMAND.txt b/docs/dev/NEXT_COMMAND.txt
@@ -1 +1 @@
-APPLY_PR_DOCS_CLEANUP_AND_STRUCTURE_REORG
+APPLY_PR_RULES_OF_ENGAGEMENT_STANDARDIZATION
diff --git a/docs/dev/README.md b/docs/dev/README.md
@@ -9,7 +9,7 @@ README.md
 
 ## Active Files
 - `README.md`
-- `WORKFLOW_RULES.md`
+- `RULES_OF_ENGAGEMENT.md` (single source of truth)
 - `codex_commands.md` (must remain header-free)
 - `commit_comment.txt` (must remain header-free)
 - `next_command.txt`
diff --git a/docs/dev/RULES_OF_ENGAGEMENT.md b/docs/dev/RULES_OF_ENGAGEMENT.md
@@ -0,0 +1,36 @@
+Toolbox Aid
+David Quesenberry
+04/05/2026
+RULES_OF_ENGAGEMENT.md
+
+# Rules Of Engagement
+
+## Single Source Of Truth
+This file is the canonical workflow and rules document for active repo operations.
+
+## Required Workflow
+`PLAN_PR -> BUILD_PR -> APPLY_PR`
+
+## Core Rules
+- Docs-first before implementation.
+- One PR per purpose.
+- No skipped workflow steps.
+- Keep PR scope small and surgical.
+- Keep `docs/pr/` intact as history.
+- Do not modify runtime code unless explicitly in scope.
+
+## Responsibility Model
+- Planning/docs bundle defines scope and acceptance.
+- Implementation applies approved scope only.
+- Active execution control files are in `docs/dev/`.
+
+## Active Dev Controls
+- `docs/dev/codex_commands.md`
+- `docs/dev/commit_comment.txt` (header-free)
+- `docs/dev/next_command.txt`
+- `docs/dev/reports/change_summary.txt`
+- `docs/dev/reports/file_tree.txt`
+- `docs/dev/reports/validation_checklist.txt`
+
+## Packaging
+- Repo-structured delta ZIP outputs go to `<project folder>/tmp/`.
diff --git a/docs/dev/WORKFLOW_RULES.md b/docs/dev/WORKFLOW_RULES.md
diff --git a/docs/dev/reports/change_summary.txt b/docs/dev/reports/change_summary.txt
@@ -4,10 +4,7 @@ David Quesenberry
 change_summary.txt
 
 Summary
-- Reorganized documentation structure with docs-only scope.
-- Reduced `docs/dev/` to active workflow controls.
-- Retained only active reports in `docs/dev/reports/`.
-- Moved duplicate/stale operational notes to `docs/archive/dev-ops/`.
-- Moved legacy generated reports to `docs/archive/generated-reports/`.
-- Migrated durable operating model content into `docs/architecture/repo-operating-model.md`.
-- Updated root/docs architecture and review guide documents to match the new structure.
+- Added canonical `docs/dev/RULES_OF_ENGAGEMENT.md` as the single source of truth.
+- Consolidated rule/workflow guidance from legacy `RULES.txt` and `WORKFLOW.md`.
+- Removed duplicate rule files from active/archive locations.
+- Updated active docs references to point at `RULES_OF_ENGAGEMENT.md`.
diff --git a/docs/dev/reports/file_tree.txt b/docs/dev/reports/file_tree.txt
@@ -3,28 +3,13 @@ David Quesenberry
 04/05/2026
 file_tree.txt
 
-README.md
-docs/README.md
-docs/getting-started.md
-docs/repo-directory-structure.md
-docs/review-checklist.md
-docs/architecture/README.md
-docs/architecture/engine-api-boundary.md
-docs/architecture/repo-operating-model.md
+docs/dev/RULES_OF_ENGAGEMENT.md
 docs/dev/README.md
-docs/dev/WORKFLOW_RULES.md
-docs/dev/reports/README.md
+docs/getting-started.md
+docs/dev/WORKFLOW_RULES.md (removed)
+docs/archive/dev-ops/RULES.txt (removed)
+docs/archive/dev-ops/WORKFLOW.md (removed)
+docs/dev/start_of_day/RULES_OF_ENGAGEMENT.md (removed)
 docs/dev/reports/change_summary.txt
-docs/dev/reports/validation_checklist.txt
 docs/dev/reports/file_tree.txt
-docs/dev/commit_comment.txt
-docs/dev/next_command.txt
-docs/archive/dev-ops/ARCHITECTURE.txt
-docs/archive/dev-ops/DELETE_CANDIDATES.txt
-docs/archive/dev-ops/DOC_CLEANUP_AND_UPDATE_AUDIT.md
-docs/archive/dev-ops/QC_click_by_click_test_script.md
-docs/archive/dev-ops/RULES.txt
-docs/archive/dev-ops/UPDATE_REQUIRED.txt
-docs/archive/dev-ops/WORKFLOW.md
-docs/archive/generated-reports/QC - SPRITE_EDITOR_FINAL_QC.txt
-docs/archive/generated-reports/dev-reports/*.txt
+docs/dev/reports/validation_checklist.txt
diff --git a/docs/dev/reports/validation_checklist.txt b/docs/dev/reports/validation_checklist.txt
@@ -6,25 +6,14 @@ validation_checklist.txt
 VALIDATION CHECKLIST
 
 Workflow
-- BUILD_PR created for docs cleanup and structure reorg
-- One PR purpose maintained
-- docs-only implementation scope preserved
-
-Docs Surface
-- `docs/pr/` left intact
-- `docs/dev/` now active-only workflow controls
-- active reports consolidated under `docs/dev/reports/`
-- duplicate workflow/rules docs consolidated and archived
-
-Architecture
-- `docs/dev/ARCHITECTURE.txt` removed from active dev surface
-- durable operating model documented at `docs/architecture/repo-operating-model.md`
-
-Archive
-- `docs/archive/dev-ops/` contains superseded operational notes
-- `docs/archive/generated-reports/` contains legacy generated reports
+- Single rules source created at `docs/dev/RULES_OF_ENGAGEMENT.md`
+- Legacy `RULES.txt` and `WORKFLOW.md` consolidated
+- Duplicate rule docs removed
 
 Safety
-- no engine/tools/samples/games/tests/runtime files modified
-- updated docs reference valid existing paths
-- `docs/dev/commit_comment.txt` remains header-free
+- Docs-only changes
+- No runtime code changes
+- References updated from `WORKFLOW_RULES.md` to `RULES_OF_ENGAGEMENT.md`
+
+Packaging
+- Delta ZIP generated at `<project folder>/tmp/BUILD_PR_RULES_OF_ENGAGEMENT_STANDARDIZATION_delta.zip`
diff --git a/docs/dev/start_of_day/README.md b/docs/dev/start_of_day/README.md
@@ -0,0 +1,26 @@
+Toolbox Aid
+David Quesenberry
+04/05/2026
+README.md
+
+# Start Of Day Copy Map
+
+Use this folder as a quick copy/paste guide for session startup.
+
+## Copy To Tool (If Present In This Folder)
+- `CODEX_SESSION_PROMPT.md` -> paste into the Codex command/session prompt input
+- `SESSION_CONTEXT.md` -> paste into session context/background notes
+- `CURRENT_STATE.md` -> paste into "current status" or kickoff summary
+- `NEXT_STEPS.md` -> paste into planning/next-command drafting
+
+If one of these files is missing, skip it and use the active files in `docs/dev/` instead.
+
+## Active Dev Control Files
+- `../codex_commands.md` -> paste into the active "COMMAND" request
+- `../commit_comment.txt` -> paste as the commit comment/message text
+- `../next_command.txt` -> paste as the suggested next command
+
+## Reporting Files
+- `../reports/change_summary.txt` -> copy into change-summary output section
+- `../reports/validation_checklist.txt` -> copy into validation output section
+- `../reports/file_tree.txt` -> copy into file-tree output section
diff --git a/docs/dev/start_of_day/RULES_OF_ENGAGEMENT.md b/docs/dev/start_of_day/RULES_OF_ENGAGEMENT.md
diff --git a/docs/getting-started.md b/docs/getting-started.md
@@ -19,7 +19,7 @@ Run work in this sequence:
 ## 3) Use Active Dev Controls
 Active files are in `docs/dev/`:
 - `README.md`
-- `WORKFLOW_RULES.md`
+- `RULES_OF_ENGAGEMENT.md`
 - `codex_commands.md`
 - `commit_comment.txt`
 - `next_command.txt`
diff --git a/docs/pr/BUILD_PR_RULES_OF_ENGAGEMENT_STANDARDIZATION.md b/docs/pr/BUILD_PR_RULES_OF_ENGAGEMENT_STANDARDIZATION.md

Original file line number	Diff line number	Diff line change
`@@ -1 +1 @@`
`1`		`-APPLY_PR_DOCS_CLEANUP_AND_STRUCTURE_REORG`
	`1`	`+APPLY_PR_RULES_OF_ENGAGEMENT_STANDARDIZATION`