Promote workflow ordering to platform governance and refine Create workflow sequence - PR_26170_008-workflow-order-governance

Author: ToolboxAid

docs_build/dev/PROJECT_INSTRUCTIONS.md

@@ -231,12 +231,13 @@ Allowed intentional-order exceptions:
 
 Every intentional-order exception must be documented in the PR report that introduces or preserves it.
 
-### Toolbox Workflow Ordering Governance
+### Workflow Ordering Governance
 
-Toolbox groups are intentional workflow-order exceptions when the surface is guiding creators through a natural making sequence.
+When a surface represents a creator workflow, items are ordered by the likely next action, not alphabetically.
+Workflow ordering is an approved exception to alphabetical ordering.
+This applies to Toolbox, Project Workspace, Create, Publish, Progress, and future guided workflows.
 
 Rules:
-- Toolbox group and tile order is by creator progression, not alphabetically.
 - Order follows how users naturally work:
   - Select -> Create -> Review
   - Left -> Right
@@ -246,8 +247,8 @@ Rules:
 
 Create group order:
 1. Game Workspace
-2. Game Configuration
-3. Project Team
+2. Project Team
+3. Game Configuration
 4. Tags
 
 Team planning distinction:

docs_build/dev/admin-notes/tools/index.txt

@@ -1,8 +1,8 @@
 Order,Tool,Group,Status,Complete
 1,AI Assistant,AI,Wireframe,No
 2,Game Workspace,Create,Ready,Yes
-3,Game Configuration,Create,Ready,Yes
-4,Project Team,Create,Planned,No
+3,Project Team,Create,Planned,No
+4,Game Configuration,Create,Ready,Yes
 5,Tags,Create,Ready,Yes
 6,Game Design,Design,Ready,Yes
 7,Assets,Design,Ready,Yes
@@ -42,17 +42,18 @@ Order,Tool,Group,Status,Complete
 41,Game Migration,Platform,Planned,No
 42,Platform Settings,Platform,Planned,No
 
-Toolbox Workflow Ordering Governance
-- Toolbox groups are intentional workflow-order exceptions.
-- Tiles are ordered by creator progression, not alphabetically.
+Workflow Ordering Governance
+- When a surface represents a creator workflow, items are ordered by likely next action, not alphabetically.
+- Workflow ordering is an approved exception to alphabetical ordering.
+- Applies to Toolbox, Project Workspace, Create, Publish, Progress, and future guided workflows.
 - Order follows how users naturally work: Select -> Create -> Review, Left -> Right, Top -> Bottom.
 - The next tile should represent the most likely next creator action.
 - Tile ordering should minimize navigation decisions.
 
 Create group order
 1. Game Workspace
-2. Game Configuration
-3. Project Team
+2. Project Team
+3. Game Configuration
 4. Tags
 
 Team distinction

docs_build/dev/reports/PR_26170_006-toolbox-workflow-order-and-project-team.md

@@ -6,13 +6,13 @@
 ## Requirement Checklist
 - PASS: Built `PR_26170_006-toolbox-workflow-order-and-project-team`.
 - PASS: Added BUILD doc at `docs_build/pr/BUILD_PR_26170_006-toolbox-workflow-order-and-project-team.md`.
-- PASS: Added Toolbox Workflow Ordering Governance to `docs_build/dev/PROJECT_INSTRUCTIONS.md`.
-- PASS: Documented Toolbox groups as intentional workflow-order exceptions.
-- PASS: Documented tile ordering by creator progression rather than alphabetical sorting.
+- PASS: Added Workflow Ordering Governance to `docs_build/dev/PROJECT_INSTRUCTIONS.md`.
+- PASS: Documented workflow surfaces as intentional workflow-order exceptions.
+- PASS: Documented item ordering by likely next creator action rather than alphabetical sorting.
 - PASS: Documented natural ordering rules: `Select -> Create -> Review`, `Left -> Right`, and `Top -> Bottom`.
 - PASS: Documented that the next tile should represent the most likely next creator action.
 - PASS: Documented that tile ordering should minimize navigation decisions.
-- PASS: Updated Create group references to this order: Game Workspace, Game Configuration, Project Team, Tags.
+- PASS: Updated Create group references to this order: Game Workspace, Project Team, Game Configuration, Tags.
 - PASS: Moved project-specific Users planning into Create/Project Team documentation.
 - PASS: Documented the distinction between Studio Team as account-level roster and Project Team as project-level assignment.
 - PASS: Updated Owner Notes source content in `docs_build/dev/admin-notes/tools/index.txt`.
@@ -48,7 +48,7 @@
 - Full samples smoke: skipped per request and because documentation changes do not affect sample runtime behavior.
 
 ## Manual Test Notes
