Proces UX open source dla ludzi i agentów

Poprowadź produkt od misji do mierzalnej wartości dla użytkownika.

Open source'owy proces UX dla ludzi i agentów. Pomaga przejść od misji, rynku i potrzeby użytkownika do decyzji, metryk, ewaluacji UX i lekkiej pamięci produktu w repo.

Zainstaluj skill Współtwórz
Mapa procesu

Określ, jaką zmianę produkt ma wywołać, dla kogo może mieć znaczenie i dlaczego warto sprawdzić ją teraz.

Pytanie

Jaką zmianę chcemy wywołać, dla kogo może być ważna i dlaczego teraz?

Artefakt

Teza produktowa: odbiorcy, obszar problemu, napięcie albo okazja i powód działania.

Sygnał

Widać napięcie rynkowe, powtarzalny problem, słabe alternatywy albo dobry moment.

Określ rynek, kupujących, adopterów, blokujących, kanały i sygnały popytu, zanim przejdziesz do osoby wykonującej zadanie.

Pytanie

Czy istnieje wystarczająco duży i osiągalny segment z powodem, budżetem albo wpływem na adopcję?

Artefakt

Mapa rynku: segmenty, wielkość, kanały, role kupna i adopcji, alternatywy oraz pozycjonowanie.

Sygnał

Da się oszacować wielkość segmentu, dotarcie, popyt albo koszt obecnych alternatyw.

Zbadaj konkretną osobę wykonującą zadanie: co robi, co ją blokuje, czego chce i w jakich warunkach działa.

Pytanie

Co konkretny użytkownik próbuje zrobić i co go blokuje albo frustruje?

Artefakt

Profil użytkownika: zadania, bolączki, korzyści, kontekst i obecne obejścia.

Sygnał

Zachowanie, feedback, wywiady, logi albo support pokazują częstotliwość i koszt problemu.

Wyprowadź potrzebę z dowodów użytkownika i zdecyduj, czy uzasadnia funkcję, prototyp albo dalszy research.

Pytanie

Która potrzeba jest na tyle silna, żeby uzasadnić budowę, prototyp albo dalszy research?

Artefakt

Opis potrzeby: użytkownik chce [korzyść], próbuje [zadanie], ale blokuje go [bolączka].

Sygnał

Da się wskazać siłę potrzeby, wpływ na zadanie, poziom pewności i decyzję.

Przygotuj bezpieczne i stabilne środowisko oraz integracje, które muszą istnieć, żeby dostarczyć obiecaną wartość.

Pytanie

Co technicznie musi działać, żeby wartość była niezawodna, bezpieczna i mierzalna?

Artefakt

Plan techniczny: dane, architektura, integracje, jakość, ryzyka i wymagania operacyjne.

Sygnał

Dane, wydajność, niezawodność, bezpieczeństwo i koszt wspierają potrzebę użytkownika.

Zamień potwierdzoną potrzebę w interakcję, architekturę i interfejs na podstawie design systemu, tak żeby użytkownik mógł je zrozumieć i wykorzystać.

Pytanie

Jak użytkownik odkryje, zrozumie, wykona i zapamięta rozwiązanie?

Artefakt

Mapa produktu: przepływ użytkownika, prototyp, kluczowa interakcja, copy i kierunek design systemu.

Sygnał

Test lub prototyp pokazuje zrozumienie, ukończenie zadania, niski wysiłek i zaufanie.

Zaplanuj wdrożenie, onboarding, komunikację, feedback i metryki, które pokażą, czy wartość naprawdę dotarła do użytkownika.

Pytanie

Jak dostarczymy, zakomunikujemy i sprawdzimy wartość po wdrożeniu?

Artefakt

Plan wartości: rollout, komunikat, onboarding, feedback, test użyteczności i iteracje.

Sygnał

Adopcja, retencja, ukończenie zadania, satysfakcja i feedback mówią, co utrzymać albo zmienić.

4 warstwy UX

Każda decyzja przechodzi przez cztery warstwy UX

