Refine docs sidebar navigation

Author: Saga4

docs-site/agents.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Use with agents"
+title: "Agent workflows"
 description: "Give agents local files, clear rules, and a safe review path back to the source app."
 ---
 

docs-site/docs.json

@@ -49,40 +49,41 @@
   "navigation": {
     "groups": [
       {
-        "group": "Start",
-        "icon": "rocket",
+        "group": "Get Started",
         "pages": [
           "overview",
           "install",
-          "quickstart",
-          "filesystem-model"
+          "quickstart"
         ]
       },
       {
-        "group": "Use Locality",
-        "icon": "folder-sync",
+        "group": "Core Concepts",
+        "pages": [
+          "filesystem-model",
+          "sync-safety"
+        ]
+      },
+      {
+        "group": "Workflows",
         "pages": [
           "desktop",
           "agents",
           "best-practices",
-          "sync-safety",
           "use-cases"
         ]
       },
       {
-        "group": "Reference",
-        "icon": "terminal",
+        "group": "Connectors",
         "pages": [
-          "cli-reference",
           "connectors/notion",
-          "connectors/google-docs",
-          "okf-export"
+          "connectors/google-docs"
         ]
       },
       {
-        "group": "Operations",
-        "icon": "settings",
+        "group": "Reference",
         "pages": [
+          "cli-reference",
+          "okf-export",
           "troubleshooting",
           "development"
         ]

docs-site/llms.txt

@@ -2,40 +2,40 @@
 
 > Locality mounts apps such as Notion and Google Docs as local Markdown files so humans, editors, and agents can read, edit, review, and sync work safely.
 
-## Read first
+## Get Started
 
 - [Overview](overview.mdx): Product model, core surfaces, and safety model.
 - [Install Locality](install.mdx): OS-specific GitHub release assets, verification, and updates.
 - [Quickstart](quickstart.mdx): Install, connect, mount, edit, diff, and push.
+
+## Core Concepts
+
 - [Filesystem model](filesystem-model.mdx): How pages, databases, documents, stubs, media, and frontmatter map to files.
+- [Sync safety](sync-safety.mdx): Pending changes, remote drift, conflicts, restore, and diagnostics.
 
-## Human workflows
+## Workflows
 
 - [Desktop app](desktop.mdx): Onboarding, mounts, files, pending changes, and Live Mode.
+- [Agent workflows](agents.mdx): Agent contract, prompts, Live Mode behavior, and MCP fallback.
 - [Best practices](best-practices.mdx): Recommendations for reliable human and agent workflows.
 - [Use cases](use-cases.mdx): Engineering wiki updates, meeting notes, content operations, database workflows, OKF export, and safe agent handoff.
-- [Sync safety](sync-safety.mdx): Pending changes, remote drift, conflicts, restore, and diagnostics.
-
-## Agent workflows
-
-- [Use with agents](agents.mdx): Agent contract, prompts, Live Mode behavior, and MCP fallback.
 
-Agent rule summary:
+## Agent Rule Summary
 
 - edit mounted Markdown directly;
 - preserve Locality frontmatter, block identity directives, `_schema.yaml`, `AGENTS.md`, and `CLAUDE.md`;
 - use `loc status` and `loc diff` for inspection;
 - do not push unless the user explicitly asks or Live Mode has a safe path;
 - prefer scoped paths over broad workspace commands.
 
-## Reference
+## Connectors
 
-- [CLI reference](cli-reference.mdx): Essential `loc` command surface.
 - [Notion connector](connectors/notion.mdx): Notion projection, databases, supported writes, and common errors.
 - [Google Docs connector](connectors/google-docs.mdx): Google Docs projection, supported content, and limits.
-- [OKF export](okf-export.mdx): Export mounted content as portable Open Knowledge Format bundles.
 
-## Operations
+## Reference
 
+- [CLI reference](cli-reference.mdx): Essential `loc` command surface.
+- [OKF export](okf-export.mdx): Export mounted content as portable Open Knowledge Format bundles.
 - [Troubleshooting](troubleshooting.mdx): Provider drift, stale paths, connector errors, conflicts, Live Mode pauses, and build mismatches.
 - [Development](development.mdx): Repo setup, desktop dev, checks, daemon, File Provider, publish commands, and docs preview.

docs-site/overview.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Locality"
+title: "Overview"
 description: "Mount apps as local files so humans and agents can read, edit, review, and sync work safely."
 ---