docs: update documentation source path references

Update all documentation references to reflect canonical source now
located at docs-site/src/content/docs/ instead of the old docs/ folder.

- Update AGENTS.md and CLAUDE.md agent guidance with new doc paths
- Update README.md, CHANGELOG.md, CONTRIBUTING.md project references
- Fix editUrl in all docs-site content files to point to new location
- Update docs-site README to reflect canonical source location
- Correct OpenCode upstream URL to opencode-ai organization

Author: MasuRii

AGENTS.md

@@ -34,26 +34,24 @@ Supported Claude Code integration mechanisms documented in this repo:
 
 When updating docs or implementing features, verify claims using these sources.
 
-> Note: Some references below include example local paths from one development machine. If you do not have these repos checked out locally, use the upstream GitHub repositories and adjust paths accordingly.
-
 - **ReCursor docs (the contract):**
-  - `C:/Repository/ReCursor/docs/README.md`
-  - `C:/Repository/ReCursor/docs/architecture/overview.md`
-  - `C:/Repository/ReCursor/docs/integration/`
+  - `docs-site/src/content/docs/` (canonical documentation source)
+  - `docs-site/src/content/docs/architecture/system-overview.md`
+  - `docs-site/src/content/docs/integrations/`
 
 - **OpenCode UI patterns (desktop parity reference):**
-  - Upstream repo: https://github.com/anomalyco/opencode
-  - Local repo (optional): `C:/Repository/opencode/`
-  - Especially: `C:/Repository/opencode/packages/ui/src/components/`
+  - Upstream repo: https://github.com/opencode-ai/opencode
+  - Key path: `packages/ui/src/components/`
 
 - **Claude Code supported extension points:**
   - Upstream repo: https://github.com/anthropics/claude-code
-  - Local repo (optional): `C:/Repository/claude-code/`
-  - Especially: `C:/Repository/claude-code/plugins/plugin-dev/skills/hook-development/`
+  - Key paths:
+    - `plugins/plugin-dev/skills/hook-development/SKILL.md`
+    - `plugins/hookify/hooks/hooks.json`
 
 - **Official docs:**
-  - Claude Code docs: https://code.claude.com/docs/
-  - Agent SDK docs: https://docs.claude.com/en/api/agent-sdk/overview
+  - Claude Code docs: https://docs.anthropic.com/en/docs/claude-code
+  - Agent SDK docs: https://docs.anthropic.com/en/api/agent-sdk
 
 If something is not in the above sources, treat it as **unknown** and document it as an **open question**.
 
@@ -62,12 +60,14 @@ If something is not in the above sources, treat it as **unknown** and document i
 ## 3) Repo layout (scaffold)
 
 ```text
-C:/Repository/ReCursor/
-├── apps/mobile/            # Flutter app scaffold (no implementation yet)
-├── packages/bridge/        # Node/TypeScript bridge scaffold (no implementation yet)
-├── docs/                   # Project documentation (source-of-truth)
-├── .github/                # CI scaffolding
-└── fastlane/               # Release scaffolding
+ReCursor/
+├── apps/mobile/              # Flutter app scaffold
+├── packages/bridge/          # Node/TypeScript bridge scaffold
+├── packages/claude-plugin/   # Claude Code plugin scaffold
+├── docs-site/                # Astro Starlight documentation site
+│   └── src/content/docs/     # Canonical documentation source
+├── .github/                  # CI scaffolding
+└── fastlane/                 # Release scaffolding
 ```
 
 ---
@@ -81,7 +81,7 @@ C:/Repository/ReCursor/
 - Keep edits strictly within the requested scope.
 - Prefer small, reviewable commits/changesets.
 - When changing docs, keep them **internally consistent** (cross-links, terminology).
-- When making factual claims about OpenCode/Claude Code behavior, include a citation (path + short excerpt) in your PR description.
+- When making factual claims about OpenCode/Claude Code behavior, include a citation (URL + short excerpt) in your PR description.
 
 **Don't:**
 - Do not introduce claims like "ReCursor mirrors Claude Code Remote Control sessions" unless official docs explicitly support third‑party clients.
@@ -93,9 +93,9 @@ C:/Repository/ReCursor/
 Before marking docs work complete:
 - Ensure internal links resolve.
 - Search for outdated branding/terms that should not exist.
