tutorial-engineer

Creates step-by-step tutorials and educational content from code. Transforms complex concepts into progressive learning experiences with hands-on examples. Use PROACTIVELY for onboarding guides, feature tutorials, or concept explanations.

1. Określ cel edukacyjny – czy chcesz stworzyć przewodnik onboardingowy dla nowego dewelopera, wyjaśnić złożoną funkcję, czy przygotować materiał do kursu online. Zdefiniuj, jakie koncepty chcesz nauczyć i dla kogo (początkujący, średniozaawansowani, eksperccy).

2. Przygotuj materiał źródłowy – dostarcz kod, bibliotekę lub funkcję, którą chcesz przekształcić w tutorial. Dołącz informacje o kontekście: co robi ten kod, jakie problemy rozwiązuje, jakie są wymagania wstępne.

3. Aktywuj skill i wskaż typ materiału – powiedz, czy potrzebujesz przewodnika krok po kroku, dokumentacji nauczającej (nie tylko referencyjnej), czy materiałów do warsztatu. Unikaj użycia tego skilla do tworzenia czystych dokumentów API – do tego służy inny tool.

4. Skill zastosuje praktyki pedagogiczne – będzie rozkładać treść na małe, zrozumiałe kroki, dodawać praktyczne ćwiczenia, przewidywać częste błędy i dostosowywać styl do różnych sposobów uczenia się (wizualny, tekstowy, praktyczny).

5. Zweryfikuj wynik – sprawdź, czy każdy krok jest jasny, czy ćwiczenia rzeczywiście utrwalają wiedzę, czy kolejność nauki ma sens. Jeśli potrzebujesz szczegółowych przykładów implementacji, otwórz plik resources/implementation-playbook.md z repozytorium.

6. Dostosuj i publikuj – edytuj tutorial do swoich potrzeb, dodaj własne przykłady lub kontekst branżowy, a następnie opublikuj na blogu, w dokumentacji, na platformie edukacyjnej lub wyślij zespołowi.