-- Open `owner/grouping-colors.html` and confirm Create lists Game Workspace, Game Configuration, Project Team, and Tags.
+- Open `owner/grouping-colors.html` and confirm Create lists Game Workspace, Project Team, Game Configuration, and Tags.
 - Open Owner Notes for `docs_build/dev/admin-notes/tools/index.txt` and confirm the Create group order and Studio Team / Project Team distinction are visible.
 - Confirm no Toolbox page ordering or runtime behavior changed in this PR.
 

docs_build/dev/reports/PR_26170_007-toolbox-workflow-render-order-project-team.md

@@ -8,7 +8,7 @@ PASS - Current branch verified as `main`.
 
 - PASS - Toolbox grouped rendering no longer alphabetizes cards inside groups. `toolbox/tools-page-accordions.js` uses `compareByWorkflowOrder` for grouped card ordering.
 - PASS - Toolbox groups render by declared Game Journey order from source order. The targeted Playwright grouped-view check asserted `GAME_JOURNEY_GROUP_ORDER`.
-- PASS - Create group renders in required workflow order: `Game Workspace`, `Game Configuration`, `Project Team`, `Tags`. Covered by source validation and Playwright.
+- PASS - Create group renders in required workflow order: `Game Workspace`, `Project Team`, `Game Configuration`, `Tags`. Covered by source validation and Playwright.
 - PASS - Existing `users` tool was moved into Create as `Project Team` without changing its route (`toolbox/users/index.html`) or planned status.
 - PASS - `Users` is no longer exposed as a Toolbox tile under Share, Account, Platform, or any non-Create group. API snapshot validation confirms `id: users` displays as `Project Team` with `group/category/toolboxGroup: Create`.
 - PASS - User-facing Toolbox copy uses `Project Team` for project-specific team assignment. `Studio Team` remains documented as the account-level roster distinction.
@@ -48,6 +48,6 @@ PASS - Current branch verified as `main`.
 ## Manual Validation Notes
 
 - Confirmed `/toolbox/index.html?view=group` renders all Game Journey groups in declared order.
-- Confirmed Create group tile order is `Game Workspace`, `Game Configuration`, `Project Team`, `Tags`.
+- Confirmed Create group tile order is `Game Workspace`, `Project Team`, `Game Configuration`, `Tags`.
 - Confirmed `Project Team` uses the existing `toolbox/users/index.html` route and remains planned.
 - Confirmed `Users` does not remain as a visible Toolbox tile label in the API-backed active registry.

docs_build/dev/reports/PR_26170_008-workflow-order-governance.md

@@ -0,0 +1,52 @@
+# PR_26170_008-workflow-order-governance
+
+## Branch Validation
+
+PASS - Current branch verified as `main`.
+
+## Requirement Checklist
+
+- PASS - Renamed the previous Toolbox-specific governance title to `Workflow Ordering Governance` in current governance and owner notes.
+- PASS - Updated governance language so creator workflow surfaces order by likely next action, not alphabetically.
+- PASS - Documented workflow ordering as an approved exception to alphabetical ordering.
+- PASS - Documented applicability to Toolbox, Project Workspace, Create, Publish, Progress, and future guided workflows.
+- PASS - Updated Create group order to `Game Workspace`, `Project Team`, `Game Configuration`, `Tags`.
+- PASS - Updated Owner grouping notes and Owner Notes source content to the new governance name and Create order.
+- PASS - Updated related historical PR documentation references so the old governance name/order does not remain as an active doc reference.
+- PASS - Did not move Game Journey. Toolbox mapping still keeps `game-journey` in `Progression`.
+- PASS - Did not modify unrelated groups.
+
+## Validation
+
+- PASS - `git branch --show-current` returned `main`.
+- PASS - `node --check toolbox/tools-page-accordions.js`
+- PASS - `node --check tests/playwright/tools/ToolboxRoutePages.spec.mjs`
+- PASS - `git diff --check` completed with no whitespace errors; only Windows line-ending warnings were reported.
+- PASS - Targeted Node documentation/static validation confirmed:
+  - `PROJECT_INSTRUCTIONS.md` uses `Workflow Ordering Governance`.
+  - likely-next-action and alphabetical-exception rules are present.
+  - applicability to Toolbox, Project Workspace, Create, Publish, Progress, and future guided workflows is present.
+  - `PROJECT_INSTRUCTIONS.md`, Owner Notes, Owner grouping notes, Toolbox renderer, and Playwright expectation all use `Game Workspace`, `Project Team`, `Game Configuration`, `Tags`.
+  - old governance title and old Create order do not remain in searched docs/source targets.
+- PASS - Targeted Toolbox Playwright validation:
+  - `npx playwright test tests/playwright/tools/ToolboxRoutePages.spec.mjs --project=playwright --grep "toolbox grouped view renders Game Journey order" --workers=1 --reporter=list`
+  - Result: 1 passed.
+
+## Playwright Coverage Note
+
+- Targeted Playwright refreshed advisory V8 coverage reports:
+  - `docs_build/dev/reports/playwright_v8_coverage_report.txt`
+  - `docs_build/dev/reports/coverage_changed_js_guardrail.txt`
+- The browser run exercised `toolbox/tools-page-accordions.js`.
+
+## Skipped Lanes
+
+- SKIP - Full samples validation was skipped per request.
+- SKIP - Broad workspace/runtime suites were skipped because this PR changes governance docs and a targeted Toolbox Create-order renderer mapping only.
+- SKIP - Database, persistence, auth, engine, and unrelated tool lanes were skipped because no behavior in those areas changed.
+
+## Manual Notes
+
+- Owner grouping colors now lists Create as `Game Workspace`, `Project Team`, `Game Configuration`, `Tags`.
+- Owner Notes source now lists Project Team before Game Configuration in Create.
+- Toolbox grouped view keeps Game Journey in `Progression`; only Create tile order changed.

