CDALManual Vibecodingu
Dla entuzjastów vibecodingu, solo twórców i małych zespołów

Vibecoding bez zawału serca.
Instalacja i konfiguracja w 60 sekund.

Pisz kod z AI w Cursorze, Windsurfie, Antigravity i Claude Code tak szybko, jak potrafisz myśleć. CDAL to fizyczna poduszka powietrzna: blokuje model przed psuciem testów, halucynacjami i cichą degradacją typów.

1. Co musisz przygotować przed startem

Krótka checklista wymagań technicznych na Twojej maszynie

Środowisko

Node.js 20+ & Git

Zainstalowany Node.js w wersji LTS oraz repozytorium git.

node -v && git status
Edytor AI

Cursor / Windsurf / Antigravity / Claude

Cursor (Agent Mode), Windsurf (Cascade), Claude Code CLI lub VS Code + Cline.

Model: Claude 3.7 / 3.5 Sonnet
Zasada nr 1

Brak samowolki AI

AI nie może zmieniać testów, gdy kod nie przechodzi asercji.

exit 2 PreToolUse & Gate

2. Instalacja w Twoim repozytorium (w 60 sekund)

Jedna komenda, która generuje szkielet kontraktów i guardraile

Krok 1: Uruchom inicjalizator w głównym katalogu projektu:

npx @cdal/cli init

Krok 2: Zainstaluj biblioteki rdzenia jako zależności deweloperskie:

pnpm add -D @cdal/cli @cdal/core# lub: npm install -D @cdal/cli @cdal/core

Krok 3: Przetestuj mutacyjnie działanie bramek bezpieczeństwa:

npx cdalkit selftest✔ Every quality gate rule is verified active and firing.

3. Konfiguracja Twojego edytora AI

Wklej ten plik do repozytorium, aby model natychmiast przestrzegał zasad

Plik: .cursorrules / AGENTS.md / .windsurfrulesUTF-8 Markdown
# Reguły CDAL dla Asystenta AI (Agent Mode)

Jesteś asystentem inżynierskim działającym w pętli CDAL.
Zasady absolutne, których NIE MOŻESZ łamać:

1. ETAP RED: Gdy proszę o test, pisz wyłącznie testy w katalogu testów.
   Każdy test MUSI mieć komentarz: // @REQ: REQ-XXX
   Uruchom test i upewnij się, że zwraca błąd (FAIL).

2. ETAP GREEN: Gdy proszę o implementację, modyfikuj WYŁĄCZNIE kod w src/.
   MASZ KATEGORYCZNY ZAKAZ modyfikowania plików testowych ani usuwania asercji.
   Nie wolno Ci używać: @ts-ignore, @ts-expect-error, "as any".

3. KONTRAKTY: Niezmienniki biznesowe żyją w contracts/*.contract.mjs.
   Nigdy nie zmieniaj kontraktu, chyba że użytkownik wprost otworzy okno kontraktu.

4. WERYFIKACJA: Po zakończeniu zadania uruchom `npx cdalkit verify`.

4. Codzienny workflow Vibecodera (3 prompty)

Jak wydawać polecenia modelowi, aby mieć 100% pewności, że kod działa

Krok 1 (PLAN & RED)

“Dodaj ficzer koszyka zakupowego [REQ-CART-01]. Najpierw napisz test w tests/cart.test.ts oznaczony // @REQ: REQ-CART-01 i potwierdź, że jest czerwony.”

Krok 2 (GREEN)

“Test jest czerwony. Zaimplementuj kod w src/cart.ts, aby test przeszedł na zielono. Nie modyfikuj pliku testowego.”

Krok 3 (VERIFY)

“Uruchom `npx cdalkit verify` i potwierdź, że wszystkie kontrakty, typy i testy są spełnione.”

5. Szablon promptu startowego (Kopiuj-Wklej)

Wklej to w pierwszej wiadomości nowej sesji w Cursorze, Windsurfie lub Antigravity:

Cześć! W tym projekcie pracujemy w metodyce CDAL (Contract-Driven Agentic Loop). Nasze twarde zasady: 1. Każda zmiana zaczyna się od wymagania REQ-XXX i kontraktu w contracts/. 2. Najpierw tworzysz czerwony test z tagiem // @REQ: REQ-XXX. 3. Potem piszesz kod produkcyjny. Nigdy nie poprawiasz testów, aby ukryć błędy w kodzie. 4. Zero @ts-ignore, zero `as any`, zero wyciszania linterów. 5. Na koniec uruchamiamy `npx cdalkit verify`. Potwierdź, że rozumiesz zasady i zapytaj mnie o pierwsze wymaganie REQ-*.

Zacznij bezpieczny vibecoding już dziś

Darmowy audyt repozytorium lub natychmiastowy zakup pakietu Pro. Bez spotkań handlowych — po prostu zainstaluj i twórz z AI bez obaw o błędy.

Manual Vibecodingu — Jak zainstalować i przygotować CDAL