Dlaczego "vibe writing" zmienia sposób, w jaki myślę o dokumentacji

Przyznaję się bez bicia: kiedy zaczynałem korzystać z AI do pisania, traktowałem to jak drogi spell checker. Popraw mi literówki. Wygładź to zdanie. Spraw, żeby mój Slack nie brzmiał jak bot. I wiecie co? To działało. Ale traktowanie asystentów AI w ten sposób to jak kupno Ferrari i używanie go tylko do jazdy do sklepu.

Zrozumiałem to, kiedy pracowałem nad dokumentacją nowego endpointu API. Moje pierwsze prompty były prostackie: "Wypoleruj ten paragraf." Rezultat był... OK. Technicznie poprawny. Kompletnie bez życia. Dopiero po trzech kolejnych sesjach zauważyłem, co robię źle — prosiłem AI, żeby poprawiało moje słowa, zamiast pomogło mi przemyśleć, co właściwie chcę powiedzieć.

Przełom nastąpił, kiedy przestałem myśleć o AI jak o korektorze i zacząłem traktować je jak współpracownika, który nigdy się nie męczy, nigdy nie ocenia głupich pytań i naprawdę nie przeszkadza mu siedemnaście wersji roboczych o 23:00. Wkleiłem plątaninę myśli o webhookach — pół technicznej specyfikacji, pół zagubionego bełkotu — i zapytałem: "Jakie pytania miałby deweloper, na które nie odpowiedziałem?"

Odpowiedź nie tylko wskazała luki. Pokazała mi, jak wygląda mental model czytelnika, gdzie założyłem zbyt dużo wiedzy w tle i które części mojego wyjaśnienia zamiast rozwiązywać problem, tworzyły zamieszanie. Ta rozmowa ukształtowała cały dokument, a efekt końcowy był czymś, czego sam bym nie napisał — nie dlatego, że AI ma lepsze słowa, ale dlatego, że zmusiło mnie do jasniejszego myślenia.

To właśnie ludzie nazywają teraz "vibe writing", i szczerze? Ta nazwa pasuje lepiej niż jakikolwiek techniczny żargon. Chodzi nie o automatyzację czy metryki efektywności. Chodzi o dopasowanie energii procesu myślowego do narzędzia, które nadąży za tempem.

Dla deweloperów i startupów to ma znaczenie

Najlepsze zespoły techniczne, jakie widziałem, nie tylko wydają kod — wydają jasność. Twój README to część produktu. Dokumentacja to user experience. Wiadomości commita opowiadają historię ewolucji twojego codebase'u. I prawda jest taka, że większość z nas jest lepsza w pisaniu algorytmów niż prozy. Vibe writing nie zasypuje tej przepaści, zastępując twój głos — pomaga ci go odnaleźć, kiedy jest pogrzebany pod warstwami złożoności technicznej.

Co dokładnie się dzieje, kiedy piszesz z vibe:

1. Zaczynasz od czegoś surowego — jedna linijka, plątanina punktów albo po prostu: "Muszę wyjaśnić, dlaczego wybraliśmy PostgreSQL zamiast Mongo i nie mam pojęcia, jak to zrobić ciekawie."
2. AI odpowiada.
3. Ty się bronisz, dopracowujesz, prosisz o podważenie założeń.
4. Prosisz o znalezienie dziur w logice.
5. W tę i z powrotem, jak sparing z partnerem, który przypadkiem przeczytał każdy blog techniczny na świecie.

Tworzysz nie dokument — tworzysz jaśniejszą wersję własnego myślenia. Słowa są niemal wtórne. Prawdziwy efekt to zrozumienie, które zyskujesz przez sam proces.

A co z argumentem, że pisanie to myślenie?

Słuszna obiekcja: jeśli pisanie to myślenie, to oddając pisanie maszynie, co dzieje się z myśleniem? To właściwe pytanie i nie mam na nie prostej odpowiedzi. Ale po sześciu miesiącach regularnego używania tych narzędzi powiem tak: vibe writing nie zastępuje myślenia. Zmusza cię do myślenia mocniej, bo teraz masz prawdziwego rozmówcę, który zadaje pytania i rozgrzebuje niespójności. Kiedy pisałem sam, mogłem przypadkowo przeskoczyć słabe argumenty. Pisząc z AI, zauważa. Wciąż podejmuję każdą decyzję, ale podejmuję lepsze.

Spróbuj sam

Kiedy następnym razem będziesz pisać dokumentację, zrób inaczej: nie wklejaj gotowego draftu z prośbą o poprawki. Zacznij od pustki i zadaj pytanie. Zobacz, gdzie cię to zaprowadzi.

Możesz się zdziwić, ile nie wiedziałeś, że myślisz.