docs_build/dev/reports/codex_changed_files.txt

@@ -1,20 +1,36 @@
-# PR_26170_007 changed files
+# git status --short
+M docs_build/dev/PROJECT_INSTRUCTIONS.md
+ M docs_build/dev/admin-notes/tools/index.txt
+ M docs_build/dev/reports/PR_26170_006-toolbox-workflow-order-and-project-team.md
+ M docs_build/dev/reports/PR_26170_007-toolbox-workflow-render-order-project-team.md
+ M docs_build/dev/reports/codex_changed_files.txt
+ M docs_build/dev/reports/codex_review.diff
+ M docs_build/dev/reports/coverage_changed_js_guardrail.txt
+ M docs_build/dev/reports/playwright_v8_coverage_report.txt
+ M docs_build/pr/BUILD_PR_26170_006-toolbox-workflow-order-and-project-team.md
+ M docs_build/pr/BUILD_PR_26170_007-toolbox-workflow-render-order-project-team.md
+ M owner/grouping-colors.html
+ M tests/playwright/tools/ToolboxRoutePages.spec.mjs
+ M toolbox/tools-page-accordions.js
+?? docs_build/dev/reports/PR_26170_008-workflow-order-governance.md
+?? docs_build/pr/BUILD_PR_26170_008-workflow-order-governance.md
 
-docs_build/dev/reports/PR_26170_007-toolbox-workflow-render-order-project-team.md
-docs_build/dev/reports/codex_changed_files.txt
-docs_build/dev/reports/codex_review.diff
-docs_build/dev/reports/coverage_changed_js_guardrail.txt
-docs_build/dev/reports/playwright_v8_coverage_report.txt
-docs_build/pr/BUILD_PR_26170_007-toolbox-workflow-render-order-project-team.md
-src/dev-runtime/server/local-api-router.mjs
-src/shared/toolbox/tool-metadata-inventory.js
-tests/playwright/tools/RootToolsFutureState.spec.mjs
-tests/playwright/tools/ToolboxAdminMetadataSsot.spec.mjs
-tests/playwright/tools/ToolboxRoutePages.spec.mjs
-toolbox/tools-page-accordions.js
-toolbox/users/index.html
+# git ls-files --others --exclude-standard
+docs_build/dev/reports/PR_26170_008-workflow-order-governance.md
+docs_build/pr/BUILD_PR_26170_008-workflow-order-governance.md
 
-# Unrelated untracked files intentionally excluded from this PR artifact
-
-docs_build/dev/admin-notes/GFS-Connected-Play-Second-Screen-Turn-Based-Design-26170-001.pdf
-docs_build/dev/admin-notes/GFS_Game_Identity_Strategy.pdf.pdf
+# git diff --stat
+docs_build/dev/PROJECT_INSTRUCTIONS.md             |   11 +-
+ docs_build/dev/admin-notes/tools/index.txt         |   15 +-
+ ..._006-toolbox-workflow-order-and-project-team.md |   10 +-
+ ...7-toolbox-workflow-render-order-project-team.md |    4 +-
+ docs_build/dev/reports/codex_changed_files.txt     |   48 +-
+ docs_build/dev/reports/codex_review.diff           | 3572 ++------------------
+ .../dev/reports/coverage_changed_js_guardrail.txt  |    2 +-
+ .../dev/reports/playwright_v8_coverage_report.txt  |   10 +-
+ ..._006-toolbox-workflow-order-and-project-team.md |   12 +-
+ ...7-toolbox-workflow-render-order-project-team.md |    4 +-
+ owner/grouping-colors.html                         |    8 +-
+ tests/playwright/tools/ToolboxRoutePages.spec.mjs  |    2 +-
+ toolbox/tools-page-accordions.js                   |    4 +-
+ 13 files changed, 382 insertions(+), 3320 deletions(-)