claude-md-progressive-disclosurer
Optimize CLAUDE.md files using progressive disclosure.\nGoal: Maximize LLM working efficiency, NOT minimize line count.\nUse when: User wants to optimize CLAUDE.md, complains about context issues, or file exceeds 500 lines.
Installation
Pick a client and clone the repository into its skills directory.
Installation
About this skill
Optimize CLAUDE.md files using progressive disclosure.\nGoal: Maximize LLM working efficiency, NOT minimize line count.\nUse when: User wants to optimize CLAUDE.md, complains about context issues, or file exceeds 500 lines.
How to use
Utwórz kopię zapasową swojego CLAUDE.md, uruchamiając polecenie backup opisane w dokumentacji — to zabezpieczy Cię przed przypadkową utratą danych.
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).
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.
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).
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.