Wes/core architecture rework

packages/core/docs/content/actions.mdx

@@ -90,7 +90,7 @@ page. For the full surface map, see [Agent Surfaces](/docs/agent-surfaces).
 
 If the UI and agent both need to do something, reach for an action — not a custom
 route. For when a route-shaped protocol _is_ the right call, see [Prefer Actions
-For App Operations](/docs/server#actions-first).
+For App Operations](/docs/server-overview#actions-first).
 
 On this page: [Start with one action](#hello-action), [Defining an action](#defining),
 [Run context](#run-context), [Access control](#access-control),

packages/core/docs/content/agent-surfaces.mdx

@@ -263,7 +263,7 @@ await runAgentLoop({
 For most apps, scheduled prompts and integration webhooks already call this loop
 for you. Reach for it directly only when building a custom no-browser host, eval
 runner, or server-side orchestration surface — see [Server — Production agent
-handler](/docs/server#agent-handler) for the full signature.
+handler](/docs/server-plugins#agent-chat-plugin) for the full signature.
 
 ### Running against a folder {#folder-loop}
 

packages/core/docs/content/agents.mdx

@@ -0,0 +1,9 @@
+---
+title: "Agents"
+description: "Agent configuration, instructions, and the surfaces agents operate through."
+draft: true
+---
+
+# Agents
+
+This section is coming soon. In the meantime, see [Writing Agent Instructions](/docs/writing-agent-instructions), [Skills](/docs/skills-guide), and [Agent Surfaces](/docs/agent-surfaces) for existing coverage.

packages/core/docs/content/database.mdx

@@ -123,7 +123,7 @@ import * as schema from "./schema.js";
 export const getDb = createGetDb(schema);
 ```
 
-Import `getDb` from this template-local path — `../../server/db/index.js` in routes, `../server/db/index.js` in actions — rather than from `@agent-native/core` directly. The core export returns a generic untyped instance; the template's `getDb()` carries your schema types. See [Server](/docs/server#request-context) for how actions and custom routes each import it.
+Import `getDb` from this template-local path — `../../server/db/index.js` in routes, `../server/db/index.js` in actions — rather than from `@agent-native/core` directly. The core export returns a generic untyped instance; the template's `getDb()` carries your schema types. See [Server](/docs/server-routes#request-context) for how actions and custom routes each import it.
 
 ## Dialect-Agnostic Schema And Queries {#schema}
 
@@ -307,6 +307,6 @@ Instead of pushing directly, schema changes should be applied via SQL migrations
 
 - [**Security — Data Scoping**](/docs/security#data-scoping) — how `owner_email` and access helpers scope reads and writes
 - [**Sharing**](/docs/sharing#building) — `ownableColumns()` and the visibility model for shared resources
-- [**Server**](/docs/server#request-context) — how actions and custom routes each import `getDb`
+- [**Server**](/docs/server-routes#request-context) — how actions and custom routes each import `getDb`
 - [**Deployment**](/docs/deployment#persistent-database) — connecting a persistent database per deploy target
 - [**Actions**](/docs/actions#access-control) — a complete, paste-ready action that reads and writes through `getDb`/`schema`

packages/core/docs/content/drop-in-agent.mdx

@@ -15,7 +15,7 @@ You don't need to build agent-native from scratch. The agent chat, resources tab
 
 <Callout tone="info">
 
-**Prerequisite:** the server has to be running the `agent-chat-plugin` (it auto-mounts in every template). If you're starting from scratch, see [Server](/docs/server). Need the public API map instead of a tutorial? See [Component API](/docs/components).
+**Prerequisite:** the server has to be running the `agent-chat-plugin` (it auto-mounts in every template). If you're starting from scratch, see [Server](/docs/server-overview). Need the public API map instead of a tutorial? See [Component API](/docs/components).
 
 </Callout>
 

packages/core/docs/content/notifications.mdx

@@ -374,4 +374,4 @@ Automations can chain off this — e.g. _"if a critical notification fires, also
 
 - [**Automations**](/docs/automations) — the most common caller of `notify()`
 - [**Security**](/docs/security) — the `${keys.NAME}` substitution that powers the webhook channel
-- [**Server plugins**](/docs/server) — where custom channels are registered at startup
+- [**Server plugins**](/docs/server-plugins) — where custom channels are registered at startup

packages/core/docs/content/routing.mdx

@@ -113,5 +113,5 @@ navigate(`/inbox/${threadId}`);
 ## What's next
 
 - [**Client**](/docs/client) — the agent-native browser hooks and utilities
-- [**Server**](/docs/server) — file-based server routes and the `/_agent-native/` namespace
+- [**Server**](/docs/server-overview) — file-based server routes and the `/_agent-native/` namespace
 - [**Context Awareness**](/docs/context-awareness) — how the agent learns the current route and selection