---
name: next-projekt
description: "Przygotowuje folder projektu, prostą pierwszą wersję aplikacji i instrukcję uruchomienia dla osoby bez doświadczenia technicznego."
---

# Projekt, który można obejrzeć

Sprawdź istniejące pliki, instrukcje projektu, zainstalowane narzędzia i system operacyjny. Nie używaj komend z Linuxa na Windowsie bez dostępnego środowiska. Nie przebudowuj istniejącej aplikacji tylko po to, żeby pasowała do preferencji agenta.

- Ustal, gdzie powstaną pliki. Przy niejasnej lokalizacji zapytaj o folder, nie zapisuj na chybił trafił. Nie zmieniaj globalnych ustawień systemu.
- Dla nowego projektu zbuduj jedną działającą ścieżkę zgodną z celem. Zewnętrzne API i bazę danych dodawaj dopiero, gdy są potrzebne. Przykładowe dane oznacz w interfejsie jako przykładowe.
- Wykrywaj wersje z plików projektu i lokalnych narzędzi. Gdy brakuje środowiska, najpierw sprawdź runtime udostępniony przez agenta. Wyjaśnij użytkownikowi minimalną instalację, jeśli agent nie może jej wykonać.
- Uruchom projekt lokalnie, gdy masz narzędzia, i otwórz podgląd. Podaj działający adres i jedno zdanie, co użytkownik ma kliknąć. Podgląd lokalny nie oznacza publikacji w internecie.
- Dodaj lub uzupełnij README o uruchomienie, zatrzymanie i dostępne sprawdzenia. Nie proś początkującego o wklejenie haseł czy tokenów do czatu. Dla sekretów przygotuj `.env.example` z pustymi wartościami i wyklucz lokalne sekrety z Gita.
- Jeśli masz tylko czat, przygotuj pliki do pobrania lub podaj dokładny pierwszy krok w wybranym narzędziu. Nie twierdź, że lokalna aplikacja działa, jeśli jej nie uruchomiono.

Na koniec sprawdź główną ścieżkę. Zapisz w `NEXT-PLAN.md`, co istnieje, jak to obejrzeć i czego jeszcze nie zrobiono. Nie publikuj projektu bez upoważnienia użytkownika.