sparv

Minimal SPARV workflow (Specify→Plan→Act→Review→Vault) with 10-point spec gate, unified journal, 2-action saves, 3-failure protocol, and EHRB risk detection.

1. Zainstaluj skill SPARV w swoim środowisku Claude/Codex/Copilot, klonując repozytorium z gałęzi master (folder skills/sparv).

2. Przygotuj strukturę katalogów: utwórz folder .sparv/ w katalogu projektu, w którym będą przechowywane pliki stanu (state.yaml), dziennika (journal.md) i bazy wiedzy (kb.md).

3. Rozpocznij pracę, podając zadanie w fazie Specify. Skill automatycznie oceni Twoją specyfikację w skali 0–10. Jeśli wynik będzie poniżej 9 punktów, zadeklaruje niepewności i zaproponuje opcje — uzupełnij wymagania lub wybierz wariant.

4. Po zatwierdzeniu specyfikacji (wynik ≥9) skill przejdzie do fazy Plan (lub bezpośrednio do Act w trybie szybkim, jeśli zadanie ma ≤3 pliki i nie zawiera operacji wysokiego ryzyka). Każde 2 wywołania narzędzia będą zapisywane w dzienniku jako punkt kontrolny.

5. W fazie Act skill wykonuje zadanie. Jeśli napotkane będą 3 kolejne błędy, praca zostanie wstrzymana i eskalowana do Ciebie. Dla operacji wysokiego ryzyka (produkcja, dane wrażliwe, API rozliczeniowe, bezpieczeństwo) skill poprosi o jawne potwierdzenie.

6. Po wykonaniu skill przejdzie do Review (przegląd wyników) i Vault (archiwizacja decyzji w dzienniku). Wszystkie założenia i kluczowe punkty decyzyjne będą udokumentowane dla przyszłych odniesień.