understand-chat

Answers codebase questions by querying a JSON knowledge graph of nodes and edges.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Navigating an unfamiliar codebase to answer architecture or dependency questions is slow when you must read files one by one. This Skill answers questions about the codebase by querying a pre-built knowledge graph, so you get targeted answers grounded in actual files, functions, and relationships without dumping the whole project into context. ## Core Features & Use Cases - Graph-Based Q&A: Searches node names, summaries, and tags in the knowledge graph JSON to find code entities matching your query, then follows edges (imports, calls, depends_on) to build a 1-hop subgraph around them. - Freshness Validation: Compares the graph's recorded git commit against HEAD and checks committed and working-tree diffs, warning you when the graph may be stale and suggesting a refresh. - Layer-Aware Answers: Uses architectural layer metadata to explain which parts of the system are relevant and why, linking concepts to concrete file paths. - Use Case: Ask "which modules depend on the billing service?" and get an answer traced through import and call edges, with exact file locations, instead of grepping the entire repository manually. ## Quick Start Ask a question about the codebase, such as "how does the authentication flow connect to the API layer?", and the Skill will query the knowledge graph and answer with specific files and relationships.

Frequently Asked Questions about understand-chat

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

FAQPage Schema
How do I ask questions about a codebase using a knowledge graph?

Run the understand-chat command with your query as the argument. The Skill greps the knowledge-graph.json for matching node names, summaries, and tags, then follows import and call edges to answer with specific files and relationships.

What is a code knowledge graph and how is it structured?

It is a JSON file with project metadata, typed nodes (file, function, class, module, endpoint, and more), typed edges (imports, calls, depends_on, documents), architectural layers, and an optional guided tour. Node IDs are prefixed by type, such as file:path or function:path:name.

What happens if the knowledge graph file does not exist?

The Skill checks for knowledge-graph.json in the .ua directory (or legacy .understand-anything directory) first. If it is missing, it tells you to run the /understand command to generate the graph before asking questions.

How does the Skill detect an outdated knowledge graph?

It compares the graph's stored gitCommitHash against the current HEAD and inspects committed, staged, and unstaged diffs scoped to the project. If project files changed since graph generation, it warns that answers may omit those changes and suggests refreshing.

Can I use this in a monorepo with multiple projects?

Yes. The staleness check uses a project-scoped pathspec, so commits touching only sibling projects do not mark the graph stale. A hash mismatch alone is ignored when the project diff is empty.