clarity-gate

Clarity Gate to narzędzie do kontroli jakości epistemicznej dokumentów przed ich integracją z systemami RAG. Sprawdza, czy tekst zawiera jasne rozróżnienie między faktami a założeniami, co zapobiega błędom LLM podczas czytania. Generuje dokumenty CGD (Clarity-Gated Documents) i waliduje pliki SOT (Source of Truth). Używa 9-punktowego systemu weryfikacji i dwuetapowego przepływu pracy z udziałem człowieka, aby upewnić się, że tylko epistemicznie czyste źródła trafiają do Twojej bazy wiedzy.

1. Zainstaluj skill clarity-gate w swoim środowisku agentów, zgodnie z dokumentacją agentskills.io. Upewnij się, że masz dostęp do repozytorium https://github.com/frmoretto/clarity-gate i wersję 2.1.3 lub wyższą.

2. Przygotuj dokument do weryfikacji — może to być artykuł, instrukcja, raport lub dowolny tekst, który planujesz dodać do bazy wiedzy RAG. Clarity Gate przeanalizuje, czy dokument jasno rozróżnia fakty od założeń i czy zawiera wystarczające oznaczenia niepewności.

3. Uruchom weryfikację, używając jednego z dostępnych triggerów, np. "clarity gate", "check for hallucination risks" lub "pre-ingestion check". Narzędzie przeprowadzi 9-punktową analizę epistemiczną dokumentu.

4. Przejrzyj raport weryfikacji i identyfikuj miejsca, gdzie brakuje jasności lub gdzie założenia mogą być mylone z faktami. Clarity Gate wskaże konkretne sekcje wymagające poprawy.

5. Dokonaj poprawek w dokumencie na podstawie zaleceń — dodaj oznaczenia niepewności, wyjaśnij założenia lub usuń niejednoznaczne sformułowania. Następnie ponownie uruchom weryfikację.

6. Po zatwierdzeniu narzędzie wygeneruje plik CGD (.cgd.md) — dokument gotowy do wgrania do bazy wiedzy. Ten format gwarantuje, że każdy LLM czytający dokument będzie miał jasny obraz granic między wiedzą a spekulacją.