diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md new file mode 100644 index 0000000..d3731fb --- /dev/null +++ b/docs/ARCHITECTURE.md @@ -0,0 +1,21 @@ +# Architecture (operator summary) + +Full design: **[design/DESIGN_PLAN.md](../design/DESIGN_PLAN.md)**. + +## Layers + +```text +Host (bootstrap, Docker, product scripts, nemohermes/openshell CLIs) + → OpenShell gateway (credentials, L7 policy, sandbox lifecycle) + → Hermes sandbox (minimal Lumina profile) + skills, channels, MCP clients (allowlisted) + → External OpenAI-compatible model (outside containers OK) +``` + +## Related design docs + +- [Planes](../design/planes.md) +- [Det vs inference](../design/det-vs-inf.md) +- [MCP integrations](../design/mcp-integrations.md) +- [Updates lifecycle](../design/updates-lifecycle.md) +- [Platform research notes](../design/research/platform-notes.md)