Skip to content

Commit 60d89d8

Browse files
committed
OWNER 010 add Codex workflow command governance
1 parent 451a6b5 commit 60d89d8

13 files changed

Lines changed: 611 additions & 850 deletions

dev/build/ProjectInstructions/PROJECT_INSTRUCTIONS.md

Lines changed: 14 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -8,24 +8,27 @@ Codex and future wrappers must request this file directly. All other Project Ins
88

99
## Current Version/Date
1010

11-
- Project Instructions Version: 2026-06-27.PR_26179_OWNER_010
12-
- Date: 2026-06-27
11+
- Project Instructions Version: 2026-06-28.PR_26179_OWNER_010
12+
- Date: 2026-06-28
1313
- Owner: OWNER
1414

1515
## Required Read Order
1616

1717
1. Always read `dev/build/ProjectInstructions/PROJECT_INSTRUCTIONS.md`.
1818
2. Always read `dev/build/ProjectInstructions/PROJECT_STATE.md`.
1919
3. Always read `dev/build/ProjectInstructions/repository/canonical_repository_structure.md`.
20-
4. For Start of Day, read `dev/build/ProjectInstructions/bootstrap/codex_start_of_day_bootstrap.md`.
21-
5. Load team, backlog, database, runtime, theme, or other specialist documents only when the current task requires them.
20+
4. For Codex workflow command interpretation, read `dev/build/ProjectInstructions/standards/CODEX_WORKFLOW_COMMANDS.md`.
21+
5. For Start of Day, read `dev/build/ProjectInstructions/bootstrap/codex_start_of_day_bootstrap.md`.
22+
6. Load team, backlog, database, runtime, theme, or other specialist documents only when the current task requires them.
2223

2324
## Load Graph
2425

2526
```text
2627
PROJECT_INSTRUCTIONS.md
2728
|-- PROJECT_STATE.md
2829
|-- repository/canonical_repository_structure.md
30+
|-- standards/CODEX_WORKFLOW_COMMANDS.md
31+
| `-- Start of Day, PLAN_PR, BUILD_PR, APPLY_PR, or command interpretation
2932
|-- bootstrap/codex_start_of_day_bootstrap.md
3033
| `-- Start of Day only
3134
|-- team/backlog docs
@@ -43,6 +46,7 @@ PROJECT_INSTRUCTIONS.md
4346
- `PROJECT_INSTRUCTIONS.md`: always.
4447
- `PROJECT_STATE.md`: always.
4548
- `repository/canonical_repository_structure.md`: always.
49+
- `standards/CODEX_WORKFLOW_COMMANDS.md`: Start of Day, PLAN_PR, BUILD_PR, APPLY_PR, invalid command, or command interpretation tasks.
4650
- `bootstrap/codex_start_of_day_bootstrap.md`: Start of Day only.
4751
- Backlog docs: Start of Day or planning only.
4852
- Database docs: DB, DDL, DML, seed, or API persistence changes only.
@@ -64,19 +68,17 @@ Stop before changing files when:
6468

6569
## Execution Modes
6670

67-
- Owner: decisions, governance direction, standards.
68-
- Build PR: execute one scoped PR purpose, validate, report, package.
69-
- Continue: continue the current scoped branch or PR without expanding scope.
70-
- Review: findings, risks, recommendations only unless implementation is explicitly requested.
71-
- Challenge: identify contradictions, risks, or better alternatives.
72-
- Stop Gate: stop and report the reason and required correction.
71+
Official Codex workflow command governance lives in:
7372

74-
For detailed execution-mode wording, load `dev/build/ProjectInstructions/addendums/assistant_execution_modes.md` only when mode interpretation is unclear.
73+
`dev/build/ProjectInstructions/standards/CODEX_WORKFLOW_COMMANDS.md`
74+
75+
That file owns Start of Day, PLAN_PR, BUILD_PR, APPLY_PR, and invalid command behavior.
7576

7677
## Referenced Documents
7778

7879
- Project state: `dev/build/ProjectInstructions/PROJECT_STATE.md`
7980
- Repository folder placement SSoT: `dev/build/ProjectInstructions/repository/canonical_repository_structure.md`
81+
- Codex workflow commands: `dev/build/ProjectInstructions/standards/CODEX_WORKFLOW_COMMANDS.md`
8082
- Codex Start-of-Day bootstrap: `dev/build/ProjectInstructions/bootstrap/codex_start_of_day_bootstrap.md`
8183
- Branch lifecycle: `dev/build/ProjectInstructions/addendums/project_instructions_single_source_eod_lock.md`
8284
- PR workflow: `dev/build/ProjectInstructions/addendums/pr_workflow.md`
@@ -98,4 +100,5 @@ For detailed execution-mode wording, load `dev/build/ProjectInstructions/addendu
98100
- `PROJECT_INSTRUCTIONS.md` owns the manual entry point, required read order, load graph, stop gates, execution modes, and pointers.
99101
- `PROJECT_STATE.md` owns machine-friendly project state metadata.
100102
- `repository/canonical_repository_structure.md` owns all folder placement and file-placement rules.
103+
- `standards/CODEX_WORKFLOW_COMMANDS.md` owns Start of Day, PLAN_PR, BUILD_PR, APPLY_PR, and invalid command behavior.
101104
- `bootstrap/codex_start_of_day_bootstrap.md` owns Start-of-Day bootstrap architecture.

