[chore]: retire legacy documentation workspace

.github/workflows/e2e.yml

@@ -10,7 +10,6 @@ on:
     paths-ignore:
       - "apps/api/package.json"
       - ".github/**"
-      - "apps/docs/**"
       - "**/*.md"
   pull_request:
     branches:
@@ -61,7 +60,7 @@ jobs:
           while IFS= read -r f; do
             [ -z "$f" ] && continue
             case "$f" in
-              .github/*|apps/docs/*|deploy/*|*.md) ;;
+              .github/*|deploy/*|*.md) ;;
               *) relevant=true; break ;;
             esac
           done <<< "$FILES"

.github/workflows/multi-pod.yml

@@ -9,7 +9,6 @@ on:
     paths-ignore:
       - "apps/api/package.json"
       - ".github/**"
-      - "apps/docs/**"
       - "**/*.md"
   pull_request:
     # Multi-pod tests are slow (~7-10 min cold image build + serialized

.github/workflows/resilience.yml

@@ -9,7 +9,6 @@ on:
     paths-ignore:
       - "apps/api/package.json"
       - ".github/**"
-      - "apps/docs/**"
       - "**/*.md"
   workflow_dispatch:
 

.github/workflows/sandbox-daemon.yml

@@ -16,7 +16,6 @@ on:
     paths-ignore:
       - "apps/api/package.json"
       - ".github/**"
-      - "apps/docs/**"
       - "**/*.md"
   pull_request:
     branches:

.github/workflows/storage-integration.yml

@@ -20,7 +20,6 @@ on:
     paths-ignore:
       - "apps/api/package.json"
       - ".github/**"
-      - "apps/docs/**"
       - "**/*.md"
   pull_request:
     branches:

.github/workflows/test.yml

@@ -10,7 +10,6 @@ on:
     paths-ignore:
       - "apps/api/package.json"
       - ".github/**"
-      - "apps/docs/**"
       - "**/*.md"
   pull_request:
     branches:
@@ -78,7 +77,7 @@ jobs:
           while IFS= read -r f; do
             [ -z "$f" ] && continue
             case "$f" in
-              .github/*|apps/docs/*|deploy/*|*.md) ;;
+              .github/*|deploy/*|*.md) ;;
               *) relevant=true ;;
             esac
             case "$f" in

.gitignore

@@ -1,12 +1,6 @@
 # GSD workflow state
 .planning/
 
-# Local-only architecture diagram tooling (generates the standalone html
-# from architecture-model.ts; the committed docs use ArchitectureDiagram.astro).
-/architecture.html
-apps/docs/scripts/gen-architecture-html.ts
-apps/docs/scripts/architecture-runtime.js
-
 # Logs
 logs
 *.log
@@ -103,7 +97,7 @@ packages/e2e/screenshots/
 .github/screenshots/
 .github/pr-assets/
 
-# Generated docs (root-level only, not apps/docs/). Use /docs/* not /docs
+# Generated docs (root-level only). Use /docs/* not /docs
 # so we can un-ignore specific subdirs below — git won't traverse into an
 # ignored directory.
 /docs/*

.oxlintrc.json

@@ -13,7 +13,6 @@
     "./plugins/ban-git-provider-reachthrough.js",
     "./plugins/ensure-tailwind-design-system-tokens.js"
   ],
-  "ignorePatterns": ["apps/docs/*"],
   "rules": {
     "unicorn/no-useless-fallback-in-spread": "off",
     "no-unused-expressions": "off",

AGENTS.md

@@ -93,8 +93,14 @@ rewriting Git history does not revoke them.
 
 ## Documentation
 
-`apps/docs/` describes intended system behavior and architecture. When code
-differs, preserve the specification and identify the implementation gap.
+Public product documentation lives in
+[docs-tanstack](https://github.com/deco-sites/docs-tanstack) and is published at
+[Studio documentation](https://docs.decocms.com/studio). Update product guides
+and architecture there. When code differs, preserve the specification and
+identify the implementation gap.
+
+Keep workspace setup, contributor guidance, and implementation plans in this
+repository's READMEs and engineering documents.
 
 Keep each instruction in one place. Put task-specific guidance near its owner
 and link to it here with a condition for reading it. Let code, schemas, and

README.md

@@ -174,14 +174,20 @@ Every tool call gets input/output validation, access control, audit logging, and
 
 ---
 
+## Documentation
+
+[Studio documentation](https://docs.decocms.com/studio) lives in
+[docs-tanstack](https://github.com/deco-sites/docs-tanstack), alongside the
+Storefront documentation. Update public product guides and architecture there.
+Workspace READMEs and engineering plans stay here with the implementation.
+
 ## Project Structure
 
 ### Applications
 
 | Workspace | Purpose |
 | --- | --- |
 | [`apps/api`](./apps/api/README.md) | Hono API, authentication, tools, storage, migrations, and the `deco` CLI |
-| [`apps/docs`](./apps/docs/README.md) | Astro documentation site |
 | [`apps/native`](./apps/native/README.md) | Tauri desktop app and local Rust runtime |
 | [`apps/web`](./apps/web/README.md) | Vite and React 19 administration interface |