Skip to content

Commit b599edc

Browse files
ToolboxAidToolboxAid
committed
Add workflow-based toolbox ordering governance and move team management into Project Team planning - PR_26170_006-toolbox-workflow-order-and-project-team
1 parent a444667 commit b599edc

7 files changed

Lines changed: 469 additions & 1820 deletions

‎docs_build/dev/PROJECT_INSTRUCTIONS.md‎

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -221,6 +221,7 @@ Primary top-level header navigation is an explicit product IA exception and must
221221

222222
Allowed intentional-order exceptions:
223223
- primary top-level header navigation
224+
- Toolbox groups and tiles when they are presented as creator workflow surfaces
224225
- workflow paths
225226
- Build Path
226227
- dependency paths
@@ -230,6 +231,31 @@ Allowed intentional-order exceptions:
230231

231232
Every intentional-order exception must be documented in the PR report that introduces or preserves it.
232233

234+
### Toolbox Workflow Ordering Governance
235+
236+
Toolbox groups are intentional workflow-order exceptions when the surface is guiding creators through a natural making sequence.
237+
238+
Rules:
239+
- Toolbox group and tile order is by creator progression, not alphabetically.
240+
- Order follows how users naturally work:
241+
- Select -> Create -> Review
242+
- Left -> Right
243+
- Top -> Bottom
244+
- The next tile should represent the most likely next creator action.
245+
- Tile ordering should minimize navigation decisions.
246+
247+
Create group order:
248+
1. Game Workspace
249+
2. Game Configuration
250+
3. Project Team
251+
4. Tags
252+
253+
Team planning distinction:
254+
- Studio Team is the account-level roster.
255+
- Project Team is the project-level assignment surface.
256+
- Current Toolbox implementation focus is Project Team.
257+
- Users functionality that previously lived in Account/Team planning should be planned through Create/Project Team when it is project-specific.
258+
233259
Toolbox status values are:
234260
- Ready
235261
- Wireframe

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