dev/build/ProjectInstructions/PROJECT_STATE.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,15 @@
11
# Project State
22

33
```yaml
4-
project_state_version: "2026-06-27.PR_26179_OWNER_010"
5-
last_updated: "2026-06-27"
4+
project_state_version: "2026-06-28.PR_26179_OWNER_010"
5+
last_updated: "2026-06-28"
66
current_main_commit: "40de767476d70cadfd1292c916844c2f31b6f185"
77
repository_status:
88
state: "active-owner-pr"
99
current_pr: "PR_26179_OWNER_010-canonical-project-folder-instructions"
1010
required_start_branch: "main"
1111
required_start_sync: "main...origin/main == 0 0"
12-
project_instructions_version: "2026-06-27.PR_26179_OWNER_010"
12+
project_instructions_version: "2026-06-28.PR_26179_OWNER_010"
1313
canonical_layout_version: "2026-06-27.PR_26179_OWNER_010"
1414
active_teams:
1515
- "Team OWNER"

dev/build/ProjectInstructions/TEAM_START_COMMANDS.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,12 @@
22

33
## Required Main Reset Gate For Every Team
44

5+
Official Start of Day command format lives in:
6+
7+
`dev/build/ProjectInstructions/standards/CODEX_WORKFLOW_COMMANDS.md`
8+
9+
The ready-to-copy team assignment commands below are OWNER assignment helpers, not Start of Day bootstrap commands.
10+
511
No team creates a PR branch until all checks pass:
612

713
- Current branch: `main`
Lines changed: 3 additions & 116 deletions
Original file line numberDiff line numberDiff line change
@@ -1,120 +1,7 @@
11
# Assistant Execution Modes
22

3-
## Purpose
3+
Status: Superseded
44

5-
Standardize request interpretation and expected outputs for Review, Owner, Build PR, Continue, Challenge, and Stop Gate workflows.
5+
SSoT: `dev/build/ProjectInstructions/standards/CODEX_WORKFLOW_COMMANDS.md`
66

7-
## Command Modes
8-
9-
### Review
10-
11-
Expected Output:
12-
- Findings
13-
- Risks
14-
- Recommendations
15-
16-
Do Not Output:
17-
- PRs
18-
- Implementation plans
19-
20-
### Owner
21-
22-
Expected Output:
23-
- Decisions
24-
- Governance direction
25-
- Standards
26-
27-
Do Not Output:
28-
- Detailed implementation
29-
30-
### Build PR
31-
32-
Expected Output:
33-
- Single Codex work order
34-
- May contain multiple sequential PRs belonging to the same workstream
35-
- Copy/paste ready for execution
36-
37-
Should Include:
38-
- Start gates
39-
- Changes
40-
- Validation
41-
- Commit names
42-
- Stop point
43-
44-
Do Not Output:
45-
- Design discussion
46-
- Alternatives
47-
- Rationale
48-
- Architecture brainstorming
49-
50-
### Continue
51-
52-
Expected Output:
53-
- Next sequential executable PR
54-
- Next sequential work order
55-
56-
Do Not Output:
57-
- New ideas
58-
- Re-analysis
59-
- Additional brainstorming
60-
61-
### Challenge
62-
63-
Expected Output:
64-
- Risks
65-
- Contradictions
66-
- Better alternatives
67-
68-
Do Not Output:
69-
- Immediate implementation
70-
71-
### Stop Gate
72-
73-
Expected Output:
74-
- Why work should stop
75-
- Required corrections
76-
77-
Allowed Reasons:
78-
- Governance conflict
79-
- Architecture conflict
80-
- Security risk
81-
- Data loss risk
82-
- Major technical debt increase
83-
84-
## Additional Definitions
85-
86-
### Follow Project Instructions
87-
88-
Meaning:
89-
- Use existing governance
90-
- Do not redesign process
91-
92-
### Build the PR
93-
94-
Meaning:
95-
- Produce Codex executable work order immediately
96-
97-
### Continue
98-
99-
Meaning:
100-
- Produce next sequential work item
101-
102-
### No zip file
103-
104-
Meaning:
105-
- Generate instructions only
106-
- Do not expect artifact review
107-
108-
### You are owner
109-
110-
Meaning:
111-
- Make decisions
112-
- Do not ask for direction unless blocked
113-
114-
### Done for the day
115-
116-
Meaning:
117-
- Finish commits
118-
- Merge
119-
- Push
120-
- Create next-day start document
7+
This file is retained as a compatibility pointer only. Do not duplicate command mode tables or phase rules here.

dev/build/ProjectInstructions/addendums/pr_workflow.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,12 @@ Owner: OWNER
77

88
Define the standard pull request workflow for Game Foundry Studio.
99

10+
Official PLAN_PR, BUILD_PR, APPLY_PR, Start of Day, and invalid command behavior lives in:
11+
12+
`dev/build/ProjectInstructions/standards/CODEX_WORKFLOW_COMMANDS.md`
13+
14+
This file owns PR lifecycle governance. It must not duplicate command phase rules.
15+
1016
## Standard Flow
1117

1218
1. Start from main.

dev/build/ProjectInstructions/bootstrap/codex_start_of_day_bootstrap.md

Lines changed: 11 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -14,17 +14,11 @@ This document is documentation and wrapper/bootstrap design only. It does not im
1414

1515
A Bootstrap Phrase is a short user-facing phrase that asks the wrapper to resolve the latest Project Instructions and team state before launching Codex.
1616

17-
Examples:
17+
Official Start of Day command format and invalid command behavior live in:
1818

19-
- Owner Start of Day
20-
- Team Alpha Start of Day
21-
- Team Bravo Start of Day
22-
- Team Charlie Start of Day
23-
- Team Gamma Start of Day
19+
`dev/build/ProjectInstructions/standards/CODEX_WORKFLOW_COMMANDS.md`
2420

25-
Team name note:
26-
- `Team Alpha Start of Day` is accepted as a user phrase alias for the canonical Team Alfa lane.
27-
- Historical Team Gamma phrases may be understood for archived/historical context, but active assignment routing follows the current team registry.
21+
This bootstrap document owns the loading architecture only. It must not duplicate the command vocabulary.
2822

2923
## Bootstrap Responsibilities
3024

@@ -101,14 +95,19 @@ If a chat instruction conflicts with Project Instructions:
10195

10296
When a request contains:
10397

104-
- Build PR
98+
- Start of Day
99+
- PLAN_PR
100+
- BUILD_PR
101+
- APPLY_PR
105102
- Continue
106103
- Follow Project Instructions
107104
- Next PR
108105

109-
Codex must treat the request as Execution Mode.
106+
Codex must resolve command behavior through:
110107

111-
Execution Mode means:
108+
`dev/build/ProjectInstructions/standards/CODEX_WORKFLOW_COMMANDS.md`
109+
110+
Execution Mode still means:
112111

113112
- Execute the requested work order.
114113
- Do not redesign the process.
Lines changed: 5 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,5 @@
1-
| Command | Mode | Expected Output | Do Not Output |
2-
| ---------------- | ------------------- | ----------------------------------------------------------------- | ------------------------------------------ |
3-
| Review | Analysis | Findings, risks, recommendations | PRs, implementation plans |
4-
| Owner | Governance | Decision, direction, standards | Detailed implementation |
5-
| Build PR | Execution | **Single Codex work order containing one or more sequential PRs** | Design discussion, alternatives, rationale |
6-
| Continue | Execution | Next sequential executable PR or next sequential work order | Additional analysis, brainstorming |
7-
| Challenge | Architecture Review | Why proposal may be wrong, alternatives, risks | Immediate implementation |
8-
| Stop Gate | Blocker Review | Why work should stop, required fixes | PR generation |
9-
| Build Work Order | Execution | Copy/paste-ready Codex instructions | Governance discussion |
1+
Status: Superseded
2+
3+
SSoT: dev/build/ProjectInstructions/standards/CODEX_WORKFLOW_COMMANDS.md
4+
5+
This file is retained as a compatibility pointer only. Do not duplicate command tables here.

0 commit comments

Comments
 (0)