-- For Claude Code hooks docs, ensure you are aligned with:
-  - `C:/Repository/claude-code/plugins/plugin-dev/skills/hook-development/SKILL.md`
-  - `C:/Repository/claude-code/plugins/hookify/hooks/hooks.json`
+- For Claude Code hooks docs, ensure you are aligned with the upstream repo:
+  - `plugins/plugin-dev/skills/hook-development/SKILL.md`
+  - `plugins/hookify/hooks/hooks.json`
 
 ### 4.3 Commit message guidelines
 
@@ -133,19 +133,22 @@ Future agent integrations will follow the adapter pattern established by the Cla
 ## 5) Preferred workflow for future implementation
 
 When implementation is requested:
+
 1. **Confirm scope**: which subproject(s) are being built (Flutter app, bridge, both).
-2. **Follow docs**: treat `docs/` as the contract; if docs are wrong, fix docs first.
-3. **Implement minimal vertical slices**: scaffold → connect → render a small set of UI components.
+2. **Follow docs**: treat `docs-site/src/content/docs/` as the contract; if docs are wrong, fix docs first.
+3. **Work efficiently in parallel**:
+   - Identify independent tasks that can be executed concurrently (file reads, searches, analysis)
+   - Batch related operations to minimize context switches
+   - Use parallel tool invocations where dependencies allow
+   - Prefer complete, working solutions over piecemeal slices
 4. **Verify** with build/lint/test commands appropriate to the stack.
 
 ---
 
 ## 6) Quick links for agents
 
-- Docs index: `C:/Repository/ReCursor/docs/README.md`
-- Plan: `C:/Repository/ReCursor/docs/PLAN.md`
-- OpenCode UI mapping: `C:/Repository/ReCursor/docs/integration/opencode-ui-patterns.md`
-- Claude Code hooks: `C:/Repository/ReCursor/docs/integration/claude-code-hooks.md`
-- Agent SDK: `C:/Repository/ReCursor/docs/integration/agent-sdk.md`
-- OpenCode upstream: https://github.com/anomalyco/opencode
-- Claude Code upstream: https://github.com/anthropics/claude-code
+- **Docs index:** `docs-site/src/content/docs/index.mdx`
+- **Architecture:** `docs-site/src/content/docs/architecture/system-overview.md`
+- **Integrations:** `docs-site/src/content/docs/integrations/`
+- **OpenCode upstream:** https://github.com/opencode-ai/opencode
+- **Claude Code upstream:** https://github.com/anthropics/claude-code

CHANGELOG.md

@@ -10,7 +10,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Added
 
 #### Monorepo Infrastructure
-- Monorepo scaffolding with `apps/`, `packages/`, `docs/`, `.github/`, `fastlane/` structure
+- Monorepo scaffolding with `apps/`, `packages/`, `docs-site/`, `.github/`, `fastlane/` structure
 - Development helper scripts in `tool/` for bridge and mobile workflows
 - Pre-commit hooks for format and check enforcement
 - Repository governance documents: `CODE_OF_CONDUCT.md`, `CONTRIBUTING.md`, `SECURITY.md`
@@ -49,7 +49,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Serif typography (Crimson Pro) for headings, Inter for body/UI
 - Warm off-white palette with refined ink tones and dark mode support
 
-#### Documentation (`docs/`)
+#### Documentation (`docs-site/`)
 - Architecture: `overview.md`, `data-flow.md`
 - Integration guides: `claude-code-hooks.md`, `agent-sdk.md`, `opencode-ui-patterns.md`
 - Protocol specs: `bridge-protocol.md`, `bridge-http-api.md`, `error-handling.md`, `type-mapping.md`

CLAUDE.md

@@ -34,26 +34,24 @@ Supported Claude Code integration mechanisms documented in this repo:
 
 When updating docs or implementing features, verify claims using these sources.
 
-> Note: Some references below include example local paths from one development machine. If you do not have these repos checked out locally, use the upstream GitHub repositories and adjust paths accordingly.
-
 - **ReCursor docs (the contract):**
-  - `C:/Repository/ReCursor/docs/README.md`
-  - `C:/Repository/ReCursor/docs/architecture/overview.md`
-  - `C:/Repository/ReCursor/docs/integration/`
+  - `docs-site/src/content/docs/` (canonical documentation source)
+  - `docs-site/src/content/docs/architecture/system-overview.md`
+  - `docs-site/src/content/docs/integrations/`
 
 - **OpenCode UI patterns (desktop parity reference):**
