gitnexus-exploring

Explores indexed codebases to trace execution flows and explain how code works.

3|5|Updated Apr 26, 2026
One-click install
npx skills add https://github.com/BenSheridanEdwards/ArchitectPlaybook --skill gitnexus-exploring-bensheridanedwards
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gitnexus-exploring
Source: https://github.com/BenSheridanEdwards/ArchitectPlaybook/tree/main/.claude/skills/gitnexus/gitnexus-exploring
Command: npx skills add https://github.com/BenSheridanEdwards/ArchitectPlaybook --skill gitnexus-exploring-bensheridanedwards

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Understanding an unfamiliar codebase is slow when you have to grep through files manually. This Skill answers questions like "How does authentication work?" or "What calls this function?" by querying a GitNexus code index for execution flows, symbol relationships, and functional clusters. ## Core Features & Use Cases - Execution Flow Discovery: Query the index for processes (e.g., CheckoutFlow, LoginFlow) related to a concept and read step-by-step execution traces. - Symbol Context: Get a 360-degree view of any symbol, including incoming calls, outgoing calls, and the processes it participates in. - Codebase Overview: Read repository context resources for stats, functional clusters with cohesion scores, and staleness warnings. - Use Case: You join a project and need to understand payment processing. Query for "payment processing", inspect the CheckoutFlow trace, then drill into processPayment to see its callers and callees before reading the source file. ## Quick Start Ask the assistant to explain how a specific feature works in this repository, such as "How does the authentication flow work?"

Frequently Asked Questions about gitnexus-exploring

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

FAQPage Schema
How do I find out how a feature works in an unfamiliar codebase?

Query the GitNexus index with a search term describing the feature, such as "payment processing". The query returns related execution flows and symbols, which you can then inspect with the context tool and trace step by step via the process resource.

How do I find what calls a specific function?

Use the context tool with the symbol name, for example context({name: "validateUser"}). It returns incoming calls, outgoing calls, and the execution processes the symbol participates in, along with file locations.

What does it mean when the GitNexus index is stale?

A stale index means the indexed symbols no longer match the current source code. The repo context resource reports this warning, and you fix it by running node .gitnexus/run.cjs analyze in the terminal to rebuild the index.

Can I explore a repository that has not been indexed?

No. The workflow depends on GitNexus resources like gitnexus://repo/{name}/context, so the repository must be indexed first. Run the analyze command to build the index before querying execution flows or symbols.

What is the difference between the query and context tools?

query finds execution flows related to a concept using a search string, returning processes and grouped symbols. context gives a 360-degree view of one named symbol, listing its callers, callees, and the processes it appears in.