claude-md-progressive-disclosurer

Umiejętność do reorganizacji plików CLAUDE.md przy użyciu progresywnego ujawniania informacji. Zamiast zmniejszać liczbę linii, skupiasz się na maksymalizacji efektywności informacyjnej — eliminujesz duplikaty, organizujesz treść w dwie warstwy (Level 1 do codziennego ładowania, Level 2 na żądanie) i tworzysz wiele punktów wejścia do dokumentacji. Idealna, gdy plik przekracza 500 linii, informacje się powtarzają lub model ma problemy z przestrzeganiem reguł.

1. Utwórz kopię zapasową swojego CLAUDE.md, uruchamiając polecenie backup opisane w dokumentacji — to zabezpieczy Cię przed przypadkową utratą danych.

2. Przeanalizuj zawartość CLAUDE.md i zaklasyfikuj każdą sekcję: zaznacz, które informacje są używane często (Level 1 — zostają w głównym pliku), które mają poważne konsekwencje przy naruszeniu (Level 1), które zawierają gotowe wzorce kodu (Level 1), a które są szczegółowymi procedurami lub materiałami historycznymi (Level 2 — przenosisz do osobnych plików).

3. Utwórz katalog docs/references/ i przenieś zawartość Level 2 do osobnych plików o nazwie {temat}-sop.md — ważne: przenoś treść w całości, bez zmniejszania czy "optymalizowania" jej podczas przenoszenia.

4. W głównym CLAUDE.md dodaj trzy punkty wejścia do dokumentacji: indeks referencji na początku (dla użytkownika szukającego rozwiązania problemu), sekcję "Przeczytaj przed zmianą kodu" w środku (dla kogoś przystępującego do edycji) oraz indeks wyzwalający na końcu (do lokalizacji dokumentów w długich rozmowach).

5. Pamiętaj o kluczowej zasadzie: liczba linii nie jest miernikiem sukcesu — optymalizacja polega na eliminacji duplikatów, poprawie czytelności i łatwości utrzymania, a nie na skróceniu pliku. Struktura powinna być jasna, a każda informacja powinna istnieć w jednym miejscu.