fede-kamel · Oct 27, 2026 · Oct 27, 2026
diff --git a/README.md b/README.md
@@ -33,7 +33,6 @@
   <a href="https://locusagents.ai/concepts/multi-agent/">Multi-agent shapes</a> ·
   <a href="https://locusagents.ai/how-to/oci-models/">OCI GenAI models</a> ·
   <a href="https://locusagents.ai/concepts/control-layer/">The admission gate</a> ·
-  <a href="https://locusagents.ai/concepts/compare/">How Locus compares</a> ·
   <a href="https://locusagents.ai/notebooks/">Notebooks</a>
 </p>
 
@@ -194,22 +193,6 @@ full runtime.
 
 ---
 
-## How Locus compares
-
-| | Locus | LangGraph | Strands Agents |
-|---|---|---|---|
-| Agent loop with tools | `Agent` + `@tool` | via LangChain | `Agent` + `@tool` |
-| Graphs with state, reducers, interrupts | `StateGraph`, functional API | `StateGraph` | graph tool |
-| Pipelines, orchestrator, swarm, handoff, debate | built in | compose yourself | graph, swarm, workflow |
-| Cognitive router: task to protocol | built in | — | — |
-| Admission gate and signed audit trail | `admit()`, `governed_agent()` | — | — |
-| Grounding of every claim | GSAR | — | — |
-| OCI Generative AI, DAC, Oracle Database 26ai | native | community packages | — |
-
-As documented by each project in October 2026. → [Full comparison](https://locusagents.ai/concepts/compare/)
-
----
-
 ## Notebooks and deploy
 
 [`examples/`](examples/) holds 89 notebooks, numbered in reading order: start here (01–11),

diff --git a/docs/concepts/compare.md b/docs/concepts/compare.md
@@ -1,54 +1,35 @@
 ---
-title: How Locus compares
-description: Locus next to LangGraph, LangChain and Strands Agents, feature by feature, as each project documents itself in October 2026.
+title: Coming from LangGraph or Strands
+description: "How Locus maps onto what you already know from LangGraph, LangChain and Strands Agents, and where it adds something."
 ---
 
-# How Locus compares
+# Coming from LangGraph or Strands
 
 Locus is an agent harness: the agent loop, the ways to combine agents, and the
-runtime around them. The closest neighbours are LangGraph (with LangChain
-underneath) and Strands Agents. This page lists where they meet and where
-Locus differs, as each project documents itself in October 2026. Check the
-other projects' docs for anything that matters to you; they move fast.
-
-## At a glance
-
-| Capability | Locus | LangGraph / LangChain | Strands Agents |
-|---|---|---|---|
-| Agent loop with tools | `Agent`, `@tool`, typed argument coercion, idempotent tools | agents and tools via LangChain | `Agent`, `@tool` |
-| Graphs | `StateGraph` with reducers, conditional edges, `Send` fan-out, interrupts, checkpointed state; functional API | `StateGraph`, functional API | graph multi-agent tool |
-| Composition | `SequentialPipeline`, `ParallelPipeline`, `LoopAgent` | compose from graph nodes | workflow tool |
-| Orchestrator, swarm, handoff | built in, typed specialists and handoff context | supervisor and swarm libraries | swarm and graph tools |
-| Debate, critic loops | notebooks and protocols | build yourself | build yourself |
-| Cognitive router (task to protocol) | `Router.dispatch()`: typed `GoalFrame`, eight protocols, deterministic routing | — | — |
-| Cross-process agents | A2A protocol client and server | via integrations | A2A support |
-| Admission gate, signed audit trail | `admit()`, `approve()`, `governed_agent()`, hash-chained `AuditTrail` | human-in-the-loop interrupts | — |
-| Grounding of claims | GSAR: every claim grounded, contradicted or abstained | — | — |
-| Guardrails and steering | input, output and tool-call guardrails, LLM-as-judge steering, trace hygiene | via LangChain | guardrail hooks |
-| Checkpointers | 10 backends: Oracle Database 26ai (plus versioned saver), OCI Object Storage, PostgreSQL, MySQL, Redis, OpenSearch, S3-compatible, memory, file, HTTP | PostgreSQL, SQLite, Redis, memory, others via packages | session managers |
-| Long-term memory | `OracleStore`, Oracle agent memory, LLM memory manager | store API | via providers |
-| RAG | six vector stores, OCI and in-database embeddings, Cohere rerankers, `retriever.as_tool()` | via LangChain | via tools |
-| Observability | in-process `EventBus`, `run_context()`, 40+ typed events, SSE | LangSmith | OpenTelemetry |
-| Serving | `locus serve` (FastAPI, bearer auth, threads), runner image | LangGraph Platform | AgentCore |
-| OCI Generative AI | native: V1, SDK and Responses transports, auto-routing by model id | community packages | — |
-| Oracle Database 26ai | native vector store, checkpointer, versioned saver, long-term memory, in-database chunking and embeddings | community packages | — |
-| Other providers | OpenAI, Anthropic, 17 OpenAI-compatible routes (OpenRouter, Together, Groq, Ollama, vLLM, …) | broad | Bedrock-first, others via providers |
-
-## What this means in practice
-
-- **Coming from LangGraph.** The `StateGraph` surface will feel familiar: nodes,
-  edges, reducers, `Send`, interrupts, checkpointers. Locus adds the shapes you
-  would otherwise assemble from nodes (orchestrator, swarm, handoff, debate), a
-  router that picks the shape from the task, and a control layer that runs
-  outside the model. See [StateGraph](multi-agent/graph.md) and
-  [Compatibility](../compatibility.md) for the known API differences.
-- **Coming from Strands Agents.** The agent loop, `@tool` and the multi-agent
-  tools map one to one. Locus is Oracle-first where Strands is AWS-first: OCI
-  Generative AI and Oracle Database 26ai are native transports and backends,
-  and the admission gate plus GSAR grounding have no counterpart.
-- **Coming from plain LangChain.** Locus has no LangChain dependency. Its RAG,
-  memory and model layers are its own; the Oracle Database 26ai primitives in
-  particular do not go through `langchain-oracle`.
+runtime around them. If you have built with LangGraph, LangChain or Strands
+Agents, most of it will feel familiar. This page is the orientation.
+
+## Coming from LangGraph
+
+The `StateGraph` surface maps closely: nodes, edges, reducers, `Send`
+fan-out, interrupts, checkpointers, and a functional API. Locus adds the
+shapes you would otherwise assemble from nodes (orchestrator, swarm, handoff,
+debate), a router that picks the shape from the task, and a control layer
+that runs outside the model. See [StateGraph](multi-agent/graph.md) and
+[Compatibility](../compatibility.md) for the known API differences.
+
+## Coming from Strands Agents
+
+The agent loop, `@tool` and the multi-agent tools map one to one. Locus is
+Oracle-first: OCI Generative AI and Oracle Database 26ai are native
+transports and backends, and the admission gate and GSAR grounding are part
+of the runtime rather than add-ons.
+
+## Coming from plain LangChain
+
+Locus has no LangChain dependency. Its RAG, memory and model layers are its
+own; the Oracle Database 26ai primitives in particular do not go through
+`langchain-oracle`.
 
 ## Where to start
 

diff --git a/docs/index.md b/docs/index.md
@@ -296,20 +296,6 @@ pip install locus-sdk && python -m locus.rogue
 [First controlled action →](how-to/first-controlled-action.md) ·
 [Notebook 71 — Payment refund gate →](notebooks/notebook_71_payment_refund_gate.md)
 
-## How Locus compares
-
-| | Locus | LangGraph | Strands Agents |
-|---|---|---|---|
-| Agent loop with tools | `Agent` + `@tool` | via LangChain | `Agent` + `@tool` |
-| Graphs with state, reducers, interrupts | `StateGraph`, functional API | `StateGraph` | graph tool |
-| Pipelines, orchestrator, swarm, handoff, debate | built in | compose yourself | graph, swarm, workflow |
-| Cognitive router: task to protocol | built in | — | — |
-| Admission gate and signed audit trail | `admit()`, `governed_agent()` | — | — |
-| Grounding of every claim | GSAR | — | — |
-| OCI Generative AI, DAC, Oracle Database 26ai | native | community packages | — |
-
-As documented by each project in October 2026. [Full comparison →](concepts/compare.md)
-
 ## Where next
 
 [All notebooks →](notebooks/index.md) ·

diff --git a/docs/why-locus.md b/docs/why-locus.md
@@ -9,7 +9,7 @@ Locus is the Oracle Generative AI Agentic Harness: one `Agent` class, eight
 multi-agent shapes, and the runtime around the model (tools, memory, RAG,
 observability, guardrails), built first-class for OCI Generative AI and
 Oracle Database 26ai and open to every other provider. The [home page](index.md)
-and [How Locus compares](concepts/compare.md) cover that ground. This page is
+and [Coming from LangGraph or Strands](concepts/compare.md) cover that ground. This page is
 about the part that is easiest to over-claim: what the control layer
 guarantees, what you configure, and what stays model-dependent.
 

diff --git a/mkdocs.yml b/mkdocs.yml
@@ -149,7 +149,7 @@ nav:
     - Agent loop: concepts/agent-loop.md
     - Tools: concepts/tools.md
     - Model providers: concepts/models.md
-    - How Locus compares: concepts/compare.md
+    - Coming from LangGraph or Strands: concepts/compare.md
     - Capabilities: capabilities.md
   - Multi-agent shapes:
     - Overview and the eight protocols: concepts/multi-agent.md