Mój pierwszy CLI tool

Cel projektu

Zbuduj narzędzie CLI, które: (1) przyjmuje URL artykułu, (2) pobiera treść, (3) generuje podsumowanie, (4) tworzy post na social media, (5) zapisuje wynik do pliku. Cały proces kierowany przez Claude Code - Ty tylko podajesz instrukcje.

Krok 1: Scope (Plan)

Uruchom Claude Code w pustym katalogu (Claude Code wymaga planu Pro, Max, Team lub Enterprise albo klucza API - Free go nie ma):

mkdir article-summarizer && cd article-summarizer
claude

Stan na 1 października 2026: nowa sesja w terminalu startuje w trybie auto na każdym planie, także przy kluczu API. Wymaga to Claude Code 2.1.284 lub nowszej, wcześniej auto startowało tylko na Pro, Max i Team. Claude edytuje pliki i uruchamia polecenia bez pytania o każde z nich. Pierwsza sesja po instalacji lub aktualizacji może wystartować w innym trybie, więc zerknij na pasek stanu (napis „auto mode on”). Na etapie planu przełącz się klawiszem Shift+Tab na Plan Mode, żeby Claude czekał na Twoją akceptację. Do implementacji wróć do trybu auto.

Model zostaw domyślny: od 22 września 2026 to Opus 5.5 z effort medium (wymaga 2.1.280 lub nowszej).

Wpisz:

Chcę zbudować narzędzie CLI w Node.js/TypeScript.
Zanim napiszesz kod, zaplanuj:

Funkcjonalność:
- Przyjmuje URL artykułu jako argument
- Pobiera treść strony (web scraping)
- Generuje podsumowanie (300 słów)
- Tworzy post LinkedIn (150 słów) i tweet (280 znaków)
- Zapisuje wynik do pliku markdown

Zaproponuj:
1. Architekturę (pliki, moduły)
2. Zależności npm
3. Podział na fazy implementacji
Czekaj na moją akceptację.

Krok 2: Handoff (Architektura)

Po zaakceptowaniu planu:

Zainicjalizuj projekt:
- package.json z TypeScript
- tsconfig.json
- Zainstaluj zależności
- Stwórz strukturę katalogów

Krok 3: Implement (Budowanie)

Feature po feature:

Krok 1: Zaimplementuj moduł pobierania treści z URL
(web scraping). Przetestuj na jednym artykule.

Krok 2: Zaimplementuj moduł generowania podsumowania
i postów social media. Użyj szablonów.

Krok 3: Zaimplementuj zapis do pliku markdown
i CLI interface (argumenty z linii komend).

Po każdym kroku: „Commituj zmiany.” (osobnej komendy do commitów nie ma - commit to zwykły prompt). Po zadaniu przejrzyj zmiany komendą /diff, a jeśli coś poszło źle, cofnij stan komendą /rewind (albo dwa razy Esc przy pustym polu).

Krok 4: Polish (Szlif)

Przejrzyj cały projekt:
1. Czy są błędy w logice?
2. Dodaj obsługę błędów (nieprawidłowy URL, timeout)
3. Napisz README z instrukcją instalacji i użycia
4. Dodaj --help flag

Krok 5: Testuj i publikuj

# Testuj
npx ts-node src/index.ts https://example.com/article

# Zainicjalizuj repo
git init && git add . && git commit -m "Initial commit"

# Opcjonalnie: push na GitHub

Deliverable: Działające narzędzie CLI + kod na GitHubie.

Co dalej

Następny projekt: automatyzacja raportów z Claude Code i MCP.