-  - Upstream repo: https://github.com/anomalyco/opencode
-  - Local repo (optional): `C:/Repository/opencode/`
-  - Especially: `C:/Repository/opencode/packages/ui/src/components/`
+  - Upstream repo: https://github.com/opencode-ai/opencode
+  - Key path: `packages/ui/src/components/`
 
 - **Claude Code supported extension points:**
   - Upstream repo: https://github.com/anthropics/claude-code
-  - Local repo (optional): `C:/Repository/claude-code/`
-  - Especially: `C:/Repository/claude-code/plugins/plugin-dev/skills/hook-development/`
+  - Key paths:
+    - `plugins/plugin-dev/skills/hook-development/SKILL.md`
+    - `plugins/hookify/hooks/hooks.json`
 
 - **Official docs:**
-  - Claude Code docs: https://code.claude.com/docs/
-  - Agent SDK docs: https://docs.claude.com/en/api/agent-sdk/overview
+  - Claude Code docs: https://docs.anthropic.com/en/docs/claude-code
+  - Agent SDK docs: https://docs.anthropic.com/en/api/agent-sdk
 
 If something is not in the above sources, treat it as **unknown** and document it as an **open question**.
 
@@ -62,12 +60,14 @@ If something is not in the above sources, treat it as **unknown** and document i
 ## 3) Repo layout (scaffold)
 
 ```text
-C:/Repository/ReCursor/
-├── apps/mobile/            # Flutter app scaffold (no implementation yet)
-├── packages/bridge/        # Node/TypeScript bridge scaffold (no implementation yet)
-├── docs/                   # Project documentation (source-of-truth)
-├── .github/                # CI scaffolding
-└── fastlane/               # Release scaffolding
+ReCursor/
+├── apps/mobile/              # Flutter app scaffold
+├── packages/bridge/          # Node/TypeScript bridge scaffold
+├── packages/claude-plugin/   # Claude Code plugin scaffold
+├── docs-site/                # Astro Starlight documentation site
+│   └── src/content/docs/     # Canonical documentation source
+├── .github/                  # CI scaffolding
+└── fastlane/                 # Release scaffolding
 ```
 
 ---
@@ -81,7 +81,7 @@ C:/Repository/ReCursor/
 - Keep edits strictly within the requested scope.
 - Prefer small, reviewable commits/changesets.
 - When changing docs, keep them **internally consistent** (cross-links, terminology).
-- When making factual claims about OpenCode/Claude Code behavior, include a citation (path + short excerpt) in your PR description.
+- When making factual claims about OpenCode/Claude Code behavior, include a citation (URL + short excerpt) in your PR description.
 
 **Don't:**
 - Do not introduce claims like "ReCursor mirrors Claude Code Remote Control sessions" unless official docs explicitly support third‑party clients.
@@ -93,9 +93,9 @@ C:/Repository/ReCursor/
 Before marking docs work complete:
 - Ensure internal links resolve.
 - Search for outdated branding/terms that should not exist.
-- For Claude Code hooks docs, ensure you are aligned with:
-  - `C:/Repository/claude-code/plugins/plugin-dev/skills/hook-development/SKILL.md`
-  - `C:/Repository/claude-code/plugins/hookify/hooks/hooks.json`
+- For Claude Code hooks docs, ensure you are aligned with the upstream repo:
+  - `plugins/plugin-dev/skills/hook-development/SKILL.md`
+  - `plugins/hookify/hooks/hooks.json`
 
 ### 4.3 Commit message guidelines
 
@@ -133,19 +133,22 @@ Future agent integrations will follow the adapter pattern established by the Cla
 ## 5) Preferred workflow for future implementation
 
 When implementation is requested:
+
 1. **Confirm scope**: which subproject(s) are being built (Flutter app, bridge, both).
-2. **Follow docs**: treat `docs/` as the contract; if docs are wrong, fix docs first.
-3. **Implement minimal vertical slices**: scaffold → connect → render a small set of UI components.
+2. **Follow docs**: treat `docs-site/src/content/docs/` as the contract; if docs are wrong, fix docs first.
+3. **Work efficiently in parallel**:
+   - Identify independent tasks that can be executed concurrently (file reads, searches, analysis)
+   - Batch related operations to minimize context switches
+   - Use parallel tool invocations where dependencies allow
+   - Prefer complete, working solutions over piecemeal slices
 4. **Verify** with build/lint/test commands appropriate to the stack.
 
 ---
 
 ## 6) Quick links for agents
 
