Wypełnij brief
Pisz bezpośrednio w polach. Markdown i JSON poniżej aktualizują się na bieżąco i są gotowe do skopiowania lub pobrania.
Przykład to wymyślona aplikacja do grafików w kawiarni. Zastąp każde pole własnym produktem.
Twój szkic jest przechowywany w pamięci lokalnej tej przeglądarki, więc przetrwa odświeżenie strony. Nigdy nie jest wysyłany. Przycisk Wyczyść go usuwa.
Podgląd Markdown
# [Nazwa produktu] > [Co robi i dla kogo, w jednym zdaniu] Ostatnia aktualizacja: [data] ## Problem [Kto dziś zmaga się z czym] ## Dla kogo [Główni użytkownicy i kupujący] ## Co robi [Jak produkt rozwiązuje problem] ## Kluczowe możliwości - [Maksymalnie trzy rzeczy, które robi już dziś] ## Zamiast [Czego ludzie używają dziś i dlaczego to jest lepsze] ## Poza zakresem [Czego celowo nie robi] ## Skąd wiemy, że działa [Jeden sygnał, który da się sprawdzić] ## Link [Adres strony lub repozytorium]
Podgląd JSON
{
"format": "product-brief",
"version": 1,
"language": "pl",
"updated": "",
"name": "",
"oneLiner": "",
"problem": "",
"audience": "",
"solution": "",
"features": [
"",
"",
""
],
"alternative": "",
"nonGoals": "",
"success": "",
"url": ""
}
Puste pliki
Wolisz własny edytor? Weź pusty szablon w dowolnym formacie.
Do czego służy każde pole
Dziesięć pól wystarczy, by ludzie i agenci mieli wspólny obraz tego, co budujesz. Każde odpowiada na pytanie, które ktoś inaczej zadałby tobie.
- Nazwa produktu
- Wszyscy, łącznie z agentem, powinni zapisywać nazwę tak samo. Zapisz ją tu raz.
- Jedno zdanie
- Zdanie, którego użyjesz ponownie w listingach, bio i na stronie głównej. Jeśli nie umiesz go napisać, produkt nie jest jeszcze jasny.
- Problem
- Praca zaczyna się od problemu, nie od funkcji. Jasny problem pozwala innym zaproponować lepsze rozwiązania niż twoje.
- Dla kogo
- Wąska grupa odbiorców ułatwia każdą późniejszą decyzję: sformułowania, funkcje, miejsce premiery.
- Co robi
- Jak produkt rozwiązuje problem, prostymi słowami. Tego nowa osoba potrzebuje najpierw.
- Kluczowe możliwości
- Trzy możliwości, które istnieją już dziś. Agent piszący teksty nigdy nie powinien wymyślać czwartej.
- Zamiast
- Ludzie porównują z tym, co robią teraz. Nazwanie obejścia lepiej wyjaśnia twoją wartość niż tabela funkcji.
- Poza zakresem
- Pole, które większość briefów pomija. Zatrzymuje rozrost zakresu i nie pozwala agentowi dodawać funkcji, których z tobą nie uzgodniono.
- Skąd wiemy, że działa
- Jeden obserwowalny sygnał mówi ci, czy produkt działa, i daje agentowi cel, względem którego może sprawdzać.
- Link
- Link pozwala czytelnikowi albo agentowi zweryfikować szczegóły zamiast je zgadywać.
Sprawdź slogan pod kątem limitu znaków na każdej platformie →
Przekaż brief agentowi
Agenci kodujący czytają pliki Markdown z twojego repozytorium. Krótki brief obok kodu daje im kontekst produktu, którego sam kod nie zawiera.
- Pobierz plik Markdown i zapisz go w repozytorium, na przykład jako docs/product-brief.md.
- Wskaż go agentowi: dodaj linijkę w AGENTS.md albo zaimportuj go w CLAUDE.md przez @docs/product-brief.md.
- Dla GitHub Copilot podlinkuj lub skopiuj najważniejsze informacje do .github/copilot-instructions.md.
- Trzymaj obok plik JSON, gdy skrypt lub inne narzędzie ma czytać te same fakty.
- Zmieniaj linijkę z datą przy każdej zmianie i usuwaj zdania, które przestały być prawdziwe.
| Temat | Oficjalne brzmienie | Co to oznacza dla twojego briefu |
|---|---|---|
| Format | AGENTS.md is just standard Markdown. | Zwykły brief w Markdown działa jako kontekst dla agenta bez żadnej specjalnej składni. |
| Nagłówki | Use any headings you like; the agent simply parses the text you provide. | Nazwy sekcji w tym szablonie to propozycja. Zmień je, jeśli twój zespół używa innych słów. |
| Kiedy jest czytany | You write these files in plain text; Claude reads them at the start of every session. | Claude Code wczytuje CLAUDE.md na początku każdej sesji, więc zaimportowany brief zawsze jest w kontekście. |
| Import | CLAUDE.md files can import additional files using @path/to/import syntax. | Jedna linijka, taka jak @docs/product-brief.md w CLAUDE.md, wystarczy, by dołączyć brief. |
| Długość | target under 200 lines per CLAUDE.md file. Longer files consume more context and reduce adherence. | Krótki kontekst jest lepiej przestrzegany. Jednostronicowy brief jest daleko poniżej tego rozmiaru. |
| Copilot | Add natural language instructions to the file, in Markdown format. | Instrukcje dla Copilota to również Markdown, więc ten sam tekst pasuje i tam. |
| Kodowanie JSON | JSON text exchanged between systems that are not part of a closed ecosystem MUST be encoded using UTF-8 | Pobierany JSON jest w UTF-8, więc znaki diakrytyczne, znaki CJK i emoji przetrwają w każdym narzędziu. |
Brief, PRD czy plik kontekstu
Trzy dokumenty, które często się myli. Odpowiadają na różne pytania, a wiele produktów potrzebuje więcej niż jednego.
| Dokument | Odpowiada na pytanie | Długość | Kto pisze |
|---|---|---|---|
| Brief produktowy (ten szablon) | Co budujemy, dla kogo i gdzie się zatrzymujemy | Jedna strona, dziesięć pól | Założyciel lub lider produktu |
| Dokument wymagań produktowych (PRD) | Jak dokładnie ma działać jedna funkcja lub wydanie | Kilka stron na funkcję | Product manager wspólnie z zespołem inżynierów |
| Plik kontekstu produktu | Które zatwierdzone fakty i teksty agent może publikować | Rośnie z każdym kanałem | Osoba prowadząca premierę |
Czego ten szablon nie obejmuje
- To punkt wyjścia, a nie pełna specyfikacja. Szczegółowe wymagania, projekty i badania mają swoje własne dokumenty.
- Ceny, daty premiery i warianty tekstów marketingowych celowo nie są jego częścią.
- Strona nie sprawdza, czy twoje stwierdzenia są prawdziwe. Zapisuj tylko to, co produkt robi już dziś.
- Nic nie jest nigdzie wysyłane: szkic zostaje w tej przeglądarce, dopóki nie klikniesz Wyczyść.
Źródła
Przeczytaliśmy te strony 30 września 2026 i cytujemy je powyżej słowo w słowo.
| Strona | Data na stronie | Sprawdzone przez nas |
|---|---|---|
| AGENTS.md | brak daty | |
| Claude Code Docs: How Claude remembers your project | brak daty | |
| GitHub Docs: Adding repository custom instructions for GitHub Copilot | brak daty | |
| RFC 8259: The JavaScript Object Notation (JSON) Data Interchange Format (December 2017) | brak daty | |
| CommonMark Spec, version 0.31.2 | brak daty |
FAQ
- Czym jest brief produktowy?
- To krótki dokument, który mówi, czym jest produkt, jaki problem rozwiązuje, dla kogo jest i czego celowo nie obejmuje. Daje wszystkim, którzy pracują nad produktem, ludziom i agentom, ten sam punkt wyjścia.
- Czym brief produktowy różni się od PRD?
- Brief obejmuje cały produkt na jednej stronie. Dokument wymagań produktowych (PRD) wchodzi głęboko w jedną funkcję lub wydanie i opisuje dokładnie, jak ma działać. Zacznij od briefu; PRD pisz wtedy, gdy funkcja wymaga takiej szczegółowości.
- Czy agent kodujący AI może korzystać z tego briefu?
- Tak. Zapisz plik Markdown w repozytorium i odwołaj się do niego w AGENTS.md albo zaimportuj go w CLAUDE.md. AGENTS.md to zwykły Markdown, a Claude Code czyta CLAUDE.md na początku każdej sesji.
- Dlaczego Markdown i JSON?
- Markdown jest łatwy do czytania dla ludzi i agentów i wyświetla się poprawnie na każdym hostingu kodu. JSON zawiera tę samą treść ze stałymi angielskimi kluczami, więc skrypty i formularze mogą go czytać bez analizowania prozy.
- Czy mój brief jest gdzieś zapisywany lub wysyłany?
- Jest przechowywany tylko w pamięci lokalnej twojej przeglądarki, żeby odświeżenie strony go nie skasowało. Nic nie jest wysyłane ani przekazywane do analityki, a Wyczyść usuwa szkic.
Brief gotowy? Pokaż produkt ludziom.
LaunchRepo daje twojemu agentowi kodującemu playbook dla każdej platformy premier i każdego katalogu, więc opisany właśnie produkt trafia tam, gdzie szukają go twoi odbiorcy, i śledzi, które wpisy są już opublikowane.
Zobacz cennik