Każdy etap procesu powinien ostatecznie wzmacniać jedną z czterech warstw. Jeżeli produkt nie przechodzi tego testu, problem nie zawsze leży w interfejsie. Czasem trzeba wrócić do potrzeby, rynku, infrastruktury albo sposobu dostarczenia wartości.

Użyteczność

Produkt rozwiązuje realny problem i odpowiada na potrzebę wynikającą z badań, a nie tylko na pomysł funkcji.

Czy użytkownik dostaje wartość, której naprawdę potrzebuje?
Ergonomia

Doświadczenie pozwala wykonać zadanie szybko, zrozumiale i bez zbędnego wysiłku poznawczego.

Czy najważniejsze zadanie da się zrobić bez tarcia?
Atrakcyjność

Produkt jest klarowny, angażujący i zapamiętywalny, a design system wzmacnia zaufanie do rozwiązania.

Czy użytkownik chce wrócić do tego doświadczenia?
Tożsamość

Produkt pasuje do tego, kim użytkownik chce być, jak chce pracować i jak chce podejmować decyzje.

Czy produkt pasuje do sposobu, w jaki użytkownik chce pracować i podejmować decyzje?
Workflow

Dwa tryby pracy: start produktu albo audyt istniejącego repo

UX RULER nie kończy się na rozmowie. Zapisuje najważniejszą logikę produktu tak, żeby mogli do niej wracać ludzie i agenci: najpierw w jednym pliku, dopiero później w większej strukturze.

Nowe repo

Skill działa jak starter systemu pracy nad produktem. Gdy repo jest puste, najpierw pomaga zdefiniować misję przez kilka kierunków produktu, zanim zespół zacznie kodować.

  • Pomaga wybrać lub połączyć tezę produktową i pierwsze założenia.
  • Mapuje rynek, użytkownika i potrzebę przed wyborem funkcji.
  • Ustala pierwszą metrykę wartości, ryzyka i krok walidacyjny.
  • Daje agentom kontekst w `PRODUCT.md`, wczesny plan w `ROADMAP.md` i opcjonalnie instrukcje w `AGENTS.md`.

Istniejący produkt

Skill działa jak audyt UX i produktowe due diligence. Rekonstruuje logikę produktu po fakcie i pokazuje luki.

  • Sprawdza, czy funkcje wynikają z realnych potrzeb.
  • Łączy dostępne dane użycia, feedback, analytics, architekturę i rollout z decyzjami.
  • Wskazuje brakujące decyzje, metryki, research i UX scorecard bez tworzenia plików na zapas.
  • Pomaga ustalić, co naprawić najpierw, żeby produkt rozwijał się w oparciu o potrzeby, decyzje i metryki.
Struktura repo

Pełna struktura, minimum na czarno

Czarne wiersze to domyślny zestaw startowy po ustaleniu kierunku produktu. Reszta jest docelową biblioteką artefaktów, którą dodaje się dopiero, gdy decyzja, ryzyko albo pomiar wymagają osobnego pliku.

Minimalny root4 pliki
  • AGENTS.mdagent
  • PRODUCT.mdmapa
  • ROADMAP.mdplan
  • README.mdlink
Root jako warstwa dojrzałości7 plików
  • CLAUDE.mdagent
  • DESIGN.mddesign
  • tokens.jsontokens
  • CHANGELOG.mdrelease
  • SECURITY.mdrisk
  • CODEOWNERSowner
  • CONTRIBUTING.mdopen
Instrukcje narzędzi4 pliki
  • .cursor/rules/product-ux.mdcCursor
  • .github/copilot-instructions.mdCopilot
  • .github/ISSUE_TEMPLATE/feedback.ymlfeedback
  • .github/ISSUE_TEMPLATE/feature_request.ymlrequest
product/00-mission5 plików
  • mission.mdwhy
  • product-thesis.mdteza
  • principles.mdzasady
  • assumptions.mdryzyko
  • non-goals.mdgranice
product/01-audience5 plików
  • market-map.mdmapa
  • segments.mdsegmenty
  • competitors.mdalternatywy
  • positioning.mdpozycja
  • channels.mddotarcie
