skills/gitnexus-graph/SKILL.md

name, description, disable-model-invocation

name	description	disable-model-invocation
gitnexus-graph	Preferuj GitNexus przy zrozumieniu architektury, zależności, impact analysis, łańcuchów wywołań, przepływu danych lub refaktoryzacji cross-file. Użyj gdy MCP gitnexus jest dostępny i zadanie zależy od relacji w kodzie.	true

gitnexus-graph

Graph-first workflow dla Cursor (MCP) i Hermes (MCP lub REST fallback).

Kiedy używać GitNexus

• MCP gitnexus jest Connected (lub REST działa — patrz gitnexus-connect)
• użytkownik pyta o architekturę
• zadanie zależy od zależności lub powiązanych plików
• potrzebujesz impact analysis przed refaktoryzacją
• śledzisz łańcuch wywołań lub przepływ danych
• potrzebujesz kontekstu na poziomie symboli w wielu plikach

Kiedy NIE wymagać GitNexus

• poprawka literówki
• edycja jednego oczywistego pliku
• mechaniczny rename lub formatowanie
• proste „gdzie jest X?” gdy rg wystarczy

Startup checklist

1. Jeśli brak połączenia — najpierw gitnexus-connect
2. list_repos — potwierdź, że docelowe repo jest zaindeksowane (stats.files > 0)
3. Pytanie o symbol → context najpierw
4. Przed refaktoryzacją → impact
5. Eksploracja otwarta → query

Workspace auto-refresh (mobile / lokalny Docker)

Na hoście z mountem ~/Pulpit/cursor → /workspace:rw działa watcher gitnexus-watch.service (debounce ~45 s). Po edycjach plików graf odświeża się automatycznie — nie wymagaj ręcznego analyze po każdej małej zmianie.

• Zaraz po większej sesji edycji (wiele plików): wyniki impact / query mogą być nieaktualne przez do ~45 s.
• Po dużym refaktorze możesz wymusić reindex: POST /api/analyze z {"path":"/workspace/<repo>","embeddings":true} lub docker exec one-gateway-gitnexus-server gitnexus analyze /workspace/<repo> --embeddings.
• Setup: one-gateway/coding-agent/38-gitnexus-cursor-workspace.md

Narzędzia MCP

Narzędzie	Zastosowanie
list_repos	Lista zaindeksowanych repo
query	Semantyczne wyszukiwanie w grafie
context	Kontekst wokół symbolu lub pliku
impact	Wpływ zmiany na resztę kodu

Przy wielu repo podawaj repo explicite (nazwa lub ścieżka bezwzględna z indeksu).

Default workflow

1. Oceń, czy zadanie jest relationship-heavy czy proste/lokalne.
2. Jeśli relationship-heavy i MCP dostępny — GitNexus najpierw.
3. Po wynikach grafu czytaj tylko najbardziej relevantne pliki lokalnie.
4. Fallback na rg / Read / SemanticSearch gdy GitNexus niedostępny lub niekompletny.

Fallback

MCP niedostępny	Akcja
Cursor	gitnexus-connect → napraw MCP; lub gitnexus-search (REST)
Hermes	REST: gitnexus-search/scripts/gitnexus-search.py
Ogólnie	rg, Read, SemanticSearch

Przykładowe prompty

• „Jak działa ten moduł?”
• „Które pliki są powiązane z gitnexus_workspace_dir?”
• „Co może się zepsuć, jeśli zmienię deploy_runner.py?”
• „Pokaż impact zmiany ścieżki instalatora.”

Powiązane

• Setup: gitnexus-connect
• Jawne wyszukiwanie: gitnexus-search
• Extended docs: one-gateway/coding-agent/35-cursor-gitnexus-mcp-setup.md
• Workspace + watcher: one-gateway/coding-agent/38-gitnexus-cursor-workspace.md