Skip to content

Graphs that teach > graphs that impress. Turn any code into an interactive knowledge graph you can explore, search, and ask questions about. Works with Claude Code, Codex, Cursor, Copilot, Gemini CLI, and more.

docs: update CLAUDE.md with current architecture and versioning guide

Lum1104ded60f8116c2
diff --git a/CLAUDE.md b/CLAUDE.md
index e4d48e2c..02ae2999 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -6,34 +6,43 @@ An open-source tool combining LLM intelligence + static analysis to produce inte
## Architecture
- **Monorepo** with pnpm workspaces
- **understand-anything-plugin/** — Claude Code plugin containing all source code:
- - **understand-anything-plugin/packages/core** — Shared analysis engine (types, persistence, tree-sitter plugin, LLM prompt templates)
- - **understand-anything-plugin/packages/dashboard** — React + TypeScript web dashboard (React Flow, Monaco Editor, Zustand, TailwindCSS)
- - **understand-anything-plugin/src** — Skill TypeScript source for `/understand-chat`, `/understand-diff`, `/understand-explain`, `/understand-onboard`
- - **understand-anything-plugin/skills** — Skill definitions
- - **understand-anything-plugin/agents** — Agent definitions
+ - **packages/core** — Shared analysis engine (types, persistence, tree-sitter, search, schema, tours, plugins)
+ - **packages/dashboard** — React + TypeScript web dashboard (React Flow, Zustand, TailwindCSS v4)
+ - **src/** — Skill TypeScript source for `/understand-chat`, `/understand-diff`, `/understand-explain`, `/understand-onboard`
+ - **skills/** — Skill definitions (`/understand`, `/understand-dashboard`, etc.)
+ - **agents/** — Agent definitions (project-scanner, file-analyzer, architecture-analyzer, tour-builder, graph-reviewer)
+
+## Dashboard
+- Dark luxury theme: deep blacks (#0a0a0a), gold/amber accents (#d4a574), DM Serif Display typography
+- Graph-first layout: 75% graph + 360px right sidebar
+- No ChatPanel or Monaco Editor
+- Sidebar: ProjectOverview (default) → NodeInfo (node selected) → LearnPanel (Learn persona)
+- Code viewer: styled summary overlay (slides up from bottom on file node click)
+- Schema validation on graph load with error banner
+
+## Agent Pipeline
+- Agents write intermediate results to `.understand-anything/intermediate/` on disk (not returned to context)
+- Agent models: sonnet for simple tasks (project-scanner, graph-reviewer), opus for complex (file-analyzer, architecture-analyzer, tour-builder)
+- `/understand` auto-triggers `/understand-dashboard` after completion
+- Intermediate files cleaned up after graph assembly
## Key Commands
- `pnpm install` — Install all dependencies
- `pnpm --filter @understand-anything/core build` — Build the core package
- `pnpm --filter @understand-anything/core test` — Run core tests
-- `pnpm dev:dashboard` — Start dashboard dev server
-
-## Key Commands (plugin)
- `pnpm --filter @understand-anything/skill build` — Build the plugin package
- `pnpm --filter @understand-anything/skill test` — Run plugin tests
-
-## Phase 2 Features
-- Fuzzy search via Fuse.js (SearchEngine in core)
-- Zod schema validation on graph loading
-- Staleness detection + incremental graph merging
-- Layer auto-detection (heuristic + LLM prompt)
-- `/understand-chat` skill command
-- Dashboard chat panel (Claude API integration)
-- Dagre auto-layout for graph visualization
-- Layer visualization with grouping and legend
+- `pnpm --filter @understand-anything/dashboard build` — Build the dashboard
+- `pnpm dev:dashboard` — Start dashboard dev server
## Conventions
- TypeScript strict mode everywhere
- Vitest for testing
- ESM modules (`"type": "module"`)
- Knowledge graph JSON lives in `.understand-anything/` directory of analyzed projects
+- Core uses subpath exports (`./search`, `./types`, `./schema`) to avoid pulling Node.js modules into browser
+
+## Versioning
+When pushing to remote, bump the version in **both** of these files (keep them in sync):
+- `understand-anything-plugin/package.json` → `"version"` field
+- `.claude-plugin/marketplace.json` → `plugins[0].version` field