Understand

/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.