Lines changed: 58 additions & 39 deletions
Original file line numberDiff line numberDiff line change
@@ -1,43 +1,62 @@
11
Order,Tool,Group,Status,Complete
22
1,AI Assistant,AI,Wireframe,No
3-
2,Project Workspace,Build/Create,Ready,Yes
4-
3,Project Journey,Build/Create,Ready,Yes
5-
4,Game Design,Design,Ready,Yes
6-
5,Game Configuration,Build/Create,Ready,Yes
7-
6,Assets,Design,Ready,Yes
8-
7,Colors,Design,Ready,Yes
9-
8,Fonts,Design,Wireframe,No
10-
9,Sprites,Design,Wireframe,No
11-
10,Characters,Design,Wireframe,No
12-
11,Objects,Design,Wireframe,No
13-
12,Worlds,Design,Wireframe,No
14-
13,Animations,Design,Wireframe,No
15-
14,Audio,Audio,Wireframe,No
16-
15,Music,Audio,Wireframe,No
17-
16,Voices,Audio,Wireframe,No
18-
17,Videos,Audio,Wireframe,No
19-
18,Build Game,Build/Create,Wireframe,No
20-
19,Game Testing,Play,Wireframe,No
21-
20,Controls,Platform,Wireframe,No
22-
21,Hitboxes,Platform,Wireframe,No
23-
22,Saved Data,Platform,Wireframe,No
24-
23,Debug,Platform,Wireframe,No
25-
24,Performance,Platform,Wireframe,No
26-
25,Events,Platform,Wireframe,No
27-
26,Publish,Marketplace,Planned,No
28-
27,Marketplace,Marketplace,Wireframe,No
29-
28,Community,Marketplace,Wireframe,No
30-
29,Languages,Platform,Wireframe,No
31-
30,Achievements,Play,Wireframe,No
32-
31,Ratings,Play,Wireframe,No
33-
32,Cloud,Platform,Hidden,No
34-
33,Custom Extensions,Build/Create,Hidden,No
35-
34,MIDI,Audio,Hidden,No
36-
35,Particles,Audio,Hidden,No
37-
36,Audio Effects,Audio,Hidden,No
38-
37,Voice Capture,Audio,Hidden,No
39-
38,Voice Output,Audio,Hidden,No
40-
39,Users,Platform,Planned,No
3+
2,Game Workspace,Create,Ready,Yes
4+
3,Game Configuration,Create,Ready,Yes
5+
4,Project Team,Create,Planned,No
6+
5,Tags,Create,Ready,Yes
7+
6,Game Design,Design,Ready,Yes
8+
7,Assets,Design,Ready,Yes
9+
8,Colors,Design,Ready,Yes
10+
9,Fonts,Design,Wireframe,No
11+
10,Sprites,Design,Wireframe,No
12+
11,Characters,Design,Wireframe,No
13+
12,Objects,Design,Wireframe,No
14+
13,Worlds,Design,Wireframe,No
15+
14,Animations,Design,Wireframe,No
16+
15,Audio,Audio,Wireframe,No
17+
16,Music,Audio,Wireframe,No
18+
17,Voices,Audio,Wireframe,No
19+
18,Videos,Audio,Wireframe,No
20+
19,Build Game,Build/Create,Wireframe,No
21+
20,Game Testing,Play,Wireframe,No
22+
21,Controls,Platform,Wireframe,No
23+
22,Hitboxes,Platform,Wireframe,No
24+
23,Saved Data,Platform,Wireframe,No
25+
24,Debug,Platform,Wireframe,No
26+
25,Performance,Platform,Wireframe,No
27+
26,Events,Platform,Wireframe,No
28+
27,Publish,Marketplace,Planned,No
29+
28,Marketplace,Marketplace,Wireframe,No
30+
29,Community,Marketplace,Wireframe,No
31+
30,Languages,Platform,Wireframe,No
32+
31,Achievements,Play,Wireframe,No
33+
32,Ratings,Play,Wireframe,No
34+
33,Cloud,Platform,Hidden,No
35+
34,Custom Extensions,Build/Create,Hidden,No
36+
35,MIDI,Audio,Hidden,No
37+
36,Particles,Audio,Hidden,No
38+
37,Audio Effects,Audio,Hidden,No
39+
38,Voice Capture,Audio,Hidden,No
40+
39,Voice Output,Audio,Hidden,No
4141
40,Environments,Platform,Planned,No
4242
41,Game Migration,Platform,Planned,No
43-
42,Platform Settings,Platform,Planned,No
43+
42,Platform Settings,Platform,Planned,No
44+
45+
Toolbox Workflow Ordering Governance
46+
- Toolbox groups are intentional workflow-order exceptions.
47+
- Tiles are ordered by creator progression, not alphabetically.
48+
- Order follows how users naturally work: Select -> Create -> Review, Left -> Right, Top -> Bottom.
49+
- The next tile should represent the most likely next creator action.
50+
- Tile ordering should minimize navigation decisions.
51+
52+
Create group order
53+
1. Game Workspace
54+
2. Game Configuration
55+
3. Project Team
56+
4. Tags
57+
58+
Team distinction
59+
- Studio Team = account-level roster.
60+
- Project Team = project-level assignment.
61+
- Current implementation focus is Project Team.
62+
- Users functionality that is project-specific moves from Account/Team planning into Create/Project Team planning.

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