product/02-user5 plików
  • research-plan.mdresearch
  • interview-guide.mdguide
  • user-profile.mdprofil
  • jobs-pains-gains.mdJTBD
  • insights.mdinsight
product/03-need4 pliki
  • problem-statement.mdproblem
  • opportunities.mdszanse
  • feature-hypotheses.mdhipotezy
  • prd.mdzakres
product/04-infrastructure12 plików
  • architecture.mdarch
  • data-model.mddata
  • permissions.mdauth
  • openapi.yamlapi
  • asyncapi.yamlevents
  • schemas/folder
  • observability.mdops
  • slo.mdslo
  • runbooks/folder
  • threat-model.mdrisk
  • adr/decyzje
  • adr/0001-template.mdADR
product/05-product9 plików
  • information-architecture.mdIA
  • flows.mdflow
  • interaction-patterns.mdUI
  • design-system.mdsystem
  • accessibility.mda11y
  • content-guidelines.mdcopy
  • empty-states.mdstate
  • error-states.mdstate
  • onboarding.mdstart
product/06-value6 plików
  • rollout.mdrollout
  • release-notes.mdrelease
  • feedback-plan.mdfeedback
  • usability-test.mdtest
  • survey.mdsurvey
  • analytics-events.mdevents
product/07-ux-test3 pliki
  • ux-scorecard.mdscore
  • test-plan.mdplan
  • metrics.mdmetrics
product/08-decision-measurement14 plików
  • assumptions.mdzałożenia
  • non-goals.mdgranice
  • decision-log.mdlog
  • risk-register.mdrisk
  • north-star-metric.mdNSM
  • metrics-tree.mdtree
  • experiments/tests
  • experiments/0001-template.mdexp
  • flags.jsonflags
  • analytics/data
  • analytics/tracking-plan.yamlplan
  • analytics/events/folder
  • feedback/usability-test.mdtest
  • feedback/survey.qmdsurvey
Instalacja

Dodaj skill do swojego agenta

UX RULER instaluje się jako folder skilla z workflow i referencjami. Wybierz ścieżkę dla swojego narzędzia: osobista instalacja w agencie albo kopia lokalna w repo projektu.

Codex

Najprostsza ścieżka: użyj wbudowanego `skill-installer` i podaj URL do folderu skilla w publicznym repo.

Prompt

Claude Code

Instalacja jako personal skill. Claude wykrywa skille z `~/.claude/skills/` po restarcie Claude Code.

Terminal

Projektowo

Wariant dla zespołu: skill jest częścią konkretnego repo i można go commitować razem z projektem.

Terminal
Startowe prompty

Jak uruchomić UX RULER

Po instalacji najlepiej zacząć od rozmowy: daj agentowi szkic pomysłu, pozwól mu dopytać prostym językiem o kontekst, sprawdzić dostępne dane użycia i repo, a potem poproś o research, wnioski i decyzję.

Nowy produkt
Użyj $uxruler jako procesu UX open source dla ludzi i agentów. Używaj prostego języka. Jeśli repo jest puste, pomóż mi najpierw zdefiniować misję przez 2-3 kierunki produktu. Gdy zdecydujemy misję lub kierunek, utwórz albo zaktualizuj kompaktowe PRODUCT.md i ROADMAP.md. W przeciwnym razie zapytaj mnie tylko o brakujący kontekst, potem sprawdź dostępne dane użycia lub dane repo, zweryfikuj rynek, odbiorców, alternatywy i potrzebę użytkownika, a dopiero potem przedstaw wnioski i rekomendacje.
Audyt funkcji
Użyj $uxruler do audytu tej funkcji. Prostym językiem pokaż, czy wynika z realnych odbiorców, potrzeby użytkownika, możliwości infrastruktury, doświadczenia produktu, mierzalnej wartości i zapisanej decyzji.
Przegląd repo
Użyj $uxruler na tym repo. Najpierw zapytaj, co chcę zdecydować po przeglądzie repo, potem sprawdź repo i pokaż prostym językiem, co wiadomo, czego brakuje i co zrobić dalej. Jeśli misja lub kierunek są już zdecydowane, utwórz albo zaktualizuj kompaktowy ROADMAP.md.