W projektach na Magento, Shopware czy Syliusie widzieliśmy ten sam schemat: najwięcej poprawek nie wynikało z błędów w kodzie, tylko z wymagań, które nikt nie spisał do końca. Dlatego Endora Commerce od pierwszego modułu powstaje metodą Spec-Driven Development. Narzędzia AI przyspieszają u nas pisanie testów, kodu i dokumentacji, ale kierunek, architekturę i ostateczną akceptację każdej zmiany zostawiamy inżynierom.
Czym właściwie jest Spec-Driven Development
To sposób pracy, w którym każda funkcja zaczyna się od pisanej specyfikacji. Zespół opisuje w niej aspekty biznesowe, techniczne, architektoniczne, wydajnościowe i bezpieczeństwa. Na tej podstawie powstają kolejne elementy:
- Testy: kryteria akceptacji ze specyfikacji stają się wykonywalnymi sprawdzeniami.
- Kod: implementacja powstaje względem specyfikacji i jej testów.
- Dokumentacja: opis modułu pozostaje spójny z tym, co faktycznie działa.
Specyfikacja jest umową między biznesem a zespołem. Dopiero gdy obie strony ją akceptują, zaczyna się implementacja.
Jak wygląda specyfikacja jednej funkcji?
Zwykle to kilka stron: kontekst biznesowy, historie użytkownika, kryteria akceptacji oraz uwagi o wydajności i bezpieczeństwie. Im dokładniej opiszemy przypadki brzegowe, na przykład co się dzieje, gdy dwie reguły cenowe się nakładają, tym mniej poprawek pojawia się na etapie testów.
Do porządkowania specyfikacji używamy toolkitu Spec-Kit. Pomaga rozbić specyfikację na zadania i utrzymać spójną strukturę dokumentów w całym projekcie, niezależnie od tego, kto z zespołu pracuje nad danym modułem.
Co z tego ma Twoje wdrożenie?
- Przewidywalny zakres: zanim powstanie kod, wiesz, co dokładnie zostanie zbudowane.
- Szybszy start: dobrze opisana funkcja przechodzi od specyfikacji do działającego modułu w 1-3 dni, większa w około tydzień.
- Dokumentacja od pierwszego dnia: Twój zespół i każdy kolejny partner wiedzą, co i dlaczego powstało.
Chcesz zobaczyć, jak ta metoda sprawdzi się przy Twoich procesach? Umów bezpłatną konsultację, a przejdziemy przez nią na przykładzie Twojej platformy.