Lista kontrolna migracji narzędzi

Zdecydowałeś się przyjąć nowe narzędzie do kodowania z AI — lub przejść z jednego na drugie. Ta lista kontrolna przeprowadzi Cię przez każdy krok, aby nic nie umknęło. Niezależnie od tego, czy przenosisz jednego programistę, czy cały zespół, proces jest taki sam: oceń, pilotaż, migruj, optymalizuj.

Co z tego wyniesiesz

• Plan migracji krok po kroku z polami do zaznaczenia, które możesz śledzić
• Tabele mapowania funkcji między narzędziami
• Harmonogramy wdrożenia zespołu z realistycznymi kamieniami milowymi
• Typowe pułapki i jak ich unikać

Ocena przed migracją

Przed dotknięciem jakiegokolwiek narzędzia, odpowiedz na te pytania:

• ☐ Z jakich narzędzi migrujesz? (VS Code, Copilot, ChatGPT, inne narzędzie AI)
• ☐ Do jakich narzędzi migrujesz? (Cursor, Claude Code, Codex lub kombinacja)
• ☐ Ilu programistów jest dotkniętych?
• ☐ Jaki jest twój budżet na programistę miesięcznie?
• ☐ Czy masz wymagania compliance? (SOC 2, GDPR, HIPAA)
• ☐ Jaki jest akceptowalny spadek produktywności podczas przejścia? (1 tydzień? 2 tygodnie?)
• ☐ Kim są twoi użytkownicy pilotażowi? (2-3 wczesnych adopterów)
• ☐ Jak wygląda sukces? (Zdefiniuj metryki z góry)

Ścieżki migracji

Do Cursor

Z VS Code

1. Import jednym kliknięciem: Otwórz Cursor > Ustawienia (Cmd/Ctrl+Shift+J) > General > Account > “Import” pod VS Code Import. Przenosi rozszerzenia, motywy, ustawienia i skróty klawiszowe.

2. Zweryfikuj załadowane rozszerzenia: Niektóre rozszerzenia mogą wymagać ręcznej reinstalacji. Sprawdź View > Extensions.

3. Konfiguracja specyficzna dla Cursor:

   • Utwórz katalog .cursor/rules/ z wytycznymi projektu
   • Skonfiguruj preferencje modeli AI (Settings > Models)
   • Włącz Privacy Mode jeśli wymagany (Settings > Privacy)
   • Zainstaluj podstawowe serwery MCP (Settings > Features > MCP)

4. Naucz się nowych skrótów: Cmd/Ctrl+I (Agent), Cmd/Ctrl+K (Edycja wbudowana), Tab (autouzupełnienie), @ (referencje kontekstowe)

Z IDE JetBrains

1. Zainstaluj rozszerzenie skrótów klawiszowych: Wyszukaj “IntelliJ IDEA Keybindings” w Extensions

2. Odtwórz podstawowe funkcje: Zainstaluj rozszerzenia specyficzne dla języka, skonfiguruj debuggery, ustaw narzędzia bazodanowe

3. Kluczowe różnice:

   • Nawigacja plików: Ctrl+P zamiast podwójnego Shift
   • Refaktoryzacja: Różne skróty, podobne możliwości
   • Wbudowane narzędzia: Niektóre funkcje JetBrains wymagają rozszerzeń

Z GitHub Copilot

Funkcja Copilot	Odpowiednik Cursor
Sugestie tekstu-ducha	Autouzupełnianie Tab (szybsze, wieloliniowe)
Copilot Chat	Tryb Agent (Cmd/Ctrl+I)
Generowanie sterowane komentarzem	Język naturalny w czacie
Wyjaśnij kod	Tryb pytań
Sugestie poprawek	Edycja wbudowana (Cmd/Ctrl+K)
Przeglądy PR	BugBot

Do Claude Code

Z dowolnego IDE/narzędzia

1. Zainstaluj Claude Code:

   npm install -g @anthropic-ai/claude-code
   claude --version

2. Zainicjalizuj projekt: Przejdź do katalogu głównego projektu i uruchom:

   claude
   /init    # Tworzy CLAUDE.md z kontekstem projektu

3. Napisz kompleksowy CLAUDE.md: Dołącz standardy kodowania, typowe polecenia, uwagi o architekturze i wzorce testów.

4. Skonfiguruj serwery MCP:

   claude mcp add context7 -- npx -y @upstash/context7-mcp

5. Skonfiguruj uprawnienia: Uruchom /permissions aby ustawić które operacje Claude może wykonywać bez pytania.

6. Zainstaluj rozszerzenie VS Code (opcjonalnie): Wyszukaj “Claude Code” w marketplace Extensions.

Z Cursor

Funkcja Cursor	Odpowiednik Claude Code
Tryb Agent	Domyślne zachowanie (Claude jest zawsze agentyczny)
Tryb pytań	Po prostu zadaj pytanie (Claude czyta pliki na żądanie)
Referencje @ do plików	@file.js w promptach
.cursor/rules/	CLAUDE.md + .claude/rules/
Autouzupełnianie Tab	Używaj Cursor równolegle do tego
Edycja wbudowana (Cmd/Ctrl+K)	Opisz edycję w promptcie
Punkty kontrolne	Commity Git (git stash przed dużymi zmianami)
Background Agent	claude -p "zadanie" w tle lub sufiks &

Do Codex

Z dowolnego narzędzia

1. Zainstaluj Codex CLI:

   npm install -g @openai/codex
   codex --version

2. Skonfiguruj Codex:

   # Uruchom Codex i użyj /init wewnątrz TUI aby skonfigurować
   codex

   Następnie uruchom /init wewnątrz sesji interaktywnej lub edytuj ~/.codex/config.toml bezpośrednio swoim kluczem API, preferowanym modelem i trybem zatwierdzania.

3. Utwórz AGENTS.md: Napisz konfigurację na poziomie projektu ze standardami kodowania, poleceniami testowymi i wzorcami wdrożenia.

4. Wybierz swoją powierzchnię: Codex App (web), CLI (terminal), rozszerzenie IDE lub Cloud (agenci w tle).

5. Skonfiguruj automatyzacje (opcjonalnie):

   • Połącz repozytorium GitHub
   • Skonfiguruj integrację Slack
   • Ustaw automatyzację ticketów Linear

Z Cursor / Claude Code

Poprzednia funkcja	Odpowiednik Codex
Tryb Agent / autonomiczny Claude	Tryb zatwierdzania on-failure lub flaga --full-auto
.cursor/rules/ / CLAUDE.md	AGENTS.md
Background Agent / tryb headless	Agenci Codex Cloud
Serwery MCP	Serwery MCP (ten sam protokół, ta sama konfiguracja)
Niestandardowe polecenia / slash commands	Slash commands Codex
BugBot	Automatyzacja GitHub w Codex

Strategia migracji zespołu

Faza 1: Pilotaż (Tydzień 1-2)

• ☐ Wybierz 2-3 użytkowników pilotażowych (różne poziomy umiejętności, różne typy projektów)
• ☐ Udokumentuj obecne przepływy pracy i punkty problematyczne
• ☐ Zainstaluj i skonfiguruj nowe narzędzie dla użytkowników pilotażowych
• ☐ Zapewnij codzienne kontrole i szybkie rozwiązywanie problemów
• ☐ Zbieraj opinie o użyteczności, szybkości i jakości

Faza 2: Wcześni adopterzy (Tydzień 3-4)

• ☐ Rozszerz do 25% zespołu
• ☐ Utwórz wewnętrzną dokumentację (przewodnik konfiguracji, FAQ, wskazówki)
• ☐ Zorganizuj sesję lunch-and-learn
• ☐ Opracuj konfigurację specyficzną dla projektu (reguły, CLAUDE.md, AGENTS.md)
• ☐ Skonfiguruj kanał Slack/Teams do pytań

Faza 3: Pełne wdrożenie (Tydzień 5-8)

• ☐ Migruj pozostałych członków zespołu
• ☐ Zapewnij formalne sesje szkoleniowe
• ☐ Utwórz video walkthroughs dla typowych przepływów pracy
• ☐ Ustanów cotygodniowe godziny konsultacji przez pierwszy miesiąc
• ☐ Monitoruj metryki adopcji (użycie, satysfakcja, produktywność)

Faza 4: Optymalizacja (Miesiąc 3+)

• ☐ Przejrzyj wzorce użytkowania i dostosuj poziomy subskrypcji
• ☐ Dziel się zaawansowanymi technikami i najlepszymi praktykami
• ☐ Opracuj niestandardowe polecenia i automatyzację specyficzną dla zespołu
• ☐ Zmierz ROI względem poziomu bazowego sprzed migracji
• ☐ Wycofaj licencje starych narzędzi

Migracja konfiguracji

Transfer ustawień

VS Code do Cursor

Import jednym kliknięciem w Cursor obsługuje większość ustawień. Do ręcznego transferu:

VS Code: ~/.config/Code/User/settings.json
Cursor:  ~/.config/Cursor/User/settings.json

Skopiuj ustawienia edytora, workbench, terminala i git. Dodaj ustawienia specyficzne dla Cursor po imporcie.

Cursor do Claude Code

Przetłumacz swoje .cursor/rules/ na CLAUDE.md:

CLAUDE.md

## Przegląd projektu
[Z opisu reguł Cursor]

## Standardy kodowania
[Ze wzorców reguł Cursor]

## Typowe polecenia
- Build: npm run build
- Test: npm test
- Lint: npm run lint

## Uwagi o architekturze
[Z sekcji architektury reguł Cursor]

Dowolne do Codex

Utwórz AGENTS.md z istniejącej konfiguracji:

AGENTS.md

## Projekt
[Opis projektu]

## Standardy
[Konwencje kodowania, wzorce do naśladowania]

## Polecenia
- Test: npm test
- Build: npm run build
- Deploy: npm run deploy

## Reguły
[Co zawsze robić, czego nigdy nie robić]

Typowe wyzwania

Wyzwanie 1: Pamięć mięśniowa

Problem: Sięganie po stare skróty i przepływy pracy z przyzwyczajenia.

Rozwiązanie: Wydrukuj referencję Skróty klawiszowe. Trzymaj ją widoczną przez 2 tygodnie. Używaj palety poleceń (Cmd/Ctrl+Shift+P) gdy zapomnisz skrótu.

Wyzwanie 2: Kalibracja zaufania

Problem: Brak zaufania do sugestii AI (niedostateczne zaufanie) lub ślepe akceptowanie wszystkiego (nadmierne zaufanie).

Rozwiązanie: Zacznij od zadań o niskiej stawce. Zawsze przeglądaj diffy przed akceptacją. Obficie używaj kontroli wersji. Stopniowo zwiększaj zaufanie gdy uczysz się mocnych i słabych stron narzędzia.

Wyzwanie 3: Przeciążenie kontekstem

Problem: Dostarczanie zbyt dużego lub zbyt małego kontekstu AI.

Rozwiązanie: Zacznij konkretnie — dołącz tylko pliki bezpośrednio istotne dla zadania. Jeśli wyjście AI jest nie na temat, dodawaj więcej kontekstu stopniowo. Używaj referencji @ i zakresów plików zamiast “dołącz wszystko”.

Wyzwanie 4: Tłumaczenie przepływu pracy

Problem: Próba używania nowego narzędzia dokładnie jak starego.

Rozwiązanie: Każde narzędzie ma swoje mocne strony. Nie zmuszaj Claude Code do pracy jak IDE. Nie traktuj Cursor jak CLI. Przyjmij natywny przepływ pracy narzędzia — będziesz szybszy gdy się dostosujesz.

Metryki sukcesu

Metryki indywidualne

Metryka	Jak mierzyć	Cel
Czas do funkcji	Godziny na punkt historii	-20% po 1 miesiącu
Wskaźnik błędów	Błędy na wydanie	-30% po 2 miesiącach
Czas przeglądu kodu	Godziny na PR	-40% po 1 miesiącu
Dni do biegłości	Samoocena + jakość wyjścia	Poniżej 14 dni

Metryki zespołowe

Metryka	Jak mierzyć	Cel
Wskaźnik adopcji	% zespołu aktywnie używającego codziennie	>80% po 2 miesiącach
Satysfakcja	Anonimowa ankieta (skala 1-5)	>4.0
Zmiana velocity	Porównanie velocity sprintów	+25% po 3 miesiącach
Koszt na programistę	Subskrypcje narzędzi / liczba programistów	Śledź miesięcznie

Plan wycofania

Zawsze miej strategię wyjścia:

1. Zachowaj licencje starych narzędzi przez 3 miesiące po migracji
2. Eksportuj wszystkie konfiguracje przed wprowadzaniem zmian
3. Zdefiniuj wyzwalacze wycofania — mierzalne kryteria, które skłoniłyby do powrotu
4. Ustaw punkty kontrolne ewaluacji na 30, 60 i 90 dni
5. Zachowaj obiektywność decyzji o wycofaniu — używaj metryk, nie uczuć

Finalna lista kontrolna

• ☐ Ocena przed migracją ukończona
• ☐ Budżet zatwierdzony
• ☐ Użytkownicy pilotażowi zidentyfikowani i przeszkoleni
• ☐ Wewnętrzna dokumentacja utworzona
• ☐ Pliki konfiguracyjne zmigrowane (reguły, CLAUDE.md, AGENTS.md)
• ☐ Serwery MCP zainstalowane i przetestowane
• ☐ Sesje szkoleniowe zespołu zaplanowane
• ☐ Metryki sukcesu zdefiniowane i poziom bazowy zmierzony
• ☐ Plan wycofania udokumentowany
• ☐ Data uruchomienia zakomunikowana
• ☐ Kanał wsparcia ustanowiony (Slack/Teams)
• ☐ Licencje starych narzędzi zaplanowane do anulowania (po 3-miesięcznym nakładaniu się)

Notatka

Migracja nie jest jednorazowym wydarzeniem — to proces który trwa 2-3 miesiące do pełnego ukończenia. Zainwestuj w pierwsze dwa tygodnie właściwej konfiguracji i szkoleń. Zwrot narastająco rośnie każdego dnia po tym.