# Understand

> Understand

- Skill: `kmshihab7878/understand` (Agent Skill, multi-file: 6 files)
- Install (CLI): `npx skillmds@latest add kmshihab7878/understand`
- Raw SKILL.md: https://api.skillmd.com/api/skills/kmshihab7878/understand/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: kmshihab7878 (https://skillmd.com/u/kmshihab7878)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/kmshihab7878/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:

```bash
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.