From 04d40549a3594a614c473d56ecc896953dac0fcd Mon Sep 17 00:00:00 2001 From: Federico Kamelhar Date: Tue, 27 Oct 2026 17:55:02 -0400 Subject: [PATCH] docs: remove the 'Coming from LangGraph or Strands' page and the last framework name-drops The orientation page was the remnant of the comparison table removed in #367; the site now describes Locus on its own terms. Its nav entry and the Why Locus link go with it, and the few remaining descriptors that leaned on other frameworks ("LangGraph-style" on the StateGraph card and README row, "no LangChain layer" on the 26ai page, the LangChain / CrewAI line under the admission gate) are reworded. docs/compatibility.md, which documents concrete StateGraph API differences, is unchanged. Signed-off-by: Federico Kamelhar --- README.md | 4 ++-- docs/concepts/compare.md | 39 ------------------------------------ docs/concepts/oracle-26ai.md | 2 +- docs/index.md | 2 +- docs/why-locus.md | 2 +- mkdocs.yml | 1 - 6 files changed, 5 insertions(+), 45 deletions(-) delete mode 100644 docs/concepts/compare.md diff --git a/README.md b/README.md index 7610f065..db6bcac1 100644 --- a/README.md +++ b/README.md @@ -73,7 +73,7 @@ Pick the shape; the agents don't change. | **Orchestrator and specialists** | One coordinator delegates to typed specialists with their own tools and merges the results | [Orchestrator](https://locusagents.ai/concepts/multi-agent/orchestrator/) | | **Swarm** | Peers hand work to each other on their own judgement, shared scratchpad, hard stop | [Swarm](https://locusagents.ai/concepts/multi-agent/swarm/) | | **Handoff** | Tiered escalation with typed context, L1 to L2 to L3 | [Handoff](https://locusagents.ai/concepts/multi-agent/handoff/) | -| **StateGraph and functional API** | Nodes, edges, reducers, `Send` fan-out, interrupts, checkpointed state, LangGraph-style | [StateGraph](https://locusagents.ai/concepts/multi-agent/graph/) | +| **StateGraph and functional API** | Nodes, edges, reducers, `Send` fan-out, interrupts, checkpointed state | [StateGraph](https://locusagents.ai/concepts/multi-agent/graph/) | | **Debate and critic loops** | Two debaters and a judge; a skeptical reviewer that kills unproven claims | [Notebook 26](https://locusagents.ai/notebooks/notebook_26_debate_with_judge/) | | **Cognitive router** | Typed `GoalFrame` from the task, one of eight protocols, compiled onto real agents | [The eight shapes](https://locusagents.ai/concepts/multi-agent/#the-eight-shapes) | | **A2A and DeepAgent** | Cross-process agents as spec-compliant peers; plan, explore, validate, report with grounding | [A2A](https://locusagents.ai/concepts/multi-agent/a2a/) · [DeepAgent](https://locusagents.ai/concepts/deepagent/) | @@ -185,7 +185,7 @@ pip install locus-sdk && python -m locus.rogue # FINAL SCORE · dangerous attempts: 1 · BREACHES: 0 · audit chain intact: ✓ ``` -Put the same gate around a LangChain chain, a plain OpenAI loop or a CrewAI crew, or build on the +Put the same gate around an agent loop you already have, whatever it is built on, or build on the full runtime. → [How the admission gate works](https://locusagents.ai/concepts/control-layer/) · diff --git a/docs/concepts/compare.md b/docs/concepts/compare.md deleted file mode 100644 index 4e68282c..00000000 --- a/docs/concepts/compare.md +++ /dev/null @@ -1,39 +0,0 @@ ---- -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." ---- - -# Coming from LangGraph or Strands - -Locus is an agent harness: the agent loop, the ways to combine agents, and the -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 - -- [Multi-agent shapes](multi-agent.md) for the eight protocols and the router. -- [The Agent](agent.md) and [Tools](tools.md) for the loop. -- [Control-layer architecture](control-layer.md) for the admission gate. -- [OCI Generative AI](providers/oci.md) and [OCI GenAI models](../how-to/oci-models.md) for transports and model support. diff --git a/docs/concepts/oracle-26ai.md b/docs/concepts/oracle-26ai.md index 80e5d058..ed1f563b 100644 --- a/docs/concepts/oracle-26ai.md +++ b/docs/concepts/oracle-26ai.md @@ -8,7 +8,7 @@ description: "Every Oracle Database 26ai primitive in Locus — vector search, i Locus treats Oracle Database 26ai as the place where an agent's state lives: vectors for retrieval, threads for continuity, memories for what it has learned, in the same database as the data it acts on. Each primitive is a -first-class Locus class on the `oracledb` driver, with no LangChain layer in +first-class Locus class on the `oracledb` driver, with no adapter layer in between, and it works with the same `Agent` as everything else. ```bash diff --git a/docs/index.md b/docs/index.md index 858a40c2..dbac9435 100644 --- a/docs/index.md +++ b/docs/index.md @@ -118,7 +118,7 @@ the same backends. Pick the shape; the agents don't change. --- Nodes, edges, reducers, `Send` fan-out, interrupts for a human, and - checkpointed state, LangGraph-style. + checkpointed state. - :material-forum:{ .lg .middle } **[Debate and critic loops](notebooks/notebook_26_debate_with_judge.md)** diff --git a/docs/why-locus.md b/docs/why-locus.md index 8f2957a1..610baf3a 100644 --- 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 [Coming from LangGraph or Strands](concepts/compare.md) cover that ground. This page is +covers 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 index 02393770..21d13124 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -149,7 +149,6 @@ nav: - Agent loop: concepts/agent-loop.md - Tools: concepts/tools.md - Model providers: concepts/models.md - - Coming from LangGraph or Strands: concepts/compare.md - Capabilities: capabilities.md - Multi-agent shapes: - Overview and the eight protocols: concepts/multi-agent.md