Lekcja 22 · Faza 3 · Pipeline pisarski
Zaczynamy Fazę 3. Pierwszy pakiet to trzy skille do pisania — nie kodu, tekstu. Wszystkie trzy dzielą jedną ramę: explore kontra exploit. writing-fragments to czyste explore — poszerzasz przestrzeń tego, co mogłoby powstać, bez zobowiązania do struktury. writing-beats i writing-shape to dwa różne exploit — sterta surowego materiału jest już zamknięta, teraz ją zagospodarowujesz.
.agents/skills/{writing-fragments,writing-beats,writing-shape}/SKILL.md w tym repo.
writing-fragments nazywa to wprost: "This is pure explore... committing is exploit, a separate skill's job." To ten sam podział, co eksploracja kodu kontra pisanie kodu — najpierw poszerzasz opcje, dopiero potem zobowiązujesz się do jednej ścieżki. Mieszanie faz jest błędem: narzucanie struktury podczas writing-fragments jest wprost poza zakresem tego skilla.
/writing-fragments — zbieranie, bez strukturyModel to dziennik pisarza: lata nieustrukturyzowanych spostrzeżeń, z których później wydobywa się surowiec. Fragment to dowolny kawałek tekstu, który mógłby przetrwać do finalnego artykułu — musi być zrozumiały dla autora, ale nie musi definiować swoich pojęć ani być zrozumiały dla przypadkowego czytelnika. Pytanie testowe brzmi "czy to jest kawałek dobrego pisania?", nie "czy to jest samodzielny argument?".
Fragmentem może być: ostre zdanie bez wiadomego miejsca, twierdzenie z jednozdaniowym uzasadnieniem, winieta (zdarzenie, snippet kodu, scenariusz, analogia), niedomyślana myśl do dopracowania później, cytat, lista powiązanych obserwacji, skarga, riposta.
Format pliku: pojedynczy H1 z roboczym tytułem na górze, potem fragmenty rozdzielone poziomą linią (---), bez nagłówków w środku, bez tagów, bez kolejności poza tą, w jakiej powstały.
Ta sama dyscyplina powtarza się identycznie we wszystkich trzech skillach — warto ją zapamiętać jako jedną regułę, nie trzy osobne:
/writing-beats kontra /writing-shape — dwa różne exploitOba zakładają, że dostały już plik z surowym materiałem (od writing-fragments albo skądinąd) i że eksploracja jest zamknięta. Różnią się jednostką pracy i stylem rozmowy:
| writing-beats | writing-shape | |
|---|---|---|
| Jednostka | beat — jeden ruch w podróży (scena, puenta, pytanie, zwrot akcji) | blok — akapit, lista, tabela, cytat, callout |
| Styl | choose-your-own-adventure: 2–3 kandydackie bety do wyboru na każdym kroku | ciągła pętla: "co czytelnik musi usłyszeć teraz?", z otwartym argumentowaniem o formie |
| Start | 2–3 kandydackie bety startowe, wybierasz jeden | 2–3 kandydackie otwarcia, każde sugeruje inną tezę |
| Koniec | podróż się kończy naturalnie — nie wtedy, gdy sterta jest pusta | użytkownik decyduje, kiedy artykuł jest gotowy |
Wybierz writing-beats, gdy tekst ma być narracyjną podróżą z realnymi rozgałęzieniami (czytelnik mógłby trafić tu różnymi ścieżkami). Wybierz writing-shape, gdy potrzebujesz jednej, spójnej linii argumentacji z kimś, kto naciska na każdą słabą przesłankę — writing-shape jawnie każe kwestionować: "jeśli to wytnę, co się zepsuje?", "to zdanie robi dwie rzeczy naraz — rozdziel albo wybierz jedną".
Oba exploit-skille opierają się na jednym pojęciu: grounding. Każde pojęcie musi być ugruntowane, zanim kolejny beat/blok może się na nim oprzeć — czytelnik albo wszedł z nim już w głowie (prerequisite, ustalone na starcie), albo poznał je we wcześniejszym beacie/bloku (introduced). Jednostką jest samo pojęcie, nie słowo na nie — beat może oprzeć się na idei, której czytelnik nie ma, nawet bez żadnego żargonu w zdaniu.
To dokładnie ten sam problem co "Fog of war" w decision-mapping (poznasz w kolejnej lekcji) czy "seam" w tdd — nazwana granica między tym, co już wiadomo, a tym, co dopiero trzeba ustalić. Dźwignia: im więcej wymagasz jako prerequisite, tym więcej czytelników odpadnie na starcie; im więcej gruntujesz wewnątrz tekstu, tym bardziej wczesne fragmenty toną w definicjach. To ustalenie robisz z użytkownikiem na samym początku sesji, i wracasz do niego, gdy kuszący beat okazuje się wymagać czegoś, czego nikt jeszcze nie ugruntował.
W przeciwieństwie do reszty Fazy 3 to zadanie nie musi dotyczyć Twojego projektu firmowego — pipeline pisarski działa na dowolny temat. Wybierz coś, co faktycznie chcesz napisać (notatkę, posta, dokumentację), i:
/writing-fragments na kilka minut rozmowy — sprawdź, czy Claude dopisuje po cichu, i czy uda Ci się ukuć jeden leading word./writing-beats albo /writing-shape — wybierz świadomie, na podstawie tabeli wyżej.1. Czym różni się faza explore (writing-fragments) od fazy exploit (writing-beats/writing-shape)?
2. Jaki jest test na to, czy dany kawałek tekstu kwalifikuje się jako "fragment"?
3. Dlaczego "leading word" jest opisywany jako najcenniejszy rodzaj fragmentu?
4. Pojęcie zostaje wprowadzone dopiero w środku artykułu, a wcześniejszy beat próbuje się na nim oprzeć, zanim to nastąpiło. Co to narusza?
5. Piszesz narracyjny tekst z realnymi rozgałęzieniami, gdzie czytelnik mógłby trafić różnymi ścieżkami. Który skill pasuje lepiej?