W dokumentacji analitycznej najdroższy błąd rzadko jest literówką. Znacznie groźniejsza jest cicha zmiana znaczenia: zamiana „może” na „musi”, usunięcie wyjątku, scalenie dwóch ról albo dopisanie logicznego, lecz nieuzgodnionego założenia. AI przyspiesza redakcję, streszczanie i porównywanie materiałów, ale wymaga procesu, w którym każdą zmianę da się zobaczyć, przypisać do źródła i zatwierdzić.
Najpierw określ kontrakt dla dokumentu
Przed użyciem modelu ustal przeznaczenie artefaktu, odbiorcę, obowiązujący szablon, słownik, zakres i stan bazowy. Inaczej AI może poprawnie przeredagować specyfikację dla programisty tak, jakby była notatką dla komitetu sterującego. Kontrakt powinien też wskazywać elementy, których nie wolno zmieniać bez decyzji: identyfikatory wymagań, wartości liczbowe, nazwy ról, znaczenie statusów i odwołania do regulacji.
| Warstwa | Co przekazujemy AI | Czego oczekujemy | Co zatwierdza człowiek |
|---|---|---|---|
| Kontekst | Cel, odbiorca, słownik, zakres | Przestrzeganie granic | Czy wynik odpowiada zastosowaniu |
| Źródła | Numerowane ustalenia i wersje | Odnośnik przy każdym twierdzeniu | Zgodność znaczenia ze źródłem |
| Redakcja | Fragment bazowy i reguły stylu | Proponowana wersja oraz lista zmian | Każdą zmianę merytoryczną |
| Publikacja | Zaakceptowany zestaw poprawek | Spójny format i linki | Wersję, właściciela i datę obowiązywania |
Workflow redakcyjny z pełną ścieżką audytu
1. Zamroź wersję bazową
Nadaj dokumentowi numer wersji i zapisz jego treść przed przetworzeniem. AI nie powinna edytować jedynej kopii. Najbezpieczniejszy wynik to propozycja zmiany: stary fragment, nowy fragment, powód oraz identyfikatory źródeł. Dzięki temu recenzent ocenia różnicę, a nie cały dokument od początku.
2. Rozdziel transformację od interpretacji
Transformacja obejmuje korektę języka, zmianę formatu, budowę tabeli z istniejących pól czy ujednolicenie terminów. Interpretacja tworzy nowe wnioski, priorytety lub zależności. Można je wspierać tym samym narzędziem, ale nie w jednym kroku. Interpretacje muszą być oznaczone jako propozycje i trafić do rejestru decyzji, a nie niepostrzeżenie do tekstu głównego.
3. Przejrzyj zmianę w czterech wymiarach
- Wierność: czy nowa wersja zachowuje znaczenie i wszystkie warunki?
- Kompletność: czy nie zniknął wyjątek, odsyłacz, właściciel albo ograniczenie?
- Spójność: czy termin i reguła są zgodne z innymi artefaktami?
- Użyteczność: czy odbiorca potrafi na tej podstawie podjąć decyzję lub wykonać pracę?
4. Opublikuj decyzję, nie odpowiedź z czatu
Po przeglądzie zaakceptowane fragmenty wchodzą do repozytorium. W historii zapisuje się autora decyzji, powód oraz powiązane źródła. Sam prompt może być pomocniczym załącznikiem, ale nie zastępuje uzasadnienia. Dokument powinien pozostać czytelny także wtedy, gdy organizacja zmieni model albo utraci historię rozmowy.
Przypadek: aktualizacja specyfikacji po decyzji o zwrotach
Komitet zdecydował, że klient może anulować zwrot tylko do chwili przekazania paczki przewoźnikowi. W repozytorium znajdowały się: opis procesu, sześć wymagań, słownik statusów i kryteria akceptacji. Polecenie „zaktualizuj dokumentację zgodnie z decyzją” byłoby zbyt szerokie. Model mógłby samodzielnie zgadnąć, który status oznacza przekazanie.
Analityk przekazał decyzję D-47, definicje statusów i listę kontrolowanych dokumentów. AI przygotowała raport wpływu. Trafnie wskazała wymaganie o anulowaniu i dwa scenariusze testowe, ale pominęła komunikat wysyłany w procesie po nieudanej próbie anulowania. Z kolei zasugerowała zmianę polityki retencji, choć decyzja jej nie dotyczyła. Po przeglądzie raport wyglądał następująco:
| Artefakt | Propozycja | Decyzja recenzenta | Uzasadnienie |
|---|---|---|---|
| REQ-21 | Dodać granicę anulowania | Przyjęta po doprecyzowaniu statusu | Bezpośredni skutek D-47 |
| AC-21.3 | Usunąć scenariusz po odbiorze paczki | Odrzucona; zmienić oczekiwany błąd | Scenariusz negatywny nadal potrzebny |
| Proces zwrotu | Brak zmiany | Odrzucona | Trzeba dodać komunikat o odmowie |
| Polityka retencji | Skrócić przechowywanie | Odrzucona jako poza zakresem | Brak źródła i związku z D-47 |
Prompt do raportu wpływu
„Porównaj decyzję D-47 z artefaktami A1–A9. Nie przepisuj dokumentów. Zwróć tabelę: identyfikator fragmentu, rodzaj wpływu, proponowana zmiana, dowód z D-47, pewność i pytanie. Jeśli wpływ jest tylko domniemany, oznacz HIPOTEZA. Nie zmieniaj wartości, statusów ani zakresu bez jawnego źródła”.
Czego nie oddawać automatycznej redakcji
Bez bezpośredniego nadzoru nie należy przetwarzać interpretacji prawnych, zobowiązań umownych, progów finansowych, uprawnień i wymagań bezpieczeństwa. Ryzyko rośnie także przy dokumentach z wieloma wyjątkami lub historycznymi kompromisami. Płynniejszy styl może usunąć celową ostrożność języka. W takich sytuacjach AI może indeksować materiał i proponować pytania, ale ostateczna redakcja należy do eksperta domenowego.
Checklista przed zatwierdzeniem wersji
- Istnieje zachowana wersja bazowa i czytelne porównanie zmian.
- Każda nowa informacja ma źródło; hipotezy nie trafiły do tekstu jako fakty.
- Wartości, reguły, role, wyjątki oraz znaczenie czasowników modalnych sprawdzono osobno.
- Odnośniki, identyfikatory i powiązania z procesem nadal działają.
- Recenzję przeprowadziła osoba kompetentna w obszarze skutku zmiany.
- Wersja ma właściciela, datę obowiązywania i zapisane uzasadnienie.
Jak utrzymać słownik i decyzje
Przy większym zestawie dokumentów warto utrzymywać kontrolowaną listę terminów wraz z definicją, właścicielem i dozwolonymi synonimami. AI może wskazać wystąpienia niezalecanej nazwy, ale nie powinna automatycznie scalać pojęć. „Klient”, „płatnik” i „odbiorca usługi” bywają tą samą osobą, lecz mają inne znaczenie w regule. Zmiana terminu wymaga raportu wpływu i decyzji właściciela słownika.
Podobnie postępuj z decyzjami. Streszczenie spotkania wskazuje kandydata, natomiast rejestr decyzji zawiera datę, zakres, rozważane opcje, uzasadnienie i osobę uprawnioną. Dopiero identyfikator zatwierdzonej decyzji może być źródłem aktualizacji dokumentacji.
Dobra dokumentacja nie jest magazynem wygenerowanych akapitów. Jest aktualnym zapisem ustaleń, z którego można odtworzyć drogę od źródła do decyzji. Sposób pracy nad samymi wymaganiami opisuje materiał AI w analizie wymagań, a szersze zasady recenzji — analityk jako kontroler jakości AI.
