mirror of
https://github.com/abhigyanpatwari/GitNexus.git
synced 2026-09-06 08:16:02 +00:00
0e8eed4a8a
Keep main's stats line (GitnexusV2, 1348 symbols) with PR's skill path renames. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
62 lines
No EOL
2.6 KiB
Markdown
62 lines
No EOL
2.6 KiB
Markdown
<!-- gitnexus:start -->
|
|
# GitNexus MCP
|
|
|
|
This project is indexed by GitNexus as **GitnexusV2** (1348 symbols, 3469 relationships, 104 execution flows).
|
|
|
|
GitNexus provides a knowledge graph over this codebase — call chains, blast radius, execution flows, and semantic search.
|
|
|
|
## Always Start Here
|
|
|
|
For any task involving code understanding, debugging, impact analysis, or refactoring, you must:
|
|
|
|
1. **Read `gitnexus://repo/{name}/context`** — codebase overview + check index freshness
|
|
2. **Match your task to a skill below** and **read that skill file**
|
|
3. **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 | Read this skill file |
|
|
|------|---------------------|
|
|
| Understand architecture / "How does X work?" | `.claude/skills/gitnexus/gitnexus-exploring/SKILL.md` |
|
|
| Blast radius / "What breaks if I change X?" | `.claude/skills/gitnexus/gitnexus-impact-analysis/SKILL.md` |
|
|
| Trace bugs / "Why is X failing?" | `.claude/skills/gitnexus/gitnexus-debugging/SKILL.md` |
|
|
| Rename / extract / split / refactor | `.claude/skills/gitnexus/gitnexus-refactoring/SKILL.md` |
|
|
|
|
## 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
|
|
|
|
```cypher
|
|
MATCH (caller)-[:CodeRelation {type: 'CALLS'}]->(f:Function {name: "myFunc"})
|
|
RETURN caller.name, caller.filePath
|
|
```
|
|
|
|
<!-- gitnexus:end --> |