agentlens

AgentLens to umiejętność do eksploracji dużych repozytoriów kodu bez czytania plików źródłowych. Zamiast zagłębiać się w kod, korzystasz z hierarchicznej dokumentacji: przegląd projektu, mapy modułów, indeksy symboli i listy TODO. Idealne gdy wchodzisz do nowego projektu, szukasz konkretnej funkcji w dużym pliku lub chcesz zrozumieć zależności między modułami.

1. Zainstaluj umiejętność agentlens w swoim środowisku agenta (szczegóły instalacji zależą od Twojej platformy agenta).

2. Przed pracą z jakimkolwiek projektem otwórz plik .agentlens/INDEX.md – zawiera przegląd całego projektu i listę wszystkich modułów. To Twój punkt wyjścia do nawigacji.

3. Gdy szukasz konkretnego modułu, przeszukaj INDEX.md po nazwie. Następnie otwórz modules/{nazwa-modułu}/MODULE.md, aby zobaczyć szczegóły i listę plików w module.

4. Jeśli chcesz znaleźć funkcję lub klasę w dużym pliku, zamiast czytać cały kod, otwórz modules/{nazwa-modułu}/outline.md – zawiera indeks symboli. Gdy znasz lokalizację symbolu, przejdź do konkretnego fragmentu kodu.

5. Przed modyfikacją kodu przeczytaj modules/{nazwa-modułu}/memory.md, gdzie znajdują się ostrzeżenia, TODO i reguły biznesowe dotyczące modułu.

6. Jeśli dokumentacja wydaje się nieaktualna, uruchom polecenie agentlens w repozytorium, aby regenerować pliki dokumentacji.