Fused-Gaming · jlucus · Feb 8, 2026 · Feb 8, 2026 · Feb 8, 2026 · Feb 8, 2026
diff --git a/.github/SETUP_CHECKLIST.md b/.github/SETUP_CHECKLIST.md
@@ -178,7 +178,7 @@ After completing setup, verify:
 - [Label Definitions](/.github/labels.yml) - All 83 organization labels
 - [Sync Setup Guide](/.github/workflows/SYNC_LABELS_SETUP.md) - Detailed token setup
 - [Workflow README](/.github/workflows/README.md) - All workflow documentation
-- [Workspace Guide](/WORKSPACE_GUIDE.md) - VS Code configuration
+- [Workspace Guide](/docs/operations/WORKSPACE_GUIDE.md) - VS Code configuration
 - [Fix Summary](/.github/LABEL_SYNC_FIX.md) - What was changed and why
 
 ## 🎯 Next Steps After Setup

diff --git a/.github/workflows/README.md b/.github/workflows/README.md
@@ -148,7 +148,7 @@ This directory contains automated workflows that help maintain Fused Gaming's or
 
 **Enforcement**: Strategic items (priority: critical/high, goal-proposal, project-proposal, governance) receive a comment requesting milestone labeling if none is present.
 
-**Reference**: See [LABELS_README.md](../../LABELS_README.md) for complete milestone-to-deliverable mapping and [MILESTONES_OVERVIEW.md](../../MILESTONES_OVERVIEW.md) for milestone details.
+**Reference**: See [LABELS_README.md](../../docs/operations/LABELS_README.md) for complete milestone-to-deliverable mapping and [MILESTONES_OVERVIEW.md](../../docs/planning/MILESTONES_OVERVIEW.md) for milestone details.
 
 ---
 
@@ -187,7 +187,7 @@ This directory contains automated workflows that help maintain Fused Gaming's or
 - Scans PR diffs for sensitive content (emails, phone numbers, financial data, API keys, investor references)
 - Comments findings on the PR for review
 
-**Configuration**: Managed by [DOCUMENT_CLASSIFICATION_POLICY.md](../DOCUMENT_CLASSIFICATION_POLICY.md)
+**Configuration**: Managed by [DOCUMENT_CLASSIFICATION_POLICY.md](../../docs/governance/DOCUMENT_CLASSIFICATION_POLICY.md)
 
 ---
 
@@ -204,7 +204,7 @@ This directory contains automated workflows that help maintain Fused Gaming's or
 - Creates GitHub issues for stale documents (with deduplication)
 - Generates audit summary report
 
-**Configuration**: Managed by [DOCUMENT_CLASSIFICATION_POLICY.md](../DOCUMENT_CLASSIFICATION_POLICY.md)
+**Configuration**: Managed by [DOCUMENT_CLASSIFICATION_POLICY.md](../../docs/governance/DOCUMENT_CLASSIFICATION_POLICY.md)
 
 ---
 
@@ -231,7 +231,7 @@ Defines all organization-wide labels with:
 
 **To modify**: Edit `labels.yml` and sync will run automatically
 
-**Full reference**: See [LABELS_README.md](../../LABELS_README.md) for complete label-to-rule mappings, downstream workflow effects, and known conflicts
+**Full reference**: See [LABELS_README.md](../../docs/operations/LABELS_README.md) for complete label-to-rule mappings, downstream workflow effects, and known conflicts
 
 ---
 
@@ -357,9 +357,9 @@ When updating workflows:
 
 ## Resources
 
