understand

Analyze a codebase to generate an interactive knowledge graph of architecture and components.

Updated Aug 26, 2026
One-click install
npx skills add https://github.com/danieliudi/trackforge-os --skill understand-danieliudi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: understand
Source: https://github.com/danieliudi/trackforge-os/tree/main/.cursor/skills/understand
Command: npx skills add https://github.com/danieliudi/trackforge-os --skill understand-danieliudi

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires graphology, graphology-communities-louvain, @understand-anything/core, and includes scripts (resource) components.

What problem does it solve? Understanding an unfamiliar or large codebase requires reading hundreds of files manually. This Skill automates that by scanning the project, analyzing files in semantic batches, and producing a knowledge-graph.json that powers an interactive dashboard for exploring architecture, components, and their relationships. ## Core Features & Use Cases - Full and incremental analysis: Runs a complete 7-phase pipeline on first use, then performs deterministic incremental updates on subsequent commits, re-analyzing only structurally changed files. - Semantic batching with Louvain community detection: Groups files by import-graph modularity so related modules are analyzed together, with cross-batch neighbor maps preserving edge confidence. - Multi-language import resolution: Deterministically resolves imports for TypeScript/JavaScript (including tsconfig path aliases and NodeNext ESM), Go modules, PHP autoloads, Swift packages, Java, Kotlin, Scala, and C#. - Use Case: Point it at a newly inherited monorepo and get an interactive graph showing every module, its exported symbols, dependencies, and test coverage edges, with multilingual summaries generated in your preferred language. ## Quick Start Ask the AI to run /understand on the current project directory to build the architecture knowledge graph.

Frequently Asked Questions about understand

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a knowledge graph of my codebase architecture?

Run the /understand command on your project root. It scans all files, batches them by import-graph communities, analyzes each batch, and writes a knowledge-graph.json into the .ua directory that powers an interactive dashboard.

How do I update the code knowledge graph after new commits?

Re-run /understand and it performs an incremental update automatically. A reconciliation helper diffs against the last analyzed commit, re-analyzes only structurally changed files, and merges results without reprocessing unchanged code.

Which programming languages does codebase analysis support?

Import resolution covers TypeScript, JavaScript, Go, PHP, Swift, Java, Kotlin, Scala, and C#, using tree-sitter grammars plus tsconfig path aliases, go.mod modules, composer autoloads, and SwiftPM targets for accurate cross-file edges.

Can I exclude test files or docs from codebase analysis?

Yes. Pass --exclude with comma-separated glob patterns, or edit the generated .understandignore file in the .ua directory. Exclusion patterns take highest priority and support gitignore syntax including negation.

Why does the knowledge graph miss edges in my TypeScript ESM project?

NodeNext-style imports reference compiled extensions like ./foo.js while only ./foo.ts exists on disk. The resolver rewrites compiled-output extensions to their source equivalents, so ensure the source files are included in the scan.