Add tool status governance - PR_26160_085-tool-status-governance

Author: ToolboxAid

docs_build/dev/PROJECT_INSTRUCTIONS.md

@@ -255,6 +255,24 @@ Project Workspace is the next first real Toolbox rebuild target. Its contract ow
 
 Do not implement Project Workspace runtime behavior, persistence, database behavior, authentication, or save/load flows before the rebuild PR explicitly scopes those capabilities.
 
+## TOOL STATUS GOVERNANCE
+
+The authoritative tool status values are:
+- `planned`
+- `wireframe`
+- `beta`
+- `complete`
+
+Status definitions:
+- `planned`: Not designed yet. No meaningful UI. No ownership defined.
+- `wireframe`: Tool exists. User can understand workflow. Data ownership is defined. Not functionally usable.
+- `beta`: Functionally usable. Can be used in a real game. May still contain incomplete workflows, placeholder data, UI cleanup issues, unused fields, missing validation, or incomplete code review.
+- `complete`: Functionally usable. Code reviewed. Dead code removed. Invalid fields removed. UI cleaned up. No known placeholder data. No known invalid controls. Ready for long-term support.
+
+UAT rule:
+- A tool required for the current MVP game path must be `beta` or `complete` before UAT.
+- `complete` is not required for MVP UAT, but `beta` is the minimum usable state.
+
 ## TARGETED MSJ VALIDATION GOVERNANCE
 
 Every tool, page, or `src/` change must declare its impacted MSJ/test lane.

docs_build/dev/reports/tool-status-governance-report.md

@@ -0,0 +1,39 @@
+# PR_26160_085 Tool Status Governance Report
+
+## Branch Validation
+
+| Check | Result | Evidence |
+| --- | --- | --- |
+| Current branch is `main` | PASS | `git branch --show-current` returned `main`. |
+
+## Governance Anchor
+
+| Requirement | Result | Evidence |
+| --- | --- | --- |
+| Add authoritative tool status governance to `docs_build/dev/PROJECT_INSTRUCTIONS.md` | PASS | Added `## TOOL STATUS GOVERNANCE` after the existing Toolbox progress guidance so it is the newer authoritative section. |
+| Preserve status values `planned`, `wireframe`, `beta`, `complete` | PASS | Section lists only those four lowercase values. |
+| Define `planned` | PASS | Definition added: not designed, no meaningful UI, no ownership defined. |
+| Define `wireframe` | PASS | Definition added: workflow understandable, data ownership defined, not functionally usable. |
+| Define `beta` | PASS | Definition added: functionally usable for a real game with known incomplete cleanup allowed. |
+| Define `complete` | PASS | Definition added: reviewed, cleaned, no known placeholder/invalid controls, long-term support ready. |
+| Add UAT rule for MVP path tools | PASS | Section states MVP path tools must be `beta` or `complete` before UAT. |
+| State complete is not required for MVP UAT | PASS | Section states `beta` is the minimum usable state. |
+
+## Validation
+
+| Lane | Result | Notes |
+| --- | --- | --- |
+| Branch guard | PASS | Current branch was `main` before changes. |
+| Docs/static | PASS | `rg` verified the new governance anchor exists. |
+| Diff hygiene | PASS | `git diff --check` completed without whitespace errors. |
+
+## Impacted Lanes
+
+- Impacted lane: docs/governance.
+- Playwright impacted: No. This PR changes documentation only.
+- Samples skipped: Safe to skip because no sample, runtime, or tool behavior changed.
+- Full samples validation: Not run per request.
+
+## Manual Test Notes
+
+- Review `docs_build/dev/PROJECT_INSTRUCTIONS.md` and confirm the new `TOOL STATUS GOVERNANCE` section is present and uses the requested definitions.