understandcommit 08d16bdSKILL.md · Architecture Tuning
Understand: Codebase Knowledge Graph
Analyzes a codebase into knowledge-graph.json under .ua/, with files, symbols, edges, layers and a guided tour for an interactive dashboard.
The first run executes pnpm install and a build in the plugin directory, and large codebases dispatch many sub-agents and take a long time.
npx skills add Egonex-AI/Understand-Anything --skill understandCommand selected. Copy it manually.
- Permissions
- read-repo
- write-files
- shell
- network
- Compatible with
- Claude Code, Codex, Cursor, Copilot, Gemini CLI
- GitHub
- 89.5k
- Source
- Community · Egonex-AI
- Status
- Scan passed
- License
- MIT
- Category
- Architecture Tuning
Core rule
Never silently drop errors; every failure must be visible in the final report.
Execution Phases
Phase 01Pre-flight
Resolve the project root and .ua/ data dir, build the plugin if needed, and choose full or incremental analysis from the existing graph.
Phase 02Scan and batch
Scan files under .understandignore and --exclude rules, detect languages and frameworks, then compute semantic batches.
Phase 03Analyze files
Up to five sub-agents analyze batches in parallel; results merge into nodes and edges and the assembled graph is reviewed.
Phase 04Layers and tour
Identify architectural layers, build a guided tour, then validate the whole graph.
Phase 05Save and report
Save the graph, fingerprint baseline and meta.json, clean up intermediates and report stats; launch the dashboard if validation passed.
Permissions (summarised from SKILL.md)
| Capability | Needed | Details |
|---|---|---|
| File writes | Limited | Writes the graph, config and intermediate files only inside the project's .ua/ (or legacy .understand-anything/) directory; source is not modified. |
| Command execution | Required | Runs git, bundled Node and Python scripts, and pnpm install plus a build on first use. |
| Network outbound | Limited | Only pnpm install fetches dependencies when the plugin is not yet built; the analysis itself does not use the network. |
SKILL.md frontmatter (YAML)
---
name: understand
description: Analyze a codebase to produce an interactive knowledge graph for understanding architecture, components, and relationships
argument-hint: ["[path] [--full|--auto-update|--no-auto-update|--review|--language <lang>|--exclude <patterns>]"]
---