go-dev-guidelines

This skill should be used when writing, refactoring, or testing Go code. It provides idiomatic Go development patterns, TDD-based workflows, project structure conventions, and testing best practices using testify/require and mockery. Activate this skill when creating new Go features, services, packages, tests, or when setting up new Go projects.

1. Zainstaluj skill w swoim środowisku Claude'a, dodając go do katalogu skills projektu Jumppad. Skill będzie dostępny jako część konfiguracji agenta.

2. Aktywuj skill przed rozpoczęciem pracy nad kodem Go — powiedz Claude'owi, że pracujesz nad nową funkcją, serwisem lub pakietem w Go. Skill automatycznie zaproponuje odpowiedni checklist (dla nowej funkcji, nowego serwisu lub refaktoryzacji).

3. Postępuj zgodnie z checklist dla nowej funkcji: najpierw zdefiniuj interfejs, następnie napisz testy w pliku *_test.go używając testify/require, wygeneruj mocki za pomocą mockery do folderu mocks/, a dopiero wtedy implementuj logikę.

4. Dla nowych serwisów lub pakietów zastosuj standardową strukturę Go (/cmd, /internal, /pkg), zainicjuj moduł poleceniem go mod init, zdefiniuj interfejsy i od razu pisz testy przed implementacją.

5. Skill przypomni Ci o uruchomieniu go vet i gofmt, dodaniu dokumentacji w formie komentarzy godoc oraz implementacji graceful shutdown dla serwisów. Zawsze obsługuj błędy jawnie.

6. Konsultuj się ze skillem przy refaktoryzacji istniejącego kodu — poproś o wskazówki, jak zastosować TDD i dependency injection, aby kod był bardziej testowalny i zgodny z idiomatycznym stylem Go.