Lines changed: 56 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,56 @@
1+
# PR_26170_006-toolbox-workflow-order-and-project-team
2+
3+
## Branch Validation
4+
- PASS: Current branch verified as `main`.
5+
6+
## Requirement Checklist
7+
- PASS: Built `PR_26170_006-toolbox-workflow-order-and-project-team`.
8+
- PASS: Added BUILD doc at `docs_build/pr/BUILD_PR_26170_006-toolbox-workflow-order-and-project-team.md`.
9+
- PASS: Added Toolbox Workflow Ordering Governance to `docs_build/dev/PROJECT_INSTRUCTIONS.md`.
10+
- PASS: Documented Toolbox groups as intentional workflow-order exceptions.
11+
- PASS: Documented tile ordering by creator progression rather than alphabetical sorting.
12+
- PASS: Documented natural ordering rules: `Select -> Create -> Review`, `Left -> Right`, and `Top -> Bottom`.
13+
- PASS: Documented that the next tile should represent the most likely next creator action.
14+
- PASS: Documented that tile ordering should minimize navigation decisions.
15+
- PASS: Updated Create group references to this order: Game Workspace, Game Configuration, Project Team, Tags.
16+
- PASS: Moved project-specific Users planning into Create/Project Team documentation.
17+
- PASS: Documented the distinction between Studio Team as account-level roster and Project Team as project-level assignment.
18+
- PASS: Updated Owner Notes source content in `docs_build/dev/admin-notes/tools/index.txt`.
19+
- PASS: Updated owner-facing group notes in `owner/grouping-colors.html`.
20+
- PASS: No runtime behavior changes were made for this PR.
21+
22+
## Impacted Lane
23+
- Documentation/static lane only.
24+
25+
## Validation
26+
- PASS: `git branch --show-current` returned `main`.
27+
- PASS: `git diff --check -- docs_build/dev/PROJECT_INSTRUCTIONS.md docs_build/dev/admin-notes/tools/index.txt owner/grouping-colors.html docs_build/pr/BUILD_PR_26170_006-toolbox-workflow-order-and-project-team.md`
28+
- PASS: Targeted Node documentation validation confirmed:
29+
- governance includes workflow-order exception rules.
30+
- governance includes creator progression, next-action, and navigation-minimization rules.
31+
- Create group order is consistent.
32+
- Owner Notes source includes Project Team and Tags in Create.
33+
- Owner Notes source no longer lists Users as Platform planning.
34+
- owner reference no longer lists Users in Share.
35+
- Studio Team and Project Team distinction is documented.
36+
37+
## Playwright Decision
38+
- Playwright impacted: No.
39+
- No Playwright impact. This PR is docs/workflow only.
40+
- `npm run test:workspace-v2` was not run because no runtime, UI behavior, toolState, workspace, or interaction behavior changed.
41+
42+
## Skipped Lanes
43+
- Runtime: skipped because this PR changes documentation only.
44+
- Integration: skipped because no handoff contract changed.
45+
- Engine: skipped because no engine/shared runtime code changed.
46+
- Samples: skipped because no sample files or sample loading behavior changed.
47+
- Recovery/UAT: skipped because this is not a recovery lane behavior change.
48+
- Full samples smoke: skipped per request and because documentation changes do not affect sample runtime behavior.
49+
50+
## Manual Test Notes
51+
- Open `owner/grouping-colors.html` and confirm Create lists Game Workspace, Game Configuration, Project Team, and Tags.
52+
- 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.
53+
- Confirm no Toolbox page ordering or runtime behavior changed in this PR.
54+
55+
## Stacked Worktree Note
56+
- The working tree already contains uncommitted prior PR changes. This PR's intentional product changes are documentation-only in `docs_build/dev/PROJECT_INSTRUCTIONS.md`, `docs_build/dev/admin-notes/tools/index.txt`, and `owner/grouping-colors.html`, plus the required BUILD/report artifacts.

‎docs_build/dev/reports/codex_changed_files.txt‎

Lines changed: 10 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,20 +1,16 @@
11
# git status --short
2-
M docs_build/dev/reports/codex_changed_files.txt
3-
M docs_build/dev/reports/codex_review.diff
2+
M docs_build/dev/PROJECT_INSTRUCTIONS.md
3+
M docs_build/dev/admin-notes/tools/index.txt
44
M owner/grouping-colors.html
5-
M tests/playwright/tools/ToolboxRoutePages.spec.mjs
6-
M toolbox/tools-page-accordions.js
7-
?? docs_build/dev/reports/PR_26170_005-toolbox-create-idea-color-model.md
8-
?? docs_build/pr/BUILD_PR_26170_005-toolbox-create-idea-color-model.md
5+
?? docs_build/dev/reports/PR_26170_006-toolbox-workflow-order-and-project-team.md
6+
?? docs_build/pr/BUILD_PR_26170_006-toolbox-workflow-order-and-project-team.md
97

108
# git ls-files --others --exclude-standard
11-
docs_build/dev/reports/PR_26170_005-toolbox-create-idea-color-model.md
12-
docs_build/pr/BUILD_PR_26170_005-toolbox-create-idea-color-model.md
9+
docs_build/dev/reports/PR_26170_006-toolbox-workflow-order-and-project-team.md
10+
docs_build/pr/BUILD_PR_26170_006-toolbox-workflow-order-and-project-team.md
1311

1412
# git diff --stat
15-
docs_build/dev/reports/codex_changed_files.txt | 34 +-
16-
docs_build/dev/reports/codex_review.diff | 1246 +++++++--------------
17-
owner/grouping-colors.html | 214 +++-
18-
tests/playwright/tools/ToolboxRoutePages.spec.mjs | 33 +-
19-
toolbox/tools-page-accordions.js | 4 +-
20-
5 files changed, 599 insertions(+), 932 deletions(-)
13+
docs_build/dev/PROJECT_INSTRUCTIONS.md | 26 ++++++++
14+
docs_build/dev/admin-notes/tools/index.txt | 97 ++++++++++++++++++------------
15+
owner/grouping-colors.html | 19 ++++--
16+
3 files changed, 97 insertions(+), 45 deletions(-)

0 commit comments

Comments
 (0)