-- [GOVERNANCE.md](../GOVERNANCE.md) - Decision-making framework
-- [GOALS.md](../GOALS.md) - Current strategic goals
-- [PROJECT_BOARD_GUIDE.md](../PROJECT_BOARD_GUIDE.md) - Board usage guide
+- [GOVERNANCE.md](../../docs/governance/GOVERNANCE.md) - Decision-making framework
+- [GOALS.md](../../docs/planning/GOALS.md) - Current strategic goals
+- [PROJECT_BOARD_GUIDE.md](../../docs/operations/PROJECT_BOARD_GUIDE.md) - Board usage guide
 - [CONTRIBUTING.md](../CONTRIBUTING.md) - Contribution guidelines
 - [GitHub Actions Documentation](https://docs.github.com/en/actions)
 

diff --git a/.github/workflows/SYNC_LABELS_SETUP.md b/.github/workflows/SYNC_LABELS_SETUP.md
@@ -281,7 +281,7 @@ Edit the sync step:
 4. Verify in a test repository first
 
 ### Questions about label strategy?
-- Review [../LABELS_README.md](../LABELS_README.md)
+- Review [LABELS_README.md](../../docs/operations/LABELS_README.md)
 - Check [../LABEL_SYNC_FIX.md](../LABEL_SYNC_FIX.md) for context
 
 ---

diff --git a/.github/workflows/add-to-milestone.yml b/.github/workflows/add-to-milestone.yml
@@ -102,10 +102,10 @@ This ${type} has been added to our **Strategic Backlog** for review by the core
 **Next steps:**
 - Core team will review within 3-5 business days
 - You'll be notified of any questions or feedback
-- See our [GOVERNANCE.md](https://github.com/Fused-Gaming/.github/blob/main/GOVERNANCE.md) for the decision-making process
+- See our [GOVERNANCE.md](https://github.com/Fused-Gaming/.github/blob/main/docs/governance/GOVERNANCE.md) for the decision-making process
 
 **Resources:**
-- [Current Goals](https://github.com/Fused-Gaming/.github/blob/main/GOALS.md)
+- [Current Goals](https://github.com/Fused-Gaming/.github/blob/main/docs/planning/GOALS.md)
 - [Contributing Guidelines](https://github.com/Fused-Gaming/.github/blob/main/CONTRIBUTING.md)
 
 **Track Progress:**

diff --git a/.github/workflows/cross-repo-milestone-sync.yml b/.github/workflows/cross-repo-milestone-sync.yml
@@ -225,6 +225,6 @@ jobs:
             summary += `### Label Definitions\n`;
             summary += `Labels are synced from \`.github/labels.yml\` via \`sync-labels.yml\`.\n`;
             summary += `Enforcement rules are defined in \`milestone-task-enforcement.yml\` and \`cross-repo-milestone-sync.yml\`.\n`;
-            summary += `See [LABELS_README.md](https://github.com/Fused-Gaming/.github/blob/main/LABELS_README.md) for full reference.\n`;
+            summary += `See [LABELS_README.md](https://github.com/Fused-Gaming/.github/blob/main/docs/operations/LABELS_README.md) for full reference.\n`;
 
             core.summary.addRaw(summary).write();
diff --git a/.github/workflows/doc-freshness-check.yml b/.github/workflows/doc-freshness-check.yml
@@ -32,15 +32,15 @@ jobs:
 
             // Documents that must stay current
             const livingDocs = [
-              'PROJECT_BOARD_GUIDE.md',
-              'GOALS.md',
-              'MILESTONES_OVERVIEW.md',
+              'docs/operations/PROJECT_BOARD_GUIDE.md',
+              'docs/planning/GOALS.md',
+              'docs/planning/MILESTONES_OVERVIEW.md',
               'SECURITY.md',
               'CONTRIBUTING.md',
-              'GOVERNANCE.md',
-              'GOVERNANCE_PROTOCOL.md',
-              'DOCUMENT_CLASSIFICATION_POLICY.md',
-              'LABELS_README.md'
+              'docs/governance/GOVERNANCE.md',
+              'docs/governance/GOVERNANCE_PROTOCOL.md',
+              'docs/governance/DOCUMENT_CLASSIFICATION_POLICY.md',
+              'docs/operations/LABELS_README.md'
             ];
 
             // Check each living doc for Last Updated date
@@ -85,8 +85,8 @@ jobs:
             const changesWorkflowDocs = files.includes('.github/workflows/README.md');
             const changesLabels = files.includes('.github/labels.yml') || files.includes('labels.yml');
             const changesAutoLabeling = files.includes('.github/workflows/auto-label-issues.yml');
-            const changesLabelDocs = files.includes('LABELS_README.md');
-            const changesBoardDocs = files.includes('PROJECT_BOARD_GUIDE.md');
+            const changesLabelDocs = files.some(f => f.endsWith('LABELS_README.md'));
+            const changesBoardDocs = files.some(f => f.endsWith('PROJECT_BOARD_GUIDE.md'));
             const changesTemplates = files.some(f => f.includes('ISSUE_TEMPLATE'));
             const missingUpdates = [];
 
@@ -114,7 +114,7 @@ jobs:
             }
             if (missingUpdates.length > 0) {
               body += '### Missing Documentation Updates\n\n';
-              body += 'Per [DOCUMENT_CLASSIFICATION_POLICY.md](../DOCUMENT_CLASSIFICATION_POLICY.md), the following docs should be updated in this PR:\n\n';
+              body += 'Per [DOCUMENT_CLASSIFICATION_POLICY.md](../../docs/governance/DOCUMENT_CLASSIFICATION_POLICY.md), the following docs should be updated in this PR:\n\n';
               body += missingUpdates.join('\n') + '\n\n';
             }
             if (warnings.length > 0) {
@@ -124,7 +124,7 @@ jobs:
 
             if (body) {
               body = '## Documentation Freshness Check\n\n' + body;
-              body += '\n---\n*This check is enforced by [DOCUMENT_CLASSIFICATION_POLICY.md](../DOCUMENT_CLASSIFICATION_POLICY.md) Section 2.1*';
+              body += '\n---\n*This check is enforced by [DOCUMENT_CLASSIFICATION_POLICY.md](../../docs/governance/DOCUMENT_CLASSIFICATION_POLICY.md) Section 2.1*';
 
               await github.rest.issues.createComment({
                 owner: context.repo.owner,
@@ -194,7 +194,7 @@ jobs:
 
               if (errors.length > 0) {
                 body += '### Blocked - Potential Confidential Content\n\n';
-                body += 'The following additions may contain confidential information per [DOCUMENT_CLASSIFICATION_POLICY.md](../DOCUMENT_CLASSIFICATION_POLICY.md):\n\n';
+                body += 'The following additions may contain confidential information per [DOCUMENT_CLASSIFICATION_POLICY.md](../../docs/governance/DOCUMENT_CLASSIFICATION_POLICY.md):\n\n';
                 for (const e of errors) {
                   body += `- **${e.file}**: ${e.label} detected\n  \`${e.preview}\`\n`;
                 }
@@ -208,7 +208,7 @@ jobs:
                 }
               }
 
-              body += '\n---\n*This scan is enforced by [DOCUMENT_CLASSIFICATION_POLICY.md](../DOCUMENT_CLASSIFICATION_POLICY.md) Section 2.3*';
+              body += '\n---\n*This scan is enforced by [DOCUMENT_CLASSIFICATION_POLICY.md](../../docs/governance/DOCUMENT_CLASSIFICATION_POLICY.md) Section 2.3*';
 
               await github.rest.issues.createComment({
                 owner: context.repo.owner,

diff --git a/.github/workflows/doc-staleness-audit.yml b/.github/workflows/doc-staleness-audit.yml
@@ -28,15 +28,15 @@ jobs:
 
             // Map of docs to check with their expected review cadences
             const docs = [
-              { file: 'PROJECT_BOARD_GUIDE.md', cadence: 'quarterly' },
-              { file: 'GOALS.md', cadence: 'monthly' },
-              { file: 'MILESTONES_OVERVIEW.md', cadence: 'monthly' },
+              { file: 'docs/operations/PROJECT_BOARD_GUIDE.md', cadence: 'quarterly' },
+              { file: 'docs/planning/GOALS.md', cadence: 'monthly' },
+              { file: 'docs/planning/MILESTONES_OVERVIEW.md', cadence: 'monthly' },
               { file: 'SECURITY.md', cadence: 'semi-annual' },
               { file: 'CONTRIBUTING.md', cadence: 'quarterly' },
-              { file: 'GOVERNANCE.md', cadence: 'quarterly' },
-              { file: 'GOVERNANCE_PROTOCOL.md', cadence: 'quarterly' },
-              { file: 'DOCUMENT_CLASSIFICATION_POLICY.md', cadence: 'quarterly' },
-              { file: 'LABELS_README.md', cadence: 'quarterly' }
+              { file: 'docs/governance/GOVERNANCE.md', cadence: 'quarterly' },
+              { file: 'docs/governance/GOVERNANCE_PROTOCOL.md', cadence: 'quarterly' },
+              { file: 'docs/governance/DOCUMENT_CLASSIFICATION_POLICY.md', cadence: 'quarterly' },
+              { file: 'docs/operations/LABELS_README.md', cadence: 'quarterly' }
             ];
 
             for (const doc of docs) {
@@ -105,7 +105,7 @@ jobs:
                 owner: context.repo.owner,
                 repo: context.repo.repo,
                 title: title,
-                body: `## Document Review Required\n\n**File**: \`${stale.file}\`\n**Reason**: ${stale.reason}\n**Expected cadence**: ${stale.cadence}\n\n### Action Required\n\n1. Review the document for accuracy\n2. Update any stale content\n3. Bump the \`Last Updated\` date\n4. Set the next \`Next Review\` date\n5. Verify no confidential content per [DOCUMENT_CLASSIFICATION_POLICY.md](DOCUMENT_CLASSIFICATION_POLICY.md)\n\n---\n*Auto-generated by doc-staleness-audit workflow*`,
+                body: `## Document Review Required\n\n**File**: \`${stale.file}\`\n**Reason**: ${stale.reason}\n**Expected cadence**: ${stale.cadence}\n\n### Action Required\n\n1. Review the document for accuracy\n2. Update any stale content\n3. Bump the \`Last Updated\` date\n4. Set the next \`Next Review\` date\n5. Verify no confidential content per [DOCUMENT_CLASSIFICATION_POLICY.md](docs/governance/DOCUMENT_CLASSIFICATION_POLICY.md)\n\n---\n*Auto-generated by doc-staleness-audit workflow*`,
                 labels: ['type: documentation', 'status: needs-triage']
               });
             }

diff --git a/.github/workflows/goal-alignment-check.yml b/.github/workflows/goal-alignment-check.yml
@@ -32,11 +32,21 @@ jobs:
 
             // Try to fetch GOALS.md from .github repository
             try {
-              const response = await github.rest.repos.getContent({
-                owner: 'Fused-Gaming',
-                repo: '.github',
-                path: 'GOALS.md'
-              });
+              let response;
+              try {
+                response = await github.rest.repos.getContent({
+                  owner: 'Fused-Gaming',
+                  repo: '.github',
+                  path: 'docs/planning/GOALS.md'
+                });
+              } catch (e) {
+                // Fallback to legacy root path during transition
+                response = await github.rest.repos.getContent({
+                  owner: 'Fused-Gaming',
+                  repo: '.github',
+                  path: 'GOALS.md'
+                });
+              }
 
               const content = Buffer.from(response.data.content, 'base64').toString('utf-8');
 
@@ -104,7 +114,7 @@ jobs:
                 owner: context.repo.owner,
                 repo: context.repo.repo,
                 issue_number: item.number,
-                body: `## 🎯 Goal Alignment Check\n\nThis ${isIssue ? 'issue' : 'PR'} is marked as strategic but doesn't explicitly mention alignment with current organizational goals.\n\n**Current Goals for ${currentQuarter}:**\n${goalsList}\n\n**Consider:**\n- Does this align with one of our strategic goals?\n- If yes, please reference the goal in the description\n- If not, should it be a strategic item?\n\nSee [GOALS.md](https://github.com/Fused-Gaming/.github/blob/main/GOALS.md) for details.\n\n*This is an automated check to ensure organizational alignment.*`
+                body: `## 🎯 Goal Alignment Check\n\nThis ${isIssue ? 'issue' : 'PR'} is marked as strategic but doesn't explicitly mention alignment with current organizational goals.\n\n**Current Goals for ${currentQuarter}:**\n${goalsList}\n\n**Consider:**\n- Does this align with one of our strategic goals?\n- If yes, please reference the goal in the description\n- If not, should it be a strategic item?\n\nSee [GOALS.md](https://github.com/Fused-Gaming/.github/blob/main/docs/planning/GOALS.md) for details.\n\n*This is an automated check to ensure organizational alignment.*`
               });
             } else if (mentionedGoals.length > 0) {
               console.log(`✅ Aligned with goals: ${mentionedGoals.join(', ')}`);
@@ -166,7 +176,7 @@ jobs:
             }
 
             summary += `\n---\n`;
-            summary += `View full goals: [GOALS.md](https://github.com/Fused-Gaming/.github/blob/main/GOALS.md)\n`;
+            summary += `View full goals: [GOALS.md](https://github.com/Fused-Gaming/.github/blob/main/docs/planning/GOALS.md)\n`;
             summary += `Track progress: [Project Board](https://github.com/orgs/Fused-Gaming/projects/10)\n`;
 
             core.summary.addRaw(summary).write();

diff --git a/.github/workflows/milestone-task-enforcement.yml b/.github/workflows/milestone-task-enforcement.yml
@@ -113,7 +113,7 @@ jobs:
                   owner: context.repo.owner,
                   repo: context.repo.repo,
                   issue_number: item.number,
-                  body: `## 🏷️ Milestone & Task Label Check\n\nThis ${isIssue ? 'issue' : 'PR'} has strategic labels but no **milestone label** (e.g., \`milestone: M1\`, \`milestone: M2\`).\n\n**Available milestones:**\n| Label | Milestone |\n|---|---|\n| \`milestone: M0\` | Investor Readiness |\n| \`milestone: M1\` | Project Visibility & Documentation |\n| \`milestone: M2\` | Onboarding Infrastructure |\n| \`milestone: M3\` | Community Activation |\n| \`milestone: M4\` | Technical Foundation |\n| \`milestone: M5\` | Community Growth |\n| \`milestone: M6\` | Product Milestones |\n\nPlease add a milestone label and optionally a task label (\`task: T1\` through \`task: T9\`) to track this item's position in the roadmap.\n\nSee [MILESTONES_OVERVIEW.md](https://github.com/Fused-Gaming/.github/blob/main/MILESTONES_OVERVIEW.md) for milestone details.\n\n*This check is enforced by the milestone-task-enforcement workflow.*`
+                  body: `## 🏷️ Milestone & Task Label Check\n\nThis ${isIssue ? 'issue' : 'PR'} has strategic labels but no **milestone label** (e.g., \`milestone: M1\`, \`milestone: M2\`).\n\n**Available milestones:**\n| Label | Milestone |\n|---|---|\n| \`milestone: M0\` | Investor Readiness |\n| \`milestone: M1\` | Project Visibility & Documentation |\n| \`milestone: M2\` | Onboarding Infrastructure |\n| \`milestone: M3\` | Community Activation |\n| \`milestone: M4\` | Technical Foundation |\n| \`milestone: M5\` | Community Growth |\n| \`milestone: M6\` | Product Milestones |\n\nPlease add a milestone label and optionally a task label (\`task: T1\` through \`task: T9\`) to track this item's position in the roadmap.\n\nSee [MILESTONES_OVERVIEW.md](https://github.com/Fused-Gaming/.github/blob/main/docs/planning/MILESTONES_OVERVIEW.md) for milestone details.\n\n*This check is enforced by the milestone-task-enforcement workflow.*`
                 });
               }
             }

diff --git a/.github/workflows/quarterly-okr-tracker.yml b/.github/workflows/quarterly-okr-tracker.yml
@@ -178,8 +178,8 @@ jobs:
 
             report += `\n---\n\n`;
             report += `View detailed progress:\n`;
-            report += `- [GOALS.md](https://github.com/Fused-Gaming/.github/blob/main/GOALS.md)\n`;
-            report += `- [MILESTONES_OVERVIEW.md](https://github.com/Fused-Gaming/.github/blob/main/MILESTONES_OVERVIEW.md)\n`;
+            report += `- [GOALS.md](https://github.com/Fused-Gaming/.github/blob/main/docs/planning/GOALS.md)\n`;
+            report += `- [MILESTONES_OVERVIEW.md](https://github.com/Fused-Gaming/.github/blob/main/docs/planning/MILESTONES_OVERVIEW.md)\n`;
             report += `- [Organization Projects](https://github.com/orgs/Fused-Gaming/projects)\n`;
 
             core.summary.addRaw(report).write();

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -38,8 +38,8 @@ Report violations to the core team via our [security contact](SECURITY.md).
 ### 1. Explore the Organization
 
 - Review our [README](README.md) to understand our mission
-- Read the [GOVERNANCE](GOVERNANCE.md) to understand how we operate
-- Check out [GOALS.md](GOALS.md) to see our strategic objectives
+- Read the [GOVERNANCE](docs/governance/GOVERNANCE.md) to understand how we operate
+- Check out [GOALS.md](docs/planning/GOALS.md) to see our strategic objectives
 - Browse existing projects and repositories
 
 ### 2. Join the Community
@@ -429,10 +429,10 @@ Instead:
 ## Resources
 
 ### Documentation
-- [GOVERNANCE.md](GOVERNANCE.md) - How we make decisions
-- [GOALS.md](GOALS.md) - What we're working toward
+- [GOVERNANCE.md](docs/governance/GOVERNANCE.md) - How we make decisions
+- [GOALS.md](docs/planning/GOALS.md) - What we're working toward
 - [SECURITY.md](SECURITY.md) - Security policies
-- [PROJECT_BOARD_GUIDE.md](PROJECT_BOARD_GUIDE.md) - Project tracking
+- [PROJECT_BOARD_GUIDE.md](docs/operations/PROJECT_BOARD_GUIDE.md) - Project tracking
 
 ### Tools
 - [GitHub Desktop](https://desktop.github.com/) - Git GUI

diff --git a/ISSUE_TEMPLATE/goal-proposal.yml b/ISSUE_TEMPLATE/goal-proposal.yml
@@ -11,7 +11,7 @@ body:
         ## Propose a New Goal
         Thank you for proposing a new goal for Fused Gaming! Strategic goals help align our organization and guide our efforts.
 
-        Please review [GOALS.md](../GOALS.md) and [GOVERNANCE.md](../GOVERNANCE.md) before submitting.
+        Please review [GOALS.md](../docs/planning/GOALS.md) and [GOVERNANCE.md](../docs/governance/GOVERNANCE.md) before submitting.
 
   - type: input
     id: goal-title

diff --git a/ISSUE_TEMPLATE/governance-proposal.yml b/ISSUE_TEMPLATE/governance-proposal.yml
@@ -11,7 +11,7 @@ body:
         ## Propose Governance Changes
         Thank you for helping improve Fused Gaming's governance! Changes to governance require community input and core team approval.
 
-        Please review [GOVERNANCE.md](../GOVERNANCE.md) for the change process.
+        Please review [GOVERNANCE.md](../docs/governance/GOVERNANCE.md) for the change process.
 
   - type: dropdown
     id: change-type

diff --git a/ISSUE_TEMPLATE/project-proposal.yml b/ISSUE_TEMPLATE/project-proposal.yml
@@ -11,7 +11,7 @@ body:
         ## Propose a New Project
         Thank you for proposing a new project! New projects help expand our gaming ecosystem and community impact.
 
-        Review [GOVERNANCE.md](../GOVERNANCE.md) for the project approval process.
+        Review [GOVERNANCE.md](../docs/governance/GOVERNANCE.md) for the project approval process.
 
   - type: input
     id: project-name