LaunchRepoWiększość formularzy w katalogach składa się z dwóch części. Jedna opisuje produkt, druga — ciebie: bio twórcy, imię i nazwisko oraz afiliację, a czasem komentarz „dlaczego to zbudowałem” na tablicy premier. Zestaw celowo trzyma te części osobno. Twierdzenia o produkcie powstają w warsztacie tekstów i trafiają do copy.md; twierdzenia o tobie pochodzą z identity.json i z krótkiej sesji, którą zestaw nazywa briefingiem wizerunkowym, opisanej w PR-BRIEFING.md. Ten przewodnik wyjaśnia, czym jest ta sesja, po co istnieje i co ostatecznie trafia do representation.md.
Dlaczego osobna sesja
Agent, który właśnie wypełnił product.json, wie dużo o twoim produkcie i bardzo mało o tym, jak chcesz się prezentować. Zostawiony sam sobie, zaimprowizuje bio z tego, co uda mu się znaleźć — dawnego pracodawcy, poprzedniego projektu, miasta z twojego profilu na GitHubie — i wklei je do publicznego profilu twórcy, skąd trudno je potem wycofać. Briefing istnieje po to, żeby nic osobistego nie trafiło do wpisu, zanim zobaczysz dokładnie te zdania, które zostaną użyte. Odbywa się raz na produkt, zanim pierwsza informacja o tobie stanie się publiczna, i ponownie za każdym razem, gdy te informacje się zmienią.
Trzy pytania
Agent pyta cię wprost, prostym językiem:
- Występujesz jako osoba prywatna, firma czy jedno i drugie? Od tego zależy, czy w polu „maker” formularza pojawi się pseudonim, oficjalne imię i nazwisko czy nazwa organizacji.
- Jaki pseudonim, imię i nazwisko oraz afiliacja mogą się pojawić? Nie każda informacja z
identity.jsonjest przeznaczona do każdego wpisu. - Czego nigdy nie wolno o tobie napisać? Wcześniejsze produkty, niezwiązany pracodawca, twoja prawdziwa lokalizacja — wszystko, czego wolisz nie widzieć przy poście o premierze.
Zwróć uwagę, o co agent nie pyta: nie wymyśla gotowych wariantów do wyboru. Zbiera ograniczenia, a potem pisze wyłącznie na podstawie potwierdzonych faktów.
Trzy przykłady, pokazane dosłownie
Korzystając tylko z tego, co potwierdzisz, agent przygotowuje trzy krótkie teksty i pokazuje ci je słowo w słowo:
- bio twórcy w jednej linijce do profilu w katalogu;
- jednozdaniowe przedstawienie się przy premierze lub na forum — takie otwarcie, jakiego potrzebuje post w stylu Show HN albo komentarz na tablicy premier;
- jednozdaniowy komentarz „dlaczego to zbudowałem”.
Potem zadaje jedyne pytanie, które naprawdę się liczy: czy coś tu jest nieprawdziwe, przesadzone albo czegoś brakuje? Każda poprawka trafia do samych przykładów, a nie tylko po cichu do identity.json. To rozróżnienie jest celowe — agent, który poprawi plik z danymi, ale zachowa szkic ze starym sformułowaniem, użyje tego starego sformułowania ponownie. Nic nie zostanie opublikowane, dopóki tego nie zobaczysz.
Co jest zapisywane i gdzie
Zatwierdzone przykłady, twoje poprawki i data zatwierdzenia trafiają do representation.md w folderze produktu w twojej prywatnej przestrzeni roboczej. Od tej chwili każdy krok playbooka, który potrzebuje bio lub wstępu, bierze je stamtąd, zamiast układać coś nowego. Wiarygodność tego pliku chronią dwie granice:
- Twierdzenia o tobie nigdy nie są mieszane z twierdzeniami o produkcie w
copy.mdi odwrotnie. Plik kontekstu produktu opisuje produkt;representation.mdopisuje ciebie. - Plik należy do prywatnej przestrzeni roboczej, nigdy do współdzielonego repozytorium zestawu, i zawiera wyłącznie fakty zatwierdzone przez ciebie do publikacji — nie prywatny e-mail twojego konta ani nic innego z
identity.json, co oznaczono jako prywatne.
Miejsce w pierwszej sesji
Briefing przypada na trzecią fazę onboardingu prowadzonego przez agenta, zaraz po wypełnieniu identity.json i przed jakąkolwiek pracą w przeglądarce w którymkolwiek katalogu. Zajmuje kilka minut. Jeśli go pominiesz i pozwolisz agentowi pisać bio na bieżąco, dowiesz się, jak cię opisano, dopiero gdy wyszukasz własny produkt na stronie twórcy w Product Hunt. Checklista premiery dla solowych deweloperów wyjaśnia dokładniej, dlaczego profil twórcy warto przygotować przed dniem premiery, a nie po nim.