dagger-design-proposals

Skill do pisania propozycji projektowych dla funkcji Daggera. Pomaga w drafowaniu, recenzji i iteracji dokumentów projektowych, RFC-ów i propozycji zmian. Zawiera wytyczne struktury, przykłady GraphQL i Go, oraz best practices oparte na istniejących wzorcach w kodzie Daggera. Idealny dla zespołów chcących systematycznie dokumentować nowe funkcjonalności.

1. Zanim zaczniesz pisać propozycję, zbadaj istniejące umiejętności Daggera (takie jak dagger-codegen czy cache-expert) i przejrzyj powiązany kod w repozytorium — schemat GraphQL w core/schema/.go, komendy CLI w cmd/dagger/.go oraz typy rdzeniowe w core/*.go.

2. Strukturyzuj propozycję zgodnie z szablonem: zacznij od sekcji Problem (wymień 1–3 konkretne ograniczenia), następnie Solution (krótki opis), Core Concept (definicje typów GraphQL z docstringami) i CLI (rzeczywiste przykłady komend).

3. W sekcji Core Concept użyj notacji GraphQL do zdefiniowania typów API z wbudowanymi opisami, a następnie dodaj przykłady implementacji w Go pokazujące, jak moduły będą używać API.

4. Dołącz rzeczywiste przykłady komend i wyników w sekcji CLI — nie używaj abstrakcyjnych nazw typu Foo/Bar, lecz konkretne narzędzia z ekosystemu Daggera.

5. Utrzymuj tekst zwięzły i usuwaj zbędne sekcje — unikaj oddzielnych działów "Methods" (umieść je w docstringach GraphQL) i "Design Rationale" chyba że są kluczowe dla zrozumienia.

6. Na koniec dodaj sekcję Status z jednolinijkowym podsumowaniem i linkami do poprzedniej oraz następnej części propozycji, jeśli propozycja jest wieloczęściowa.