claudemd-maintainer

Skill pomagający pisać i ulepszać pliki CLAUDE.md – dokumentację projektów dla modeli językowych. Aktywuje się automatycznie podczas edycji takich plików i podpowiada, co warto uwzględnić (technologie, kluczowe zasady, komendy), a czego unikać (długie listy zależności, przestarzałe fragmenty kodu). Zapewnia, że instrukcje pozostają zwięzłe, przejrzyste i rzeczywiście przydatne dla AI.

1. Zainstaluj skill w swoim projekcie lub włącz go w konfiguracji Claude – będzie się automatycznie aktywować, gdy otworzysz lub edytujesz plik CLAUDE.md. 2. Podczas pisania lub modyfikacji CLAUDE.md zwróć uwagę na sugestie: skill podpowiada, które sekcje są najważniejsze (stos technologiczny, kluczowe zasady, szybkie komendy) i jakie treści lepiej pominąć (szczegółowe listy zależności, wbudowany kod, instrukcje specyficzne dla zadań). 3. Pamiętaj o limicie około 150–200 linii – badania pokazują, że modele językowe niezawodnie przetwarzają instrukcje do tej długości; powyżej tego progu jakość spada. 4. Zamiast wstawiać fragmenty kodu, odwołuj się do ścieżek plików (np. src/main.swift:42) – referencje pozostają aktualne, a wbudowany kod szybko się dezaktualizuje. 5. Dokumentuj rzeczywiste błędy i pułapki, które napotkałeś w projekcie, zamiast teoretycznych ostrzeżeń – to zwiększa praktyczną wartość pliku. 6. Regularnie przegladaj CLAUDE.md pod kątem duplikatów reguł i treści, które straciły na znaczeniu, aby plik pozostał zwięzły i skoncentrowany.