Dokumentacja Techniczna i Standardy

Standard KOWiR przygotowania danych dla AI: pliki .md

Jakość odpowiedzi modelu zależy w pierwszej kolejności od jakości materiału, który mu przekazujemy. Standard KOWiR opiera się na prostym, tekstowym formacie Markdown (.md) — pliku z nagłówkami i listami, który człowiek czyta tak samo łatwo jak model. Nie wymaga żadnego oprogramowania ani umiejętności technicznych: wystarczy zwykły edytor tekstu.

Dlaczego struktura ma znaczenie

Model lepiej rozpoznaje poszczególne elementy zadania, gdy są wyraźnie oddzielone. Tekst podzielony nagłówkami (np. „Kontekst”, „Zadanie”, „Ograniczenia”) i punktami ogranicza ryzyko pominięcia istotnych informacji. Spójny układ to też powtarzalność — ten sam szablon działa za każdym razem, niezależnie od osoby, która go używa.

Zasady standardu

• Nagłówki i sekcje. Każdy materiał dzielimy na nazwane sekcje — model wie, gdzie szukać kontekstu, a gdzie polecenia.
• Eliminacja szumu. Dane zbędne pomijamy lub streszczamy. Nadmiarowa treść rozprasza model i pogarsza wynik.
• Anonimizacja. Dane osobowe i informacje prawnie chronione zastępujemy znacznikami, zanim materiał trafi do narzędzia.
• Jeden plik = jeden temat. Szablony przechowujemy osobno dla każdego procesu, co ułatwia ponowne użycie i utrzymanie.

Jak zacząć

Wystarczy utworzyć plik tekstowy z rozszerzeniem .md, dodać nagłówki dla stałych elementów (rola, kontekst, zadanie, format wyniku) i uzupełniać go danymi konkretnej sprawy. Tak przygotowany materiał wkleja się do narzędzia AI lub dołącza do projektu — model otrzymuje uporządkowaną, kompletną podstawę pracy.