From a886a7b9330302ff041946eaa382cf705460defa Mon Sep 17 00:00:00 2001 From: Aditya <82406617+adigo-pro@users.noreply.github.com> Date: Sun, 2 Aug 2026 12:04:55 -0500 Subject: [PATCH] README: point contributors at the checked-in knowledge graph Co-Authored-By: Claude Fable 5 Claude-Session: https://claude.ai/code/session_01A2CMGoziPn6h1vK94rSLeJ --- README.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/README.md b/README.md index a496ee9..92738de 100644 --- a/README.md +++ b/README.md @@ -280,6 +280,17 @@ Good first issues: redaction patterns, frozen eval cases, adapters for other coding agents (the observer only needs an intent stream; the hooks only need an injection channel). +**Want to understand the codebase fast?** A checked-in structural map lives +at [`.ua/knowledge-graph.json`](.ua/knowledge-graph.json): 554 nodes (files, +classes, functions), 1,239 edges (imports, calls, `tested_by`), 10 +architectural layers, and a 14-step guided tour that walks +observer → critic → hooks → reflector in data-flow order. With the +[Understand-Anything](https://github.com/Egonex-AI/Understand-Anything) +plugin installed, `/understand-dashboard` opens it as an interactive graph; +without it, the JSON reads plainly (`project`, `nodes`, `edges`, `layers`, +`tour`). It's a commit-pinned snapshot (`.ua/meta.json` says which), not a +live view — see CONTRIBUTING.md's "Architecture map". + **Are you an AI coding agent?** Read [AGENTS.md](AGENTS.md) — a contribution guide written for you, not a human. And a fitting twist for a tool built for agents: while you work in this repo, CodeCouncil reviews *you* in real time