gitnexus-guide

SKILL.md

GitNexus Guide

Quick reference for all GitNexus MCP tools, resources, and the knowledge graph schema.

Always Start Here

For any task involving code understanding, debugging, impact analysis, or refactoring:

Read gitnexus://repo/{name}/context — codebase overview + check index freshness

Match your task to a skill below and read that skill file

Follow the skill's workflow and checklist

If step 1 warns the index is stale, run npx gitnexus analyze in the terminal first.

Skills

Task
Skill to read

Understand architecture / "How does X work?"
gitnexus-exploring

Blast radius / "What breaks if I change X?"
gitnexus-impact-analysis

Trace bugs / "Why is X failing?"
gitnexus-debugging

Rename / extract / split / refactor
gitnexus-refactoring

Tools, resources, schema reference
gitnexus-guide (this file)

Index, status, clean, wiki CLI commands
gitnexus-cli

Tools Reference

Tool
What it gives you

query
Process-grouped code intelligence — execution flows related to a concept

context
360-degree symbol view — categorized refs, processes it participates in

impact
Symbol blast radius — what breaks at depth 1/2/3 with confidence

detect_changes
Git-diff impact — what do your current changes affect

rename
Multi-file coordinated rename with confidence-tagged edits

cypher
Raw graph queries (read gitnexus://repo/{name}/schema first)

list_repos
Discover indexed repos

Resources Reference

Lightweight reads (~100-500 tokens) for navigation:

Resource
Content

gitnexus://repo/{name}/context
Stats, staleness check

gitnexus://repo/{name}/clusters
All functional areas with cohesion scores

gitnexus://repo/{name}/cluster/{clusterName}
Area members

gitnexus://repo/{name}/processes
All execution flows

gitnexus://repo/{name}/process/{processName}
Step-by-step trace

gitnexus://repo/{name}/schema
Graph schema for Cypher

Graph Schema

Nodes: File, Function, Class, Interface, Method, Community, Process
Edges (via CodeRelation.type): CALLS, IMPORTS, EXTENDS, IMPLEMENTS, DEFINES, MEMBER_OF, STEP_IN_PROCESS

MATCH (caller)-[:CodeRelation {type: 'CALLS'}]->(f:Function {name: "myFunc"})
RETURN caller.name, caller.filePath