sync from monorepo @ 5408ddc3

README.md

@@ -6,11 +6,34 @@
 
 <p align="center">Core libraries for the Dirigent agent orchestration platform.</p>
 
+> **Under construction.** Dirigent is in active development. Most crates are experimental — APIs will change. There is nothing to install from this repository yet. The standalone tools listed below have their own repositories.
+
 ---
 
-Dirigent is a multi-agent orchestration platform built around the Agent-Client Protocol (ACP). This repository contains the foundational library crates — the building blocks used by downstream tools such as [dirigate](https://git.g4b.org/dirigence/dirigate) and [fermata](https://git.g4b.org/dirigence/fermata).
+## Standalone Tools
 
-> **Downstream mirror.** Active development happens in an upstream monorepo. This repository is an export of the core library crates and is updated on each release. Issues and contributions should be directed to the upstream project.
+These tools are developed in this monorepo but distributed as independent repositories. Install them from their own repos:
+
+| Tool | Repository | Description |
+|------|-----------|-------------|
+| **fermata** | [git.g4b.org/dirigence/fermata](https://git.g4b.org/dirigence/fermata) | Policy gate for AI coding agents — `.botignore` enforcement |
+| **anth** | [git.g4b.org/dirigence/dirigent_anth](https://git.g4b.org/dirigence/dirigent_anth) | Tools for working with Claude Code session data |
+| **dirigate** | [git.g4b.org/dirigence/dirigate](https://git.g4b.org/dirigence/dirigate) | ACP bridge connecting stdio agents to Dirigent |
+
+---
+
+## Architecture
+
+<p align="center">
+  <img src="architecture.svg" alt="Dirigent package architecture" width="720">
+</p>
+
+**Layers top-to-bottom:**
+- **Standalone Tools** — installable from their own repositories; depend on foundation crates
+- **Orchestration** — multi-connector runtime, ACP server, task management, archival
+- **Foundation** — protocol types, tool sandbox, configuration, auth
+- **Integrations** — Matrix, Langfuse, Zed, and other external system connectors
+- **Parsers** — readers for third-party session formats (OpenCode, ChatGPT, Codex)
 
 ---
 
@@ -41,9 +64,7 @@ Dirigent is a multi-agent orchestration platform built around the Agent-Client P
 
 ---
 
-## Usage
-
-### Library crates (via git dependency)
+## Library Usage
 
 Add a crate to your `Cargo.toml`:
 
@@ -53,21 +74,9 @@ dirigent_protocol = { git = "https://git.g4b.org/dirigence/dirigent", path = "cr
 dirigent_core     = { git = "https://git.g4b.org/dirigence/dirigent", path = "crates/dirigent_core" }
 ```
 
-Replace `dirigent_protocol` / `dirigent_core` with the crate you need. All crates follow the same pattern.
+Replace the crate name and path with the one you need. All crates follow the same pattern.
 
-### Binary crates (cargo install)
-
-**fermata** — policy gate CLI and Claude hook adapter:
-
-```bash
-cargo install --git https://git.g4b.org/dirigence/dirigent --features cli
-```
-
-**anth** — Claude Code session inspector:
-
-```bash
-cargo install --git https://git.g4b.org/dirigence/dirigent --bin anth_bear --features dirigent-paths
-```
+> **Expect breakage.** These are internal library crates under active development. Pin to a specific commit if you depend on stability.
 
 ---