continuity-ledger

Continuity Ledger to umiejętność do tworzenia i aktualizacji dokumentów handoff w formacie YAML, które przechowują stan pracy między wyczyszczeniami sesji. Narzędzie automatycznie organizuje pliki w strukturze folderów thoughts/shared/handoffs/, używając nazwy sesji, daty i czasu. Każdy dokument zawiera metadane sesji, opis celu, listę wykonanych zadań z powiązanymi plikami oraz instrukcje testowania. Idealne dla długotrwałych projektów, gdzie musisz szybko przywrócić kontekst po wznowieniu pracy.

1. Zainstaluj umiejętność w swoim katalogu .claude/skills/ — skopiuj folder continuity_ledger z repozytorium parcadei.

2. Przed pierwszym użyciem sprawdź, czy istnieją już handoffy w thoughts/shared/handoffs/ — uruchom polecenie ls -td thoughts/shared/handoffs/*/ 2>/dev/null | head -1 | xargs basename, aby znaleźć nazwę ostatnio modyfikowanej sesji. Jeśli żadne handoffy nie istnieją, użyjesz nazwy general.

3. Gdy zakończysz pracę nad zadaniem lub przed wyczyszczeniem sesji, użyj komendy /create_handoff (continuity-ledger jest jej aliasem). Umiejętność poprosi Cię o opis pracy, którą wykonałeś.

4. Plik YAML zostanie automatycznie utworzony w ścieżce thoughts/shared/handoffs/{nazwa-sesji}/YYYY-MM-DD_HH-MM_opis.yaml. Upewnij się, że wypełniasz wymagane pola: goal (cel sesji), now (co robić dalej), test (polecenie weryfikacyjne) oraz listę done_this_session z zadaniami i powiązanymi plikami.

5. Zachowaj dokładny format YAML — nazwy pól muszą być dokładnie takie, jak w szablonie (zwłaszcza goal i now, które pojawiają się w linii statusu). Każde zadanie powinno zawierać opis i listę zmodyfikowanych plików.

6. Przed wznowieniem sesji przeczytaj ostatni handoff z folderu sesji — zawiera on wszystkie informacje potrzebne do szybkiego powrotu do pracy.