From 9832ef5968ef902a519b51a9d57fe0c0d8525b3a Mon Sep 17 00:00:00 2001
From: Egor Merkushev <gorkaedeep@gmail.com>
Date: Sun, 8 Feb 2026 19:45:17 +0300
Subject: [PATCH] Add P8-T2: Restructure DocC to Canonical Swift Package Format

New task to move DocC catalog from root-level mcpbridge-wrapper.docc/
to canonical SPM structure under Sources/XcodeMCPWrapper/Documentation.docc/

This follows Apple's standard Swift Package Manager documentation structure.
---
 SPECS/Workplan.md | 33 +++++++++++++++++++++++++++++++++
 1 file changed, 33 insertions(+)

diff --git a/SPECS/Workplan.md b/SPECS/Workplan.md
index 98d67c4d..62c1a448 100644
--- a/SPECS/Workplan.md
+++ b/SPECS/Workplan.md
@@ -721,6 +721,39 @@ Create a Python-based protocol compatibility wrapper that intercepts MCP respons
   - DocC builds documentation without errors
   - GitHub Pages site is live at `soundblaster.github.io/mcpbridge-wrapper`
   - Documentation updates automatically on pushes to main
+
+#### ⏳ P8-T2: Restructure DocC to Canonical Swift Package Format
+- **Description:** Move DocC catalog from root-level `mcpbridge-wrapper.docc/` to canonical Swift Package Manager structure under `Sources/XcodeMCPWrapper/Documentation.docc/`
+- **Priority:** P2
+- **Dependencies:** P8-T1
+- **Parallelizable:** yes
+- **Outputs/Artifacts:** 
+  - New directory: `Sources/XcodeMCPWrapper/Documentation.docc/`
+  - Main DocC file: `Sources/XcodeMCPWrapper/Documentation.docc/XcodeMCPWrapper.md`
+  - All existing DocC articles moved to new location
+  - Updated GitHub Actions workflow with correct paths
+- **Acceptance Criteria:** 
+  - DocC catalog follows Apple's canonical SPM structure
+  - GitHub Actions workflow builds from new location
+  - All existing documentation content preserved
+  - GitHub Pages deployment still works correctly
+  - Old `mcpbridge-wrapper.docc/` directory removed
+- **Canonical Structure:**
+  ```
+  Sources/
+    XcodeMCPWrapper/
+      Documentation.docc/
+        XcodeMCPWrapper.md          # Main landing page
+        GettingStarted.md
+        Installation.md
+        Configuration.md
+        CursorSetup.md
+        ClaudeCodeSetup.md
+        CodexCLISetup.md
+        Troubleshooting.md
+        Architecture.md
+        EnvironmentVariables.md
+  ```
 - **Reference Implementation:**
   ```yaml
   name: Deploy DocC Documentation