Workflow: eksploracja, plan, kod

Tworzenie oprogramowania z Claude Code

Dani Zysman

AI Curriculum Manager @ DataCamp

Problem "skoku na głęboką wodę"

Góra lodowa: prompt nad linią wody, ukryta złożoność pod spodem

Workflow

Schemat blokowy: Init → Eksploracja → Plan → Kod

Przegląd projektu API

music-analytics-api/
  app.py           # Application entry point
  routes.py        # API endpoints
  models.py        # Artist/Album models
  analytics.py     # Statistics functions
  middleware.py    # Request logging
  config.py        # Session settings

Prosty interfejs API do analityki muzycznej z istniejącymi wzorcami, które musimy uszanować.

CLAUDE.md: pamięć projektu

CLAUDE.md:

Zapewnia Claude trwały kontekst twojego projektu
Claude czyta go automatycznie na początku każdej sesji
Nie musisz za każdym razem opisywać konfiguracji od nowa

Zacznij od /init

> /init

Music Analytics API
A Flask-based REST API for music data analytics.

Project Structure
- app.py       Flask application entry point
- routes.py    API endpoint definitions
- analytics.py Statistical analysis functions

Coding Conventions
- Use type hints for function parameters
- Include docstrings for all public functions
- Follow PEP 8 style guidelines

Tryb planowania

Przełącz klawiszem Shift+Tab albo wpisz /plan
Gdy plan zostanie wygenerowany, naciśnij Ctrl+G, aby go zobaczyć, zatwierdzić, sprawdzić lub edytować

Pomijanie planowania

> Add a /api/login endpoint that creates a session for a user

from flask import jsonify, request
from flask_login import LoginManager, login_user
from app import app

login_manager = LoginManager(app)
@app.route('/api/login', methods=['POST'])
def login():
    """Handle user login and create session."""
    data = request.get_json()
    user = User.query.filter_by(username=data['username']).first()
    if user and user.password == data['password']:
        login_user(user)
        return jsonify({'status': 'success'})
    return jsonify({'error': 'Invalid credentials'}), 401

Najpierw plan, potem kod

> /plan Add a /api/login endpoint that creates a session for a user

Plan: Add POST /api/login endpoint

Context
The music analytics API has session infrastructure in place
(flask_session, SECRET_KEY, session already imported in routes)
but no authentication.

Files to Modify
- models.py:  add User class, UserStore class, user_store singleton
- routes.py:  expand import, add login route

No changes needed to app.py, config.py, middleware.py, or analytics.py.

Rozszerzone myślenie

> think about how to add authentication to this API

Poziomy myślenia

Komenda	Poziom rozumowania
`think`	Podstawowe rozumowanie
`think more`	Rozszerzone rozumowanie
`think a lot`	Kompleksowe rozumowanie
`think longer`	Rozumowanie z wydłużonym czasem
`ultrathink`	Maksymalne rozumowanie

Zarządzanie oknem kontekstu i tokenami

excalidraw: okno kontekstu wypełnia się promptami i odpowiedziami, pokazany podział na tokeny

„Context window exceeded" → sesja jest zbyt długa, użyj /clear
Gdy kontekst się zapełnia, Claude priorytetyzuje najnowszą część rozmowy

Pełny workflow

Schemat blokowy: /init → Eksploracja → Plan → Przegląd → Kod → Test

Czas na praktykę!

Tworzenie oprogramowania z Claude Code