-- Docs index: `C:/Repository/ReCursor/docs/README.md`
-- Plan: `C:/Repository/ReCursor/docs/PLAN.md`
-- OpenCode UI mapping: `C:/Repository/ReCursor/docs/integration/opencode-ui-patterns.md`
-- Claude Code hooks: `C:/Repository/ReCursor/docs/integration/claude-code-hooks.md`
-- Agent SDK: `C:/Repository/ReCursor/docs/integration/agent-sdk.md`
-- OpenCode upstream: https://github.com/anomalyco/opencode
-- Claude Code upstream: https://github.com/anthropics/claude-code
+- **Docs index:** `docs-site/src/content/docs/index.mdx`
+- **Architecture:** `docs-site/src/content/docs/architecture/system-overview.md`
+- **Integrations:** `docs-site/src/content/docs/integrations/`
+- **OpenCode upstream:** https://github.com/opencode-ai/opencode
+- **Claude Code upstream:** https://github.com/anthropics/claude-code

CONTRIBUTING.md

@@ -10,9 +10,8 @@ By participating, you agree to follow our [Code of Conduct](CODE_OF_CONDUCT.md).
 
 ## Quick links
 
-- Docs index (source of truth): `docs/README.md`
-- Architecture overview: `docs/architecture/overview.md`
-- Plan / roadmap: `docs/PLAN.md`
+- Docs index (source of truth): `docs-site/src/content/docs/index.mdx`
+- Architecture overview: `docs-site/src/content/docs/architecture/system-overview.md`
 - Agentic AI guidance: `AGENTS.md`
 
 ## What you can contribute right now
@@ -29,7 +28,9 @@ Because implementation is not yet complete, these contribution types are most he
 C:/Repository/ReCursor/
 ├── apps/mobile/            # Flutter app scaffold
 ├── packages/bridge/        # Node/TypeScript bridge scaffold
-└── docs/                   # Documentation (architecture + integration guides)
+├── docs-site/              # Documentation site (Astro Starlight)
+│   └── src/content/docs/   # Canonical documentation source
+└── packages/claude-plugin/ # Claude Code plugin scaffold
 ```
 
 ## Development prerequisites (for future work)

README.md

@@ -33,7 +33,7 @@
   <a href="#project-status">
     <img src="https://img.shields.io/badge/Status-WIP-orange?style=flat-square" alt="Status: WIP">
   </a>
-  <a href="docs/README.md">
+  <a href="docs-site/src/content/docs/index.mdx">
     <img src="https://img.shields.io/badge/Docs-Start%20Here-blue?style=flat-square" alt="Docs">
   </a>
   <a href="https://github.com/RecursiveDev/ReCursor/issues">
@@ -62,7 +62,7 @@ This repository is **work in progress**, but the current Claude-first MVP is no
 - ✅ Git status, diff viewing, and repository browsing are implemented for the current mobile/bridge stack.
 - ⏳ Remaining work is focused on polish: approval UX refinement, notification center UI, and future multi-agent expansion.
 
-If you're new here, start with: **`docs/README.md`**, `docs/architecture/overview.md`, and `docs/architecture/REMAINING_PHASES.md`.
+If you're new here, start with: **`docs-site/src/content/docs/`** (browse the docs-site content or run `npm run dev` in `docs-site/` to view locally).
 
 ---
 
@@ -115,15 +115,16 @@ C:/Repository/ReCursor/
 
 ## Documentation
 
-- **Canonical docs index:** `docs/README.md`
-- **Published docs site source:** `docs-site/`
-- **Run the docs site locally:** `cd docs-site && npm install && npm run dev`
-- **Architecture overview:** `docs/architecture/overview.md`
-- **Data flow diagrams:** `docs/architecture/data-flow.md`
+- **Published docs site:** `docs-site/` — run `npm install && npm run dev` to view locally
+- **Docs landing page:** [docs-site/src/content/docs/index.mdx](docs-site/src/content/docs/index.mdx)
+- **Architecture:**
+  - System overview: [docs-site/src/content/docs/architecture/system-overview.md](docs-site/src/content/docs/architecture/system-overview.md)
+  - Data flow: [docs-site/src/content/docs/architecture/data-flow.md](docs-site/src/content/docs/architecture/data-flow.md)
+  - Bridge protocol: [docs-site/src/content/docs/architecture/bridge-protocol.md](docs-site/src/content/docs/architecture/bridge-protocol.md)
 - **Integrations:**
-  - OpenCode UI patterns: `docs/integration/opencode-ui-patterns.md`
-  - Claude Code Hooks: `docs/integration/claude-code-hooks.md`
-  - Agent SDK: `docs/integration/agent-sdk.md`
+  - OpenCode UI patterns: [docs-site/src/content/docs/integrations/opencode-ui-patterns.md](docs-site/src/content/docs/integrations/opencode-ui-patterns.md)
+  - Claude Code Hooks: [docs-site/src/content/docs/integrations/claude-code-hooks.md](docs-site/src/content/docs/integrations/claude-code-hooks.md)
+  - Agent SDK: [docs-site/src/content/docs/integrations/agent-sdk.md](docs-site/src/content/docs/integrations/agent-sdk.md)
 
 ---
 

docs-site/README.md

@@ -4,9 +4,9 @@ This folder contains the Astro Starlight documentation site for ReCursor.
 
 ## How it works
 
-- Canonical Markdown source lives in `C:/Repository/ReCursor/docs/`.
-- `npm run generate` copies that source into `src/content/docs/`, rewrites internal links to the published information architecture, and generates `public/llms.txt` plus `public/llms-full.txt`.
+- Canonical Markdown source lives in `src/content/docs/` within this docs-site folder.
 - Section landing pages in `src/content/docs/` provide the curated Starlight navigation layer.
+- Run `npm run dev` to preview locally, `npm run build` to build for production.
 
 ## Commands
 
@@ -19,6 +19,5 @@ npm run build
 
 ## Editing guidance
 
-- Update canonical content in `C:/Repository/ReCursor/docs/` whenever possible.
-- Update `scripts/docs-manifest.mjs` if a source document is added, renamed, or moved in the published site.
+- Update content directly in `src/content/docs/` within this repository.
 - Keep claims about Claude Code aligned with `C:/Repository/ReCursor/AGENTS.md`.

docs-site/src/content/docs/architecture/bridge-protocol.md

@@ -1,7 +1,7 @@
 ---
 title: "Bridge Protocol Specification"
 description: "WebSocket message protocol between the ReCursor Flutter mobile app and the user-controlled TypeScript bridge server. Bridge-first, no-login: device pairing via QR code, no user accounts."
-editUrl: "https://github.com/RecursiveDev/ReCursor/edit/main/docs/bridge-protocol.md"
+editUrl: "https://github.com/RecursiveDev/ReCursor/edit/main/docs-site/src/content/docs/bridge-protocol.md"
 sidebar:
   order: 50
   label: "Bridge protocol"

docs-site/src/content/docs/architecture/data-flow.md

@@ -1,7 +1,7 @@
 ---
 title: "Data Flow Architecture"
 description: "Message flow between ReCursor mobile app, bridge server, and Claude Code via Hooks."
-editUrl: "https://github.com/RecursiveDev/ReCursor/edit/main/docs/architecture/data-flow.md"
+editUrl: "https://github.com/RecursiveDev/ReCursor/edit/main/docs-site/src/content/docs/architecture/data-flow.md"
 sidebar:
   order: 20
   label: "Data flow"

docs-site/src/content/docs/architecture/data-models.md

@@ -1,7 +1,7 @@
 ---
 title: "Data Models"
 description: "Drift schemas, Hive models, and domain entities for ReCursor."
-editUrl: "https://github.com/RecursiveDev/ReCursor/edit/main/docs/data-models.md"
+editUrl: "https://github.com/RecursiveDev/ReCursor/edit/main/docs-site/src/content/docs/data-models.md"
 sidebar:
   order: 40
   label: "Data models"

docs-site/src/content/docs/architecture/project-structure.md

@@ -1,7 +1,7 @@
 ---
 title: "Project Structure"
 description: "Flutter directory layout and module organization for ReCursor."
-editUrl: "https://github.com/RecursiveDev/ReCursor/edit/main/docs/project-structure.md"
+editUrl: "https://github.com/RecursiveDev/ReCursor/edit/main/docs-site/src/content/docs/project-structure.md"
 sidebar:
   order: 30
   label: "Project structure"
@@ -43,7 +43,8 @@ recursor/
 │       ├── package.json
 │       └── tsconfig.json
 │
-├── docs/                          # Documentation (this folder)
+├── docs-site/                     # Documentation (Astro Starlight site)
+│   └── src/content/docs/          # Canonical documentation source
 ├── .github/
 │   └── workflows/                 # CI/CD pipelines
 │       ├── test.yml               # PR test pipeline