| name | understand |
| description | Analyze a codebase to produce an interactive knowledge graph for understanding architecture, components, and relationships |
/understand
Analyze the current codebase and produce a knowledge-graph.json file in .understand-anything/. This file powers the interactive dashboard for exploring the project's architecture.
Options
$ARGUMENTS may contain:
--full — Force a full rebuild, ignoring any existing graph--mode coremind — Use CoreMind specific layer patterns and 10-stage pipeline tour (default for CoreMind)--mode claude — Analyze the Claude Code setup (~/.claude/) instead of a project--mode generic — Use generic layer detection for any project- A directory path — Analyze a specific project directory
Instructions
Run the coremind_understand Python engine:
cd ~/.claude/tools && python3 -m coremind_understand <project_root> [options from $ARGUMENTS]
Default behavior:
- If current directory is CoreMind (contains
src/coremind/): uses --mode coremind
- If
$ARGUMENTS contains claude or setup: uses --mode claude with ~/.claude as target
- Otherwise: uses
--mode generic
After the analysis completes, automatically run /understand-dashboard to launch the visualization.
What it produces
.understand-anything/knowledge-graph.json — The graph (nodes, edges, layers, tour).understand-anything/meta.json — Analysis metadata (commit hash, timestamp)
Schema compliance
The engine produces output that passes the Understand-Anything Zod schema validation with zero errors. All nodes have valid type (file|function|class|module|concept), complexity (simple|moderate|complex), and all edges have direction and weight fields.
Incremental updates
If a graph already exists and the git commit hash hasn't changed, the engine reports "up to date" and exits. Use --full to force a complete re-analysis.
