Plan: zapisz intent.md

Uchwycenie intencji zmienia pomysł, ticket lub sygnał z produkcji w commitowany intent.md, który product owner może zaakceptować albo odrzucić. Zgłaszający opisuje problem i oczekiwany wynik zwykłym językiem; agent porządkuje treść, ujawnia niewiadome i zatrzymuje się przed projektowaniem rozwiązania.

Pomysły przestają czekać, aż ktoś je spisze. Intencja jest zapisywana raz, słowami inicjatora, jako wersjonowany artefakt.

Tradycyjnie: Pomysł przechodzi przez backlog entries, user stories, story points i refinementy, zanim ktoś może na nim działać. Ownership przenosi się przy każdym przekazaniu, więc to, co dociera do engineeringu, jest kilka kroków oddalone od tego, co inicjator miał na myśli.

AI-native: Inicjator burzuje z agentem i zapisuje wynik jako intent.md. Plik zawiera, czego się chce, dlaczego i pod jakimi ograniczeniami. Powtarzalne procesy kodujesz jako skills.

Zanim zaczniesz

• Dostęp do Claude (claude.ai lub Cowork), Cursor albo ChatGPT / Codex dla osób, które nie są inżynierami
• Uzgodniony szablon intent.md (zobacz łańcuch artefaktów)
• Wspólny, wersjonowany dom dla intentów, który obserwuje product owner

Ustawienie domu to jednorazowe zadanie dla zespołu platform lub engineeringu. Contributorzy bez doświadczenia z gitem nie muszą używać gita bezpośrednio: konektor GitHub pozwala agentowi commitować markdown w ich imieniu.

Prerequisites: brak. To play startowy.

Zapisz intencję

1. Opisz problem własnymi słowami.

   Powiedz, czego nie możesz zrobić dziś, kto jest dotknięty, jak wygląda lepiej, albo co jest poza scope. Formalny język nie jest wymagany.

2. Burzuj, aż pomysł będzie konkretny.

   Zadaj agentowi pytania, które zadałby analityk: scope, użytkownicy, ograniczenia i jak wygląda sukces.

3. Poproś agenta o zapisanie intent.md według szablonu organizacji.

   Zakoduj szablon jako skill, żeby każdy inicjator dostawał ten sam kształt: problem, proponowany outcome, dotknięci użytkownicy i systemy, ograniczenia oraz otwarte pytania.

4. Popraw wszystko, co agent źle zrozumiał.

   Inicjator odpowiada za to przejście. Product owner jeszcze nie zaakceptował pliku.

5. Commitnij intent.md do wspólnego domu.

   Autor i timestamp dołączają do rekordu. Product owner podnosi pomysł stamtąd.

Claude Code

Osoby spoza engineeringu mogą to zrobić z claude.ai lub Cowork z konektorem GitHub. Inżynierowie mogą to zrobić w repo:

I have an idea for FEATURE. Interview me about the problem, who is
affected, what better looks like, and what is out of scope. Then write
intent/FEATURE.md using our intent template. Do not write any code.

Zastąp FEATURE krótkim slugiem.

Cursor

Otwórz Ask lub Plan mode, żeby agent nie mógł edytować kodu aplikacji. Dołącz notatki lub screenshoty.

Interview me about this idea. Write intent/FEATURE.md using our
intent template. Do not modify any source files.

Przełącz się na Agent mode tylko po to, by commitnąć plik markdown.

Codex

Użyj /plan (lub Shift+Tab), żeby Codex proponował plik zamiast edytować produkt:

/plan Capture this idea as intent/FEATURE.md. Interview me first.
Do not change application code.

W aplikacji Codex możesz dołączyć screenshoty obok promptu.

Governance

Dowodem jest commitowany intent.md: autor, timestamp i pełna historia rewizji w gicie. Product owner zatwierdza. Decyzja accept lub reject, która wysyła intent do Design, jest zapisana jako merge lub zamykające review.

Verify

• Istnieje commitowany intent.md z autorem i timestampem.
• Inicjator poprawił pierwszy draft agenta.
• Product owner znajduje plik bez pinga na Slacku.

Wskaźnik wiodący: czas od pierwszej rozmowy do commitowanego intent.md (historia gita). Spodziewaj się godzin, nie wielotygodniowego cyklu elicytacji.

Wskaźnik opóźniony: udział plików intent.md, które product owner akceptuje do Design zamiast zamykać, plus jak często intent.md nadal się zmienia po pierwszym commicie spec.md dla tej samej zmiany.

Zastosuj praktykę w swoim narzędziu

Adapter Claude Code Użyj sesji repo do odkrywania i pozostaw implementację za Plan mode.

Adapter Cursora Ask mode służy do odkrywania, a Agent mode do zapisu zaakceptowanego pliku.

Adapter Codex Użyj /plan lub chatu aplikacji i zachowaj zaakceptowany plik w Git.

Przekaż zaakceptowaną intencję do designu

Po zaakceptowaniu pliku przez product ownera kontynuuj z Design.