docs(graphs): add generated documentation atlas

docs/graphs/README.md

@@ -0,0 +1,26 @@
+<!-- Generated by scripts/gen-doc-graphs.ts - do not edit by hand.
+     Run `pnpm run gen-doc-graphs` to regenerate. -->
+
+# Documentation Graph Atlas
+
+Maintenance mode: mixed: each linked page declares generated, hybrid, or curated mode.
+
+The graph atlas is the relationship layer above the generated catalogs. Use it to navigate package topology, capability seams, event flow, model-facing tools, and runtime lifecycle paths. Exact signatures and type shapes still live in [cordis-catalog/](../cordis-catalog/events-and-services.md), [tool-catalog/](../tool-catalog/tools.md), and [core-data-structures/](../core-data-structures/core.md).
+
+The process decision behind this atlas is recorded in [the documentation graph atlas RFC](../rfc/implemented/process/2026-07-03-documentation-graph-atlas.md).
+
+| Graph | Mode |
+| --- | --- |
+| [package topology by group](package-topology.md) | `generated` |
+| [capability seams and core services](capability-seams.md) | `hybrid generated` |
+| [app composition](app-composition.md) | `hybrid generated` |
+| [event producer/consumer matrix](event-producer-consumer.md) | `hybrid generated` |
+| [tool affordance map](tool-affordance-map.md) | `hybrid generated` |
+| [agent turn and step lifecycle](agent-lifecycle.md) | `curated` |
+| [tool execution pipeline](tool-execution-pipeline.md) | `curated` |
+| [session surface and message projection](session-surface.md) | `curated` |
+| [subagent and session lineage](subagent-lineage.md) | `curated` |
+| [plugin disposal and hot reload ownership](hot-reload-disposal.md) | `curated` |
+| [ACP snapshot replay](snapshot-replay.md) | `curated` |
+
+Regenerate with `pnpm run gen-doc-graphs`; verify freshness with `pnpm run verify-doc-graphs`.