Wzorce · 13 / 15

Nowy projekt z AI

Dziesięć minut przygotowania, które oszczędzają godziny poprawek.

Stan na: 7.11.2026

Problem pustego repozytorium

W pustym repozytorium AI pisze gorzej: nie ma struktury, konwencji ani wzorców do naśladowania, więc zgaduje. Dziesięć minut przygotowania na starcie oszczędza godziny poprawek.

Pięć kroków

1. Szkielet z oficjalnego narzędzia

Narzędzia frameworków ustawiają TypeScript, lintery i katalogi poprawnie.

# Next.js: SaaS i aplikacje pełne
npx create-next-app@latest moja-aplikacja

# Astro: strony z treścią
npm create astro@latest moja-strona

# Hono: API i Workers
npm create hono@latest moje-api

Strona statyczna bez frameworka też jest dobrym wyborem: index.html, arkusz CSS i jeden plik JS.

2. CLAUDE.md od razu

Zanim powstanie pierwsza linia aplikacji. W Claude Code /init zrobi wersję startową z analizy repozytorium. Minimum:

# Projekt: moja-aplikacja
[Jedno zdanie o projekcie]. [Framework], [baza], [ważne biblioteki].

## Polecenia
- `npm run dev`, `npm test`, `npm run build`

## Struktura
[Najważniejsze katalogi i co w nich jest]

## Konwencje
[Trzy do pięciu zasad, na których Ci zależy]

Więcej: CLAUDE.md i AGENTS.md.

3. Serwery MCP

Wspólne dla zespołu serwery zapisz w .mcp.json:

claude mcp add --scope project --transport http github https://api.githubcopilot.com/mcp/
claude mcp add --scope project --transport stdio context7 -- npx -y @upstash/context7-mcp

Więcej: MCP po polsku.

4. Katalogi

Nawet puste pliki pomagają, bo AI widzi strukturę i odkłada nowy kod we właściwe miejsce.

mkdir -p src/{components,lib,types}
touch src/lib/baza.ts src/types/index.ts

5. Pierwsze polecenie

Teraz AI ma kontekst, więc polecenie może być konkretne:

Przeczytaj strukturę projektu i CLAUDE.md. Potem dodaj logowanie:
strony /logowanie i /rejestracja, a /pulpit tylko dla zalogowanych.

Porównaj z „zbuduj mi aplikację SaaS z logowaniem” w pustym katalogu. Różnica jest ogromna.

Pierwsze dziesięć minut

repozytorium i szkielet z narzędzia frameworka;
CLAUDE.md: stos, polecenia, konwencje;
.mcp.json, jeśli używasz MCP;
formatowanie kodu: Biome albo ESLint z Prettierem;
struktura katalogów;
pierwsza działająca strona albo trasa;
.gitignore z node_modules/, .env i .env.local;
pierwszy commit.

Dlaczego to działa

Jakość kodu z AI zależy od jakości kontekstu. Przygotowany projekt daje:

ścieżki, do których model pisze importy;
konwencje, których się trzyma;
istniejący kod, który naśladuje;
typy, z których korzysta.

Dziesięć minut przygotowania daje to, czego nie da sto linii polecenia: kontekst struktury.

Częste błędy

Brak formatowania. Kod z AI bywa niespójny. Ustaw formatowanie przy zapisie i przed commitem.
Brak wczesnego commita. Pierwszy commit po szkielecie pozwala git diff pokazać, co dokładnie zmieniło AI.
Nadmiar szkieletu. Nie twórz pięćdziesięciu pustych plików na zapas. Rób to, co wiesz, że potrzebne.
Zapomniany .gitignore. Sekrety z .env nigdy nie mogą trafić do repozytorium.

Gotowe przepisy dla czterech typów projektów: gotowe stosy.