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:

mkdir article-summarizer && cd article-summarizer